LinkedIn API 레퍼런스
LinkedIn API는 LinkedIn 전체를 키 하나로 쓸 수 있습니다 — Classic, Recruiter, Sales Navigator, 페이지, 채용 공고, 메시지, 그리고 Magic Route까지. 아래의 모든 작업은 /linkedin DSN에서 지금 바로 동작합니다.
한눈에 보기 #
이 레퍼런스는 LinkedIn을 다루며, Top-Rated Team API의 한 부분입니다. 같은 키로 메시징 채널 API도 이용할 수 있습니다. WhatsApp, Telegram, 이메일, SMS, LINE, TikTok, Instagram, Facebook Messenger, 웹사이트 채팅을 하나로 모은 공유 받은편지함과 내 X 계정입니다. 키와 연결된 계정은 대시보드에 있으며, 계정 추가도 대시보드에서 합니다.
AI에서 사용하기 #
아래의 모든 작업은 MCP를 지원하는 어떤 AI 어시스턴트에서도 도구로 쓸 수 있습니다. 주소 하나면 됩니다:
https://top-rated.team/linkedin/mcp/<your API key>어시스턴트가 MCP 서버 주소를 묻는 곳에 이 주소를 붙여 넣으세요. 설치할 것은 없습니다. 주소 안의 키는 평범한 API 키이고, 도구는 아래 카탈로그에서 만들어지며, 어시스턴트가 하는 모든 호출은 직접 보내는 요청과 똑같이 키 확인, 요금제 확인, 계정 소유 확인을 거칩니다. 키를 폐기하면 연결이 끝납니다. 대시보드에서 만드세요 — 「내 AI 연결하기」에서.
주소에 키가 들어 있으므로 비밀번호처럼 다루세요. 주소를 가진 사람은 누구나 그것으로 당신의 계정을 쓸 수 있습니다. 유출되면 그 키를 폐기하고 새로 만드세요.
클라이언트별 연결 방법
아래 클라이언트는 모두 그 주소 하나만 쓰면 됩니다. 키를 만든 뒤 대시보드가 알려 주는 단계와 같고, 어떤 에이전트를 고르든 똑같습니다.
로그인 단계는 없습니다. 키가 이미 그 주소 안에 들어 있으므로, 어시스턴트가 인증 방법을 물으면 「없음」에 해당하는 옵션을 고르세요 — 보통 이름은 No sign in, No authentication, 또는 None 중 하나입니다. OAuth 클라이언트를 설정하지 말고, 요청 헤더도 추가하지 마세요. 거의 모든 사람이 막히는 곳이 바로 이 질문입니다.
ChatGPT
Settings 메뉴를 열고 Connectors 항목을 찾으세요 — 이 글을 읽는 시점에 따라 이름이 Apps & Connectors 또는 Plugins일 수도 있습니다 — 그런 다음 custom 커넥터나 MCP 서버를 추가하는 옵션을 찾으세요. 일부 플랜에서는 같은 영역의 Developer mode 토글 뒤에 있습니다. 주소를 서버 URL 칸에 붙여 넣고, 인증 없음 옵션을 고르고, 서드파티 서버 연결에 관해 표시되는 경고를 수락하세요.
일부러 느슨하게 썼습니다: OpenAI는 이 설정을 여러 번 옮겼고 모든 플랜에서 제공하지도 않으므로, 여기에 정확한 클릭 경로를 적으면 한 달 안에 틀리게 됩니다. 아예 찾을 수 없다면 그 계정에는 없는 기능입니다 — Claude를 쓰거나 내 코드에서 API를 호출하세요. 현재 공식 페이지는 help.openai.com에 있습니다.
Claude
- Settings → Customize → Connectors 메뉴를 여세요.
- + Add 버튼을 클릭한 다음 Add custom connector 항목을 클릭하세요.
- 알아볼 수 있는 이름을 붙이고 — Top-Rated Team면 충분합니다 — 위의 주소를 remote MCP server URL 칸에 붙여 넣은 다음 Continue 버튼을 누르세요.
- 인증 단계에서 No sign in 옵션을 고르고, Request headers 칸은 비워 두세요. Add 버튼을 누르세요.
- 대화로 돌아가 왼쪽 아래의 + 버튼을 누르고, Connectors 항목을 고른 뒤 켜세요.
Team 또는 Enterprise 플랜에서는 소유자가 Organization settings → Connectors 메뉴에서 한 번 추가하고, 나머지 모두는 각자의 Connectors 목록에서 켭니다. Anthropic의 공식 안내는 support.claude.com에 있으며, 이 페이지와 그 페이지의 내용이 다르면 그쪽을 믿으세요.
Cursor
Cursor의 설정을 열고 MCP 항목을 찾으세요 — 버전에 따라 Tools 아래, Integrations 아래, 또는 Features 아래에 있었습니다. 서버를 추가하고 이름을 붙인 다음, 주소를 그 url 칸에 붙여 넣으세요. 헤더와 인증은 비워 두세요. Cursor는 이를 ~/.cursor/mcp.json 파일에 보관하며, 대신 그 파일에 직접 작성할 수도 있습니다. 유일한 필드가 url인 mcpServers 항목입니다.
프로젝트 자체의 .cursor/mcp.json 파일에 넣은 서버는 에이전트가 사용하기 전에 같은 설정 화면에서 한 번 켜 주어야 합니다. 홈 폴더의 파일에 넣은 서버는 어디에서나 켜져 있습니다.
VS Code
VS Code는 GitHub Copilot의 에이전트 모드를 통해 MCP 서버에 연결하므로 Copilot을 먼저 켜야 합니다. 아래 버튼이 주소를 VS Code에 넘기고, VS Code는 추가하기 전에 한 번 묻습니다. 직접 하려면 명령 팔레트에서 MCP: Add Server, 그다음 HTTP, 그다음 주소입니다.
이 버튼은 VS Code Stable을 엽니다. Insiders는 같은 주소를 vscode-insiders: 아래에서 받고, 명령 팔레트 경로는 둘 다에서 작동합니다 — 터미널의 code --add-mcp도 마찬가지입니다.
Grok
grok.com/connectors 페이지를 열고 New connector 버튼을 누른 다음 Custom 옵션을 선택하세요. 주소를 MCP 서버 URL 칸에 붙여 넣고 인증 없음 옵션을 고르세요. Business 또는 Enterprise 계정에서는 먼저 관리자가 조직용 커넥터를 추가하고, 그다음 각 사용자가 자기 계정에서 켭니다.
이것은 xAI의 어시스턴트가 MCP를 통해 당신의 계정을 읽는 것입니다. X에 직접 글을 올리고 읽으며 자체 키가 따로 있는 X API와는 다른 것입니다 — 그쪽이 목적이라면 대신 X 채널을 연결하세요.
Gemini
gemini.google.com/apps를 열고 — Connected apps 페이지입니다 — Add a custom app을 선택하세요. 위의 주소를 MCP server URL 칸에 붙여 넣고 Next를 누른 뒤 허용하세요. 웹 앱에서 추가하면 Gemini 모바일 앱에서도 바로 쓸 수 있습니다.
Google은 커스텀 앱을 어떤 계정에는 제공하고 어떤 계정에는 제공하지 않습니다 — 이 글을 쓰는 시점에는 개인 계정, 영어, 그리고 휴대폰이 아닌 웹 앱이 조건입니다 — 그래서 해당 페이지에 Add a custom app이 없다면 당신의 계정에서는 아직 쓸 수 없는 것입니다. Google의 공식 안내 페이지는 support.google.com이며, 이 페이지와 그쪽 내용이 서로 다르면 그쪽을 믿으세요. Gemini는 무언가를 쓰거나 바꾸는 작업이면 무엇이든 확인을 요청합니다.
Claude Code
터미널에서 claude mcp add --transport http top-rated 명령을 실행하고, 그 뒤에 위의 주소를 따옴표로 묶어 붙이세요. 이 프로젝트에서만이 아니라 모든 프로젝트에서 쓰려면 -s user 옵션을 덧붙이세요. 그러면 Claude Code를 어디에서 실행하든 — 터미널, 데스크톱 앱, 연동되는 편집기 — 연결되어 있고, /mcp 명령으로 할 수 있는 일을 볼 수 있습니다. 로그인할 것은 없습니다. 키가 이미 주소 안에 들어 있습니다.
Codex
터미널에서 codex mcp add top-rated --url 명령을 실행하고, 그 뒤에 위의 주소를 따옴표로 묶어 붙이세요. 직접 설정하려면 ~/.codex/config.toml 파일에 [mcp_servers.top-rated] 블록을 만들고 그 안에 url 줄을 넣으면 됩니다. 같은 블록에 command 줄을 함께 넣지 마세요. Codex는 두 방식으로 동시에 기술된 서버를 거부합니다.
이전 버전의 Codex는 그 파일 맨 위에 experimental_use_rmcp_client = true 줄이 있어야만 url 줄을 읽었습니다. 먼저 Codex를 업데이트하고, 그래도 주소가 무시될 때만 그 줄을 추가하세요.
그 밖의 어시스턴트
HTTP로 MCP를 지원하는 어시스턴트라면 같은 주소 하나만 받으면 됩니다. 설치할 패키지도, 고칠 설정 파일도 없습니다. 전송 방식(transport)을 묻는다면, 답은 HTTP를 통한 원격 서버이며 실행할 명령이 아닙니다.
잘 됐는지 확인하기. 어시스턴트에게 「내 연결된 LinkedIn 계정 목록을 보여 줘」라고 말해 보세요. 계정 목록으로 답하면 모든 연결이 끝난 것입니다. 그런 도구가 없다고 하면, 주소가 키까지 다 붙여 넣어지지 않았거나, 커넥터는 추가됐지만 그 대화에서 켜져 있지 않은 것입니다.
엔드포인트 카탈로그 #
LinkedIn API의 모든 작업을 영역별로 묶었습니다. 카드를 열면 파라미터, 요청, 응답을 볼 수 있습니다.