Unipile

Unipile MCP サーバー：コーディングエージェント向けの LinkedIn MCP、WhatsApp MCP、Email MCP

Unipile MCP サーバーを使うと、コーディングエージェントに、LinkedIn MCP サーバー（Classic、Sales Navigator、Recruiter）、WhatsApp MCP、Instagram MCP、Telegram MCP、Gmail、Outlook、IMAP 向けのメール MCP、Google と Outlook 向けのカレンダー MCP を、1 つのホスト型サーバーで提供できます。Cursor、Claude Code、Codex、Gemini CLI、VS Code、Windsurf に接続できます。するとエージェントは、正確な Unipile API コントラクトを参照し、お使いの技術スタックで製品の LinkedIn、WhatsApp、またはメール連携を実装し、コミット前に接続済みのご自身のアカウントで各呼び出しをテストします。

https://developer.unipile.com/mcp?branch=v2.0

このサーバーの基盤は Unipile API です。LinkedIn API、WhatsApp API、Instagram API、Telegram API、メール API、カレンダー API を 1 つにまとめた REST API です。ユーザーはそれぞれ自分のアカウントを接続し、お使いの製品は 1 つのキーでそれらのアカウントを操作します。

対象ユーザー

ユーザーの LinkedIn、WhatsApp、またはメールアカウントと連携する SaaS 製品を開発するチーム：

• セールスエンゲージメント、CRM、AI SDR ツール： LinkedIn 検索、Sales Navigator のリードリスト、招待、メッセージ、InMail を、メールや WhatsApp と同期します。
• ATS および採用ソフトウェア： LinkedIn Recruiter の検索、候補者プロフィール、採用プロジェクト、InMail、求人情報、応募者に対応します。
• 統合受信トレイ、ヘルプデスク、CRM 同期： LinkedIn、WhatsApp、Instagram、Telegram、Gmail、Outlook、IMAP で、メッセージとメールのスキーマを統一します。
• スケジューリングおよび AI アシスタント： Google と Outlook のカレンダーイベント、空き状況、招待を会話と並べて表示します。

この MCP サーバーはビルド時のツールです。エージェントはエディター内でこれを使って、連携の仕様を確認し、実装し、テストします。生成されたコードは Unipile REST API、または Node.js／Python SDK を直接呼び出すため、本番環境で製品が MCP に依存することはありません。

時間を節約できる理由

LinkedIn、WhatsApp、またはメールとの連携を構築するには、通常、API ドキュメントをページごとに読み、リクエストのスキーマを手作業でコピーする必要があります。また、Sales Navigator の検索と Recruiter の検索の違いや、InMail とメッセージの違いなど、プロバイダー固有の仕様も把握しなければなりません。その後、curl を使った試行錯誤が待っています。MCP サーバーを接続すれば、エージェントがこの一連の作業を自動で行います。

You:    Add a "Connect on LinkedIn" button to our CRM contact page. It sends an
        invitation with the rep's note and shows whether it is still pending.

Agent:  search-endpoints  "relation-requests"
        get-endpoint      POST /v2/{account_id}/users/me/relation-requests
        get-endpoint      GET  /v2/{account_id}/users/me/relation-requests
        -> writes the service, the route handler and the UI state in your codebase
        execute-request   sends a real invitation from your test LinkedIn account to a test profile
        -> checks the response against the schema, then hands you the diff

• 存在しないエンドポイントを作りません。 サーバーは最新の OpenAPI 仕様から生成されるため、エージェントは実際のパス、パラメーター、レスポンス形式に基づいて作業します。これらが API と食い違うことはありません。
• LinkedIn のアカウント種別を明確に区別します。 Classic、Sales Navigator、Recruiter には、それぞれ独自の検索ルート、フィルター、InMail オプションがあります。エージェントは推測せずに、適切なものを参照します。
• コミット前にテストできます。 エージェントが実行するリクエストは、バックエンドが本番環境で行うものと同じ HTTP 呼び出しです。

クイックスタート

1. Unipile dashboardでテストアカウント（LinkedIn、WhatsApp、Gmail など）を接続し、そのアカウント用の Scope とスコープ付きアカウント API キーを作成します。API keysを参照してください。

