Unipile MCP Server已验证已精选

什么是 Unipile MCP Server？

Unipile MCP Server 是一个托管的、用于开发阶段的 MCP 服务器，为编码智能体提供 Unipile API 在 LinkedIn（Classic、Sales Navigator 和 Recruiter）、WhatsApp、Instagram、Telegram、Gmail、Outlook、IMAP 和日历方面的接口规范，让它们在你自己连接的账户上编写并测试集成。

它背后是 Unipile API：一个 REST API，你的用户通过它连接自己的 LinkedIn、即时通讯、邮箱和日历账户，你的产品用一个密钥代表这些账户执行操作。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 参考时密钥是可选的；没有密钥，智能体仍能搜索端点和读取 schema。但 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。
• 不会臆造端点：工具读取的是实时 OpenAPI 规范。
• 区分 LinkedIn 账户类型：Classic、Sales Navigator 和 Recruiter 各有自己的搜索路由、筛选条件和 InMail 选项。
• 提交前先测试请求：execute-request 会在你自己的测试账户上发送与后端生产环境完全相同的 HTTP 调用。
• LinkedIn、WhatsApp、Instagram 和 Telegram 共用一套消息 schema，Gmail、Outlook 和 IMAP 共用一套邮件 schema。
• 默认使用 API v2，仍可使用 v1。

Unipile MCP Server 工具

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

• 发现： search-endpoints 搜索路径、操作和参数（例如 sales-navigator、inmail 或 relation-requests）；list-endpoints 列出所有路径和方法；list-specs 列出可用的 OpenAPI 规范。
• 详情： get-endpoint 返回单个操作的完整请求和响应 schema、安全设置和服务器信息。
• 执行： execute-request 以 HAR 对象的形式，在你自己的账户上真实执行请求。

在 branch=v1.0 上，get-server-variables 取代 list-specs。

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 席位。如果用户拥有多个合同，请先列出并选择其中一个。
• 路由与你的账户不匹配： 你可能处于 v1 环境。把 URL 改为 branch=v1.0，并使用你的 v1 访问令牌。