Unipile

Unipile MCP 服务：面向编码 Agent 的 LinkedIn MCP、WhatsApp MCP 和 Email MCP

Unipile MCP 服务为你的编码 Agent 提供一个托管服务，其中包含 LinkedIn MCP 服务（Classic、Sales Navigator 和 Recruiter）、WhatsApp MCP、Instagram MCP、Telegram MCP、适用于 Gmail、Outlook 和 IMAP 的 Email MCP，以及适用于 Google 和 Outlook 的 日历 MCP。将它接入 Cursor、Claude Code、Codex、Gemini CLI、VS Code 或 Windsurf。之后，你的 Agent 会读取准确的 Unipile API 契约，在你的技术栈中编写产品的 LinkedIn、WhatsApp 或 Email 集成，并在提交前使用你自己的已连接账户测试每次调用。

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

该服务基于 Unipile API：一个用于 LinkedIn API、WhatsApp API、Instagram API、Telegram API、Email API 和日历 API 的 REST API。用户连接自己的账户，你的产品只需使用一个密钥即可操作这些账户。

适用对象

需要与用户的 LinkedIn、WhatsApp 或 Email 账户通信的 SaaS 产品开发团队：

• 销售互动、CRM 和 AI SDR 工具： LinkedIn 搜索和 Sales Navigator 潜在客户列表、邀请、消息和 InMail，并与 Email 和 WhatsApp 同步。
• ATS 和招聘软件： LinkedIn Recruiter 搜索、候选人档案、招聘项目、InMail、职位发布和申请人。
• 统一收件箱、服务台和 CRM 同步： 通过统一的消息和 Email 架构支持 LinkedIn、WhatsApp、Instagram、Telegram、Gmail、Outlook 和 IMAP。
• 日程安排和 AI 助手： 在对话旁管理 Google 和 Outlook 日历活动、空闲时间和邀请。

MCP 服务是一款构建时工具。你的 Agent 在编辑器中使用它来发现、编写和测试集成。它编写的代码会直接调用 Unipile REST API，或使用 Node.js 或 Python SDK，因此你的产品在生产环境中不依赖 MCP。

它如何节省时间

构建 LinkedIn、WhatsApp 或 Email 集成通常意味着要逐页阅读 API 文档，并手动复制请求架构。你还必须了解各提供方的特有规则，例如 Sales Navigator 搜索与 Recruiter 搜索有何不同，或 InMail 与消息有何区别。接下来还要通过 curl 反复试错。接入 MCP 服务后，你的 Agent 会自行完成这一流程：

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 规范生成，因此 Agent 使用真实的路径、参数和响应结构，不会偏离 API。
• 区分不同类型的 LinkedIn 账户。 Classic、Sales Navigator 和 Recruiter 各自有独立的搜索路由、筛选条件和 InMail 选项。Agent 会读取正确的选项，而不是猜测。
• 提交前经过测试。 Agent 执行的请求与后端在生产环境中发出的 HTTP 调用相同。

快速入门

1. 在 Unipile dashboard 中连接一个测试账户（LinkedIn、WhatsApp、Gmail 等），然后为其创建一个 Scope 和一个 scoped Account API key。请参阅 API keys。

2. 使用上方的按钮将服务添加到你的编码 Agent，或在 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 潜在客户搜索界面。”
   • “将用户的 WhatsApp 和 LinkedIn 对话同步到我们的收件箱，并通过 webhook 接收新消息通知。”
   • “为我们的序列添加 Gmail、Outlook 和 IMAP 邮件发送功能，并将回复归入原始邮件的会话中。”

Cursor、VS Code、Codex、Gemini CLI、Windsurf 和 Claude Desktop 的配置见 设置。

按路由查看你可以构建的功能

以下每个路由都是 Unipile API v2，并代表已连接账户执行：{account_id} 是其 acc_... ID，可通过 GET /v2/accounts/ 获取。此列表是供你和 Agent 参考的路由索引，而非架构定义：Agent 应先对路由调用 get-endpoint，再编写请求正文。