2. 上のボタンを使ってコーディングエージェントにサーバーを追加するか、Claude Code の場合は次のようにします。

   claude mcp add --transport http unipile "https://developer.unipile.com/mcp?branch=v2.0" --header "X-API-KEY: your-scoped-api-key"
   

3. 作成したい機能を説明します。たとえば、次のようにします。

   • 「Unipile API を使って、職位レベルと従業員数のフィルターを備えた Sales Navigator のリード検索画面を作成してください。」
   • 「新着メッセージ用の Webhook を設定し、ユーザーの WhatsApp と LinkedIn の会話を受信トレイに同期してください。」
   • 「シーケンスに Gmail、Outlook、IMAP からの送信を追加し、返信を元のメールのスレッドにまとめてください。」

Cursor、VS Code、Codex、Gemini CLI、Windsurf、Claude Desktop の設定はSetupにあります。

機能別の API ルート

以下の各ルートは Unipile API v2 で、接続済みアカウントを使用して実行されます。{account_id}はGET /v2/accounts/で取得するacc_...形式の ID です。この一覧は、あなたとエージェント向けのガイドであり、スキーマではありません。リクエストボディを作成する前に、エージェントがルートに対してget-endpointを呼び出す必要があります。

LinkedIn MCP サーバー：エージェント向けの LinkedIn API

Sales Navigator MCP：LinkedIn Sales Navigator API

アカウントにはSales Navigatorのシートが必要です。ユーザーが複数のLinkedIn契約を保有している場合は、GET /v2/{account_id}/linkedin/contractsで一覧を取得し、POST .../contracts/{contract_id}/selectでいずれかを選択します。

LinkedIn Recruiter MCP：LinkedIn Recruiter API

アカウントにはRecruiterのシートが必要です。

WhatsApp MCP、Instagram MCP、Telegram MCP：LinkedIn を含む 1 つのメッセージング API

1 セットのルートで、WhatsApp のチャットとグループ、Instagram の DM、Telegram のチャットとグループ、LinkedIn のメッセージすべてに対応します。統合受信トレイも、4 つではなく 1 つの連携で実現できます。

Email MCP：Gmail、Outlook、IMAP のメール API

3 つのプロバイダーすべてで共通のスキーマを使用するため、メール連携は一度実装するだけで済みます。

Calendar MCP：Google Calendar と Outlook Calendar の API

投稿とエンゲージメント：LinkedIn と Instagram

アカウント接続、マルチテナント、Webhook

API バージョン：デフォルトは v2、v1 も引き続き利用可能

branch クエリパラメーターで、サーバーが読み込み、呼び出す Unipile API を選択します。branch=v2.0 を使用してください。この README のすべての例は v2 を対象としています。統合が引き続き v1 API で動作している場合は、branch=v1.0 に切り替え、v1 アクセストークンを X-API-KEY に設定してください。それ以外のクライアント設定は同じです。

v1 と v2 は別々の環境です。一方の環境で接続したアカウントは、もう一方からは参照できません。また、一方の環境のキーはもう一方では機能しません。アカウントが存在する環境に合ったブランチを使用してください。

v1 では、エージェントは get-server-variables ツールから DSN を読み取ります。execute-request を呼び出す前に、DSN を渡す必要があります。

API キー

キーは MCP 接続の X-API-KEY ヘッダーに設定します。API リファレンスを読む場合、キーは任意です。キーがなくても、エージェントはエンドポイントを検索し、スキーマを読み取ることができます。execute-request にはキーが必要です。

v2 には 3 種類のキーがあります。MCP クライアントには、スコープ付き Account API キーのみを渡してください。

エージェントは、管理用ルート（/v2/scopes、/v2/api-keys、/v2/webhooks）のスキーマを引き続き読み取ることができ、Service キーを使ってそれらを呼び出すバックエンドコードも作成できます。キーを共有リポジトリにコミットしないでください。

ツール

branch=v2.0 では、サーバーは 5 つのツールを公開します。

branch=v1.0 では、list-specs の代わりに get-server-variables を使用し、ツールは title を受け取りません。

セットアップ

以下の各クライアントは Streamable HTTP に対応しており、X-API-KEY ヘッダーでキーを渡します。v1 の場合は、URL 内の v2.0 を v1.0 に置き換え、キーとして v1 アクセストークンを使用してください。

