ZenMode

ZenMode MCP 服务

ZenMode 是一款 LinkedIn 外联软件。它的远程 MCP 服务可让 AI 助手使用通俗语言操作你的 ZenMode 账户：读取营销活动、联系人和对话，向营销活动中添加或移除人员，暂停或排除联系人，以及更改营销活动的目标人群。

它适用于 Claude、ChatGPT 和其他 MCP 客户端。

• 服务地址： https://www.zen-mode.io/api/mcp
• 传输方式： Streamable HTTP
• 登录： 在客户端中批准连接（OAuth），或使用 ZenMode API 密钥作为 Bearer 令牌
• 套餐： Practitioner 及以上。Novice 套餐不包含 MCP 服务和 REST API。
• 联系邮箱： [email protected]
• 官方 MCP 注册表： io.zen-mode/zenmode

此代码仓库仅包含文档。服务在上述地址运行，其源代码未在此处发布。

功能

共 22 个工具。所有操作均限于你登录时使用的 ZenMode 账户。

读取

工具	返回内容
get_account_summary	套餐、ZenMode 桌面应用最近是否已签到、各状态的营销活动，以及最近 30 天的结果
list_campaigns	你的营销活动，包括状态、每日限额和指定日期范围内的结果
get_campaign	单个营销活动：类型、状态、每日限额、工作时间、目标人群、各阶段的联系人数量和结果
search_contacts	按姓名、公司、职位或 LinkedIn URL 搜索你所有营销活动中的联系人
get_contact	单个联系人：个人资料详情、营销活动、状态、外联状态及免联系状态
get_conversation	与某位联系人的 LinkedIn 对话记录，按时间从早到晚排列
get_campaign_targeting	营销活动设定的目标人群
get_safety_status	ZenMode 当前对该账户的限额情况
get_setup_status	账户的设置进度和下一步操作
get_desktop_app	桌面应用的下载和安装命令
start_trial	免费 14 天试用的结账链接（仅限没有套餐的账户）

更改（每项都标记为更改，因此客户端可以请求你确认）

工具	功能
add_leads_to_campaign	按 LinkedIn 个人资料 URL 向营销活动添加最多 100 人；无效 URL、免联系名单中的人员、营销活动的排除名单中的人员以及重复人员会被拒绝，并逐人报告
remove_leads_from_campaign	从营销活动中移除最多 100 位联系人
set_contact_outreach_state	暂停联系人、将其加入免联系名单，或标记为不感兴趣
update_campaign_targeting	更改营销活动寻找的职位、地点、行业和公司

营销活动（付费套餐）

工具	功能
validate_message	在保存前，根据 ZenMode 的消息规则检查连接邀请语或后续消息；不会更改任何内容
create_campaign	创建包含名称、目标人群和每日限额的连接营销活动；创建后始终处于暂停状态
set_campaign_messages	编写营销活动的连接邀请语和最多三条后续消息；服务会再次检查每条消息
launch_campaign	通过两次调用启动已暂停的营销活动：先执行不会更改任何内容的预检查，并返回摘要和确认令牌；你确认后，再使用该令牌调用同一工具
resume_campaign	对已暂停的营销活动执行相同的预检查；不会启动营销活动
pause_campaign	暂停正在运行的营销活动
set_up_desktop_app	查看桌面应用在你账户中的状态，以及如何打开、更新或安装；不会更改任何内容

它不能做什么

没有用于发送 LinkedIn 消息或连接请求的工具。只有在你确认后，营销活动才会通过 launch_campaign 的两次调用启动。将人员添加到营销活动会把他们加入该营销活动的工作列表。之后，ZenMode 桌面应用会在列表中逐一处理，并遵守账号的每日和每周限额及营业时间；只有桌面应用运行时才会处理。

如果账号受到限制、本周已暂停、正在冷却或已关闭，那么任何会扩大可联系对象范围的更改都会被拒绝，并说明原因和限制解除时间。

设置

Claude（claude.ai）

