Unipile MCP Server認証済み注目

Unipile MCP Server とは？

Unipile MCP Server は、開発時に使うホスト型の MCP サーバーです。LinkedIn（Classic、Sales Navigator、Recruiter）、WhatsApp、Instagram、Telegram、Gmail、Outlook、IMAP、カレンダー向けの Unipile API の仕様をコーディングエージェントに提供し、あなた自身が接続したアカウントで連携を実装・テストできるようにします。

背後にあるのは Unipile API です。ユーザーが自分の LinkedIn、メッセージング、メール、カレンダーのアカウントを接続し、あなたのプロダクトが 1 つのキーでそれらのアカウントを操作できる REST API です。MCP サーバーは最新の OpenAPI 仕様から生成されるため、エージェントは実在するパス、パラメータ、レスポンス形式に基づいて作業します。使うのは開発中だけで、エージェントが書いたコードは Unipile の REST API か Node.js／Python SDK を直接呼び出すため、本番環境のプロダクトは MCP に依存しません。公式なのは github.com/unipile/* 配下のリポジトリだけです。

Unipile MCP Server の使い方

1. Unipile のダッシュボードでテスト用アカウント（LinkedIn、WhatsApp、Gmail など）を接続し、Scope を作成してから、スコープ付きの Account API キーを作成します。
2. サーバー https://developer.unipile.com/mcp?branch=v2.0 をコーディングエージェントに追加し、キーを X-API-KEY ヘッダーに設定します。

API リファレンスを読むだけならキーは任意で、キーがなくてもエンドポイントの検索やスキーマの参照はできます。execute-request にはキーが必要です。使うのはスコープ付きの Account API キーだけにしてください。グローバルの Account API キーはアプリケーション内のすべてのアカウントに届き、Service API キーはバックエンドで保管するものです。キーを共有リポジトリにコミットしないでください。

Claude Code

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

または、UNIPILE_API_KEY 環境変数にキーを入れてプラグインをインストールします。

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

Claude Desktop

claude_desktop_config.json に追加します。

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

Cursor

~/.cursor/mcp.json または .cursor/mcp.json に追加します。

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

VS Code

.vscode/mcp.json に追加します。この方法ではキーを保存せず、入力を求めます。

{
  "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}" }
    }
  }
}

Codex

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

README には Gemini CLI と Windsurf の設定もあります。API v1 を使う場合は、URL の v2.0 を v1.0 に置き換え、v1 のアクセストークンをキーとして使います。

Unipile MCP Server の主な機能

• LinkedIn、Sales Navigator、Recruiter、WhatsApp、Instagram、Telegram、Gmail、Outlook、IMAP、Google Calendar、Outlook Calendar を 1 つのサーバーで。
• 架空のエンドポイントは生まれません。ツールは最新の OpenAPI 仕様を読みます。
• LinkedIn のアカウント種別を区別：Classic、Sales Navigator、Recruiter はそれぞれ専用の検索ルート、フィルター、InMail のオプションを持ちます。
• コミット前にリクエストをテスト：execute-request は、バックエンドが本番で送るのと同じ HTTP 呼び出しを、あなたのテスト用アカウントに対して送信します。
• LinkedIn、WhatsApp、Instagram、Telegram で共通のメッセージスキーマ、Gmail、Outlook、IMAP で共通のメールスキーマ。
• 既定は API v2 で、v1 も引き続き利用可能。

Unipile MCP Server のツール

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

• 探索： search-endpoints はパス、オペレーション、パラメータを検索します（例：sales-navigator、inmail、relation-requests）。list-endpoints はすべてのパスとメソッドを一覧にし、list-specs は利用可能な OpenAPI 仕様を一覧にします。
• 詳細： get-endpoint は 1 つのオペレーションのリクエスト／レスポンスの完全なスキーマ、セキュリティ、サーバー情報を返します。
• 実行： execute-request は HAR オブジェクトとしてリクエストを、あなた自身のアカウントに対して実際に実行します。

branch=v1.0 では、list-specs の代わりに get-server-variables を使います。

Unipile MCP Server のユースケース

• 営業ツール：「Unipile API を使って、役職と従業員数で絞り込める Sales Navigator のリード検索画面を作って。」
• 統合受信箱：「ユーザーの WhatsApp と LinkedIn の会話を受信箱に同期して、新着メッセージ用の webhook も用意して。」
• メールシーケンス：「シーケンスに Gmail、Outlook、IMAP での送信を追加し、返信を元のメールのスレッドにまとめて。」
• CRM の操作：「連絡先ページに『LinkedIn でつながる』ボタンを追加して、担当者のメモ付きで招待を送り、保留中かどうかを表示して。」
• 採用ソフト：「スキルで Recruiter の候補者を検索して、採用プロジェクトに保存して。」

Unipile MCP Server のトラブルシューティング

• 検索はできるのに execute-request が失敗する： リファレンスの参照にキーは不要ですが、実行には必要です。X-API-KEY ヘッダーにスコープ付きの Account API キーを追加してください。
• Sales Navigator や Recruiter のルートが失敗する： 接続した LinkedIn アカウントに Sales Navigator または Recruiter のシートが必要です。複数の契約を持つユーザーの場合は、先に契約を一覧にして 1 つ選択してください。
• ルートがアカウントと合わない： v1 環境にいる可能性があります。URL を branch=v1.0 に変え、v1 のアクセストークンを使ってください。