{
  "mcpServers": {
    "unipile": {
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "your-scoped-api-key" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "unipile_api_key", "description": "Unipile scoped Account API key", "password": true }
  ],
  "servers": {
    "unipile": {
      "type": "http",
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "${input:unipile_api_key}" }
    }
  }
}

claude mcp add --transport http unipile "https://developer.unipile.com/mcp?branch=v2.0" --header "X-API-KEY: your-scoped-api-key"

/plugin marketplace add unipile/unipile-mcp
/plugin install unipile@unipile

[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }

{
  "mcpServers": {
    "unipile": {
      "httpUrl": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "your-scoped-api-key" }
    }
  }
}

{
  "mcpServers": {
    "unipile": {
      "type": "http",
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "your-scoped-api-key" }
    }
  }
}

その他の MCP クライアントやエージェントフレームワーク（OpenAI Agents SDK、Claude Agent SDK、LangChain、LlamaIndex、CrewAI、カスタムクライアント）も、同じ方法で接続できます。ヘッダー認証を使用した Streamable HTTP です。

エディターから本番環境へ

• SDK： Node.js/TypeScript と Python は、エージェントが MCP を通じて検出するものと同じエンドポイントをラップしています。エージェントに、作成するコードでこれらを使うよう指示してください。
• n8n： @unipile/n8n-nodes-unipile は、同じチャネルを型付きのリソースと操作として公開するコミュニティノードです。コードを書かず、エージェントも介さないワークフロー向けです。

FAQ

LinkedIn MCP サーバーはありますか？ LinkedIn は公式のものを公開していません。Unipile MCP サーバーは、Unipile LinkedIn API を基盤として構築された、コーディングエージェント向けの LinkedIn MCP サーバーです。ユーザーが接続した LinkedIn アカウントに対して、各アカウント固有の制限内で操作します。

Sales Navigator MCP や LinkedIn Recruiter MCP はありますか？ はい。同じサーバーで利用できます。Sales Navigator には、独自のリードおよびアカウント検索、リードリスト、InMail があります。Recruiter には、独自の候補者検索、採用プロジェクト、パイプライン、InMail があります。Sales Navigator MCP と LinkedIn Recruiter MCP をご覧ください。

WhatsApp MCP、Instagram MCP、Telegram MCP はありますか？ はい。WhatsApp のチャットとグループ、Instagram の DM、Telegram のチャットは、LinkedIn メッセージと同じメッセージングルートを共有しています。Instagram では、投稿とエンゲージメントから投稿、ストーリー、コメント、場所検索も利用できます。

Gmail MCP、Outlook MCP、IMAP MCP はありますか？ はい。1 つのメールスキーマで、Gmail、Outlook、あらゆる IMAP メールボックスに対応しています。検索、スレッドの閲覧、送信、返信、下書き、フォルダー、添付ファイルを利用できます。

本番環境で自社製品に MCP は必要ですか？ いいえ。開発中にエージェントが API を検出してテストするために MCP を使用します。自社製品からは、Unipile REST API または SDK を直接呼び出します。

どのコーディングエージェントで使えますか？ カスタムヘッダーを使用した Streamable HTTP 経由でリモート MCP サーバーに対応するクライアントであれば、どれでも使えます。Cursor、Claude Code、Codex、Gemini CLI、VS Code、Windsurf、Claude Desktop のほか、エージェントフレームワークにも対応しています。

v1 と v2 のどちらを使うべきですか？ アカウントが v1 環境にある場合を除き、v2 を使用してください。API バージョンをご覧ください。

注意事項

• 公式なのは github.com/unipile/* 配下のリポジトリのみです。Unipile API を利用して構築されたその他の GitHub リポジトリは、Unipile が保守していないサードパーティプロジェクトです。
• このリポジトリはホスト型サーバーの配布キットであり、レジストリマニフェスト、ディレクトリ掲載用の文面、セットアップに関するメモが含まれます。別のサーバーを起動するものではありません。冒頭に記載された URL（developer.unipile.com/docs/mcp に記載）だけが有効です。

レジストリマニフェスト

server.json は、このサーバーの MCP レジストリマニフェストです。公式レジストリへの登録申請や、これを取り込むディレクトリ（Glama、PulseMCP、mcp.so など）で使用されます。branch を URL 変数（デフォルトは v2.0、v1.0 は任意）として、X-API-KEY を必須のシークレットヘッダーとして宣言しています。