1. 打开 Customize → Connectors，点击 +，然后选择 Add custom connector。对于 Team 或 Enterprise 套餐，所有者需在 Organization settings → Connectors → Add → Custom → Web 下添加。
2. 将其命名为 ZenMode，并粘贴 https://www.zen-mode.io/api/mcp。高级 OAuth 设置留空。
3. 点击 Connect。如果系统提示，请登录 ZenMode，选择 Read only（默认选项）或 Read and change，选择用于连接的 API 密钥，然后点击 Allow。
4. 在新聊天中，打开 + 菜单，前往 Connectors，然后开启 ZenMode。

Claude Code

claude mcp add --transport http zenmode https://www.zen-mode.io/api/mcp --header "Authorization: Bearer YOUR_ZENMODE_API_KEY"

运行 claude mcp list，检查是否已连接。

ChatGPT

在 ChatGPT 中将 ZenMode 添加为自定义 MCP 服务，在 ZenMode 页面上批准连接；除非你希望 ChatGPT 进行更改，否则请将权限范围设为只读。操作步骤详见此页面，该页面基于 Plus 账号上的实际运行记录：https://www.zen-mode.io/integrations/chatgpt。哪些 ChatGPT 套餐可以添加自定义 MCP 服务，由 OpenAI 决定。

Cursor

将 ZenMode 添加到 Cursor（一键安装；它会从 ZENMODE_API_KEY 环境变量中读取你的密钥）。或者将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "zenmode": {
      "url": "https://www.zen-mode.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ZENMODE_API_KEY}"
      }
    }
  }
}

在环境中设置 ZENMODE_API_KEY，这样密钥就不会存储在文件中。

VS Code（GitHub Copilot）

将以下内容添加到用户级 mcp.json。VS Code 会提示你输入密钥，并且不会将其保存在文件中：

{
  "servers": {
    "zenmode": {
      "type": "http",
      "url": "https://www.zen-mode.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:zenmode-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "zenmode-api-key",
      "description": "ZenMode API key",
      "password": true
    }
  ]
}

Gemini CLI

从此仓库安装扩展。它会添加服务；随后 Gemini CLI 会提示你登录 ZenMode：

gemini extensions install https://github.com/zenmode87/zenmode-mcp

或者使用 API 密钥自行添加服务：

gemini mcp add --scope user --transport http -H "Authorization: Bearer YOUR_ZENMODE_API_KEY" zenmode https://www.zen-mode.io/api/mcp
gemini mcp list

在 ZenMode 控制面板中创建 API 密钥：https://www.zen-mode.io/dashboard/api。撤销密钥会终止连接。

Grok Build

此仓库也是一个 Grok Build 插件：.grok-plugin/plugin.json 和 .mcp.json 会将 Grok Build 指向同一个服务地址。首次连接时，请登录 ZenMode。

示例提示词

• “过去 30 天我的 LinkedIn 营销活动效果如何？”使用 list_campaigns。
• “查找我一直在联系的 Acme 所有联系人，并向我展示最近的对话。”使用 search_contacts，然后使用 get_conversation。
• “将这 5 个 LinkedIn 个人资料添加到我的 Q4 创始人营销活动中，并告诉我是否有人被拒绝。”使用 add_leads_to_campaign。

限额

每个 ZenMode API 密钥（通过登录建立的连接会使用其所用密钥的配额）：

• 每分钟 60 次工具调用
• 每分钟 10 次更改，每天 300 次
• 每天添加 500 条潜在客户，每次调用最多 100 条

链接

• 所有客户端的设置指南：https://www.zen-mode.io/integrations/mcp
• Claude 指南：https://www.zen-mode.io/integrations/claude
• 定价：https://www.zen-mode.io/pricing
• 隐私政策：https://www.zen-mode.io/privacy
• 条款：https://www.zen-mode.io/terms
• 服务状态：https://www.zen-mode.io/status
• llms.txt：https://www.zen-mode.io/llms.txt

许可

此仓库中的文档采用 Creative Commons Attribution 4.0 International 许可。该许可仅涵盖这些文件中的文本。 它不涵盖 ZenMode 名称或徽标，也不授予使用 ZenMode 软件或服务的任何权利。