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、Web チャットをまとめた共有受信トレイと、あなた自身の X アカウントです。キーと接続済みアカウントはダッシュボードにあります。アカウントの追加もダッシュボードから行えます。
AI から使う #
以下のすべての操作は、MCP に対応した AI アシスタントならどれからでも、ツールとして使えます。必要なのはアドレスひとつです:
https://top-rated.team/linkedin/mcp/<your API key>
アシスタントが MCP サーバーのアドレスを求める場所に、これを貼り付けてください。インストールするものはありません。アドレスに含まれるキーはふつうの API キーで、ツールは下のカタログから作られ、アシスタントが行う呼び出しはすべて、あなた自身のリクエストと同じキーの確認、プランの確認、アカウントの所有確認を通ります。キーを失効させれば、接続は終わります。ダッシュボードで作成できます — 「AI をつなぐ」から。
アドレスにはキーが含まれているので、パスワードと同じように扱ってください。アドレスを持っている人は誰でも、それを通じてあなたのアカウントを使えます。漏れた場合は、そのキーを失効させて新しく作ってください。
クライアントごとの接続方法
以下のどのクライアントも、必要なのはあの 1 つのアドレスだけです。鍵を作ったあとにダッシュボードが示す手順そのもので、どのエージェントに向けても同じです。
サインインの手順はありません。キーはすでにそのアドレスに含まれているので、アシスタントに認証方法を聞かれたら、「なし」を意味する選択肢を選んでください — たいていは No sign in、No authentication、None のいずれかの名前です。OAuth クライアントは設定せず、リクエストヘッダーも追加しないでください。ほとんどの人がつまずくのは、まさにこの質問です。
ChatGPT
Settings を開いて Connectors を探します — これを読んでいる時期によっては Apps & Connectors や Plugins という名前かもしれません — 次に、custom コネクタまたは MCP サーバーを追加する選択肢を探します。プランによっては、同じ場所にある Developer mode の切り替えの奥にあります。アドレスをサーバー URL として貼り付け、認証なしの選択肢を選び、サードパーティのサーバーへの接続について表示される警告を承諾します。
あえて大まかに書いています: OpenAI はこの設定の場所を何度も変えており、すべてのプランで提供されているわけでもないので、ここに正確なクリック手順を書いても 1 か月もしないうちに間違いになります。まったく見つからない場合、そのアカウントでは使えません — 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 から読み取ったりし、専用のキーを持つ 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 に対応したアシスタントなら、同じアドレスひとつだけで使えます。インストールするパッケージも、編集する設定ファイルもありません。トランスポートを聞かれたら、答えは HTTP 経由のリモートサーバーで、実行するコマンドではありません。
うまくいったか確かめる。アシスタントに「接続済みの LinkedIn アカウントを一覧にして」と頼んでください。あなたのアカウントが返ってくれば、すべてつながっています。そのようなツールはないと言われたら、アドレスが途中で切れてキーまで貼り付けられていないか、コネクタは追加されているもののその会話でオンになっていません。
エンドポイントカタログ #
LinkedIn API のすべての操作を、領域ごとにまとめています。カードを開くと、パラメーター、リクエスト、レスポンスが表示されます。