LinkedIn MCP 服务：供你的 Agent 使用的 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 统一消息 API

一套路由适用于所有消息服务提供商：WhatsApp 聊天和群组、Instagram 私信、Telegram 聊天和群组，以及 LinkedIn 消息。统一收件箱只需一次集成，而非四次。

Email MCP：Gmail、Outlook 和 IMAP 电子邮件 API

三个服务提供商使用统一架构，因此只需编写一次电子邮件集成。

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 中，Agent 会通过 get-server-variables 工具读取你的 DSN；调用 execute-request 前必须先提供该 DSN。

API 密钥

密钥应放在 MCP 连接的 X-API-KEY 标头中。读取 API 参考时密钥可选：不提供密钥，Agent 仍可搜索端点并读取其架构。调用 execute-request 时则必须提供密钥。

v2 有三种密钥。只能向 MCP 客户端提供作用域限定的 Account API 密钥：

Agent 仍可读取管理路由（/v2/scopes、/v2/api-keys、/v2/webhooks）的架构，并编写后端代码，以便使用你的 Service key 调用这些路由。切勿将密钥提交到共享仓库。

工具

在 branch=v2.0 上，服务器会提供五种工具：

在 branch=v1.0 上，get-server-variables 会取代 list-specs，且工具不接受 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 客户端或 Agent 框架（OpenAI Agents SDK、Claude Agent SDK、LangChain、LlamaIndex、CrewAI、自定义客户端）都以相同方式连接：使用带请求头身份验证的 Streamable HTTP。

从编辑器到生产环境

• SDK：Node.js/TypeScript 和 Python 封装了 Agent 通过 MCP 发现的相同端点。你可以让 Agent 在编写的代码中使用这些 SDK。
• n8n：@unipile/n8n-nodes-unipile 是一个社区节点，将相同的渠道作为类型化资源和操作提供，适用于无需编写代码、也无需 Agent 参与的工作流。

常见问题

有 LinkedIn MCP 服务吗？ LinkedIn 没有发布官方服务。Unipile MCP 服务是面向编码 Agent 的 LinkedIn MCP 服务，基于 Unipile LinkedIn API 构建。它会在每个账户自身的限制范围内，对用户连接的 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 私信以及 Telegram 聊天，与 LinkedIn 消息共用相同的消息路由。Instagram 还支持帖子、快拍、评论和地点搜索，详见帖子与互动。

有 Gmail MCP、Outlook MCP 或 IMAP MCP 吗？ 有。一套电子邮件架构涵盖 Gmail、Outlook 和任何 IMAP 邮箱：搜索、阅读邮件会话、发送、回复、草稿、文件夹和附件。

我的产品在生产环境中需要 MCP 吗？ 不需要。构建产品时，Agent 会使用 MCP 来发现和测试 API。你的产品会直接调用 Unipile REST API 或 SDK。

它适用于哪些编码 Agent？ 任何支持通过 Streamable HTTP 和自定义请求头连接远程 MCP 服务的客户端：Cursor、Claude Code、Codex、Gemini CLI、VS Code、Windsurf 和 Claude Desktop，以及各类 Agent 框架。

我应该使用 v1 还是 v2？ 除非你的账户位于 v1 环境，否则请使用 v2。请参阅 API 版本。

说明

• 只有 github.com/unipile/* 下的仓库才是官方仓库。其他基于 Unipile API 构建的 GitHub 仓库均为第三方项目，Unipile 不会维护这些项目。
• 此仓库是托管服务的分发套件：注册表清单、目录介绍文案和设置说明。它不会运行第二个服务。顶部的 URL（详见 developer.unipile.com/docs/mcp）是唯一的 URL。

注册表清单

server.json 是此服务的 MCP 注册表清单，用于提交到官方注册表，以及供会导入该清单的目录使用（Glama、PulseMCP、mcp.so……）。它将 branch 声明为 URL 变量（默认值为 v2.0，也可选用 v1.0），并将 X-API-KEY 声明为必需的机密请求头。