Kit.com MCP Server

@dancumberland/kit-mcp

最全面的 Kit.com MCP 服务（原名 ConvertKit）。提供 13 个针对 Agent 优化的工具，覆盖 100% 的 Kit V4 API，包括互动分析、批量操作，以及其他 Kit MCP 都不支持的广播邮件点击跟踪。

有何不同

其他 Kit MCP 服务会将每个 API 端点封装为独立工具（29 个以上）。这种方式在实际使用中并不理想：

	@dancumberland/kit-mcp	其他 Kit MCP
工具数量	13 个组合工具（45 项操作）	29 个以上独立工具
互动分析	单个订阅者的打开率／点击率、对比多达 100 位订阅者的批次数据、基于互动情况筛选	无
广播邮件分析	单个广播邮件统计、跨广播邮件对比、单个链接的点击跟踪	仅支持基本的列表／获取操作
批量操作	批量创建订阅者、标签、表单订阅（每次调用最多 10,000 条）	无
响应格式	格式化文本摘要（适合 Agent 使用）	原始 JSON（Agent 必须自行解析）
速率限制	滑动窗口，支持自动重试和指数退避	无
错误恢复	类型化错误，并提供可执行的恢复提示	通用错误
兼容 Cursor	13 个工具（远低于 40 个工具的上限）	29 个以上工具（有超出上限的风险）
令牌开销	所有工具定义约 3,200 个令牌	8,000 个以上令牌

互动分析（独家功能）

这是唯一能回答“哪些订阅者的互动最频繁？”的 Kit MCP：

> Find my most engaged 100 subscribers who've been on my list over 6 months

Subscriber Comparison (100 of 100 loaded, sorted by open rate):

  1. Alice <[email protected]> — Open: 82.3% | Click: 24.1% | Sent: 95 | Last open: 2026-03-15 (ID: 456)
  2. Bob <[email protected]> — Open: 71.0% | Click: 18.5% | Sent: 102 | Last open: 2026-03-14 (ID: 789)
  ...

其他 Kit MCP 可以列出订阅者并获取基本资料，但无法获取互动统计数据、比较不同订阅者的数据，也无法按互动指标筛选。

功能介绍

将任意 MCP 客户端（Claude Desktop、Claude Code、Cursor、Windsurf 等）连接到你的 Kit.com 邮件营销账户。直接用自然语言提问：

• “我有多少位订阅者？我的订阅列表增长情况如何？”
• “显示我上周的广播邮件统计数据。”
• “找出过去 6 个月互动最频繁的订阅者。”
• “为所有通过我的落地页注册的人添加标签。”
• “为我的新闻简报创建一封广播邮件草稿。”
• “我上一封广播邮件中，哪些链接的点击量最高？”

无需编写代码——只需完成设置，然后开始对话。

前置条件

1. Node.js 22+ — 从 nodejs.org 下载。使用 node --version 检查。
2. Kit.com 账户 — 免费或付费均可，任何套餐都适用。
3. Kit API 密钥 — kit.com → Account Settings → Developer。密钥以 kit_ 开头。

设置：Claude Desktop 应用（推荐）

步骤 1：找到配置文件

Mac：

open ~/Library/Application\ Support/Claude/

使用任意文本编辑器打开 claude_desktop_config.json。

Windows：

%APPDATA%\Claude\claude_desktop_config.json

步骤 2：添加 Kit MCP 服务

如果文件为空或不存在，请粘贴以下内容（将 your-kit-api-key 替换为你的实际密钥）：

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

如果你已经配置了其他 MCP 服务，请在现有的 "mcpServers" 块中添加 "kit"，并在前一个条目后加上逗号。

步骤 3：重启 Claude Desktop

完全退出（而非仅关闭窗口）后重新打开。

步骤 4：验证是否可用

测试我的 Kit 连接

Claude 应返回你的账户名称、身份验证方式和速率限制。

设置：使用 Cowork 的 Claude Desktop

Cowork 是 Claude Desktop 的后台 Agent。完成上述设置后，Cowork 会自动获得 Kit 工具的访问权限。

任务示例：

• “每天早上 8 点，总结过去 24 小时的订阅者增长情况和邮件表现。”
• “每周一早上 9 点，对比过去一周的广播邮件统计数据——打开率、点击率和退订数。”
• “每周五，列出订阅者少于 10 人的所有标签（可考虑清理）。”

设置：Claude Code（CLI）

添加到 .claude/settings.local.json 或 ~/.claude/settings.json：

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

设置：Cursor

1. 打开“设置”（Cmd+,）
2. 搜索“MCP”
3. 点击“添加 MCP 服务”
4. 添加：

{
  "kit": {
    "command": "npx",
    "args": ["-y", "@dancumberland/kit-mcp@latest"],
    "env": {
      "KIT_API_KEY": "your-kit-api-key"
    }
  }
}

工具

工具	操作	可执行的操作
manage_subscribers	10	查找、列出、创建、更新、取消订阅、查看统计数据、比较最多 100 位订阅者的互动情况、一次调用即可查找互动度最高的订阅者、按状态／标签筛选、按互动指标筛选
manage_tags	6	列出、创建、更新、为订阅者添加／移除标签、列出已添加标签的订阅者
manage_broadcasts	8	列出、获取、创建草稿、更新、删除、查看统计数据、比较不同广播的统计数据、分析每个链接的点击数据
manage_forms	3	列出表单、列出订阅者、添加订阅者
manage_sequences	3	列出序列、添加订阅者、列出订阅者
manage_custom_fields	4	列出、创建、更新、删除
manage_purchases	3	列出、获取、创建（需要 OAuth）
manage_segments	1	列出细分群体
manage_webhooks	3	列出、创建、删除
manage_email_templates	1	列出模板
get_account	—	全面的账户概览，包含邮件和增长统计数据
test_connection	—	验证 API 密钥是否有效
bulk_operations	7	批量执行订阅者／标签／表单／字段操作（需要 OAuth）

你可以询问的内容

你说的话	执行结果
“我的邮件列表情况如何？”	账户统计数据、订阅者数量、增长趋势
“查找 [email protected]”	订阅者资料，包含标签、自定义字段和互动统计数据
“哪些订阅者的互动度最高？”	按互动情况筛选，并根据打开率／点击率排序的列表
“显示我最近的广播”	显示广播及其状态（草稿／已安排／已发送）
“我最近一次广播的效果如何？”	打开率、点击率、取消订阅数、每个链接的点击数据
“哪些链接获得的点击最多？”	任意广播中每个链接的点击分析
“比较我的广播效果”	并排比较所有广播的统计数据
“创建一个名为 vip-customers 的标签”	在 Kit 中创建该标签
“给 [email protected] 添加 vip-customers 标签”	添加该标签
“起草一条主题为‘重大消息’的广播”	创建草稿（不会发送）

身份验证

API 密钥（涵盖大多数功能）：在 kit.com → Developer 获取。设置为 KIT_API_KEY。

OAuth 令牌（可选，用于购买和批量操作）：除 API 密钥外，还需设置 KIT_OAUTH_TOKEN。

{
  "env": {
    "KIT_API_KEY": "your-api-key",
    "KIT_OAUTH_TOKEN": "your-oauth-token"
  }
}

自动执行速率限制：每分钟 120 次请求（API 密钥）或每分钟 600 次请求（OAuth），遇到 429 错误时会重试并采用退避策略。

架构：为何使用 13 个工具，而不是 29 个以上

大多数 MCP 服务都会为每个 API 端点创建一个工具。对于 Kit 的 API，这意味着要创建 29 个以上的工具，会带来一些实际问题：

• 上下文膨胀 — 仅工具定义就占用 8,000 个以上 Token，留给实际对话的空间更少
• 准确性较差 — 工具数量超过 20 个后，AI 选择工具的准确性会明显下降（研究）
• 兼容性 — Cursor 对所有服务的工具总数设有 40 个的硬性限制；单个服务使用 29 个工具，几乎不给其他服务留空间

此服务使用 13 个复合工具，并采用经过区分的 action 参数。API 覆盖范围相同，Token 减少 60%，准确性更高。每个工具会归组相关操作（例如，将所有订阅者操作归入 manage_subscribers），因此 AI 首次就能选对工具。

错误处理

错误中包含 Claude 可以据此采取行动的恢复提示：

Error 401: Invalid API key
Recovery: Check your KIT_API_KEY. Find your key at kit.com → Account Settings → Developer.

• 429（速率限制）：自动采用指数退避策略重试，最多 3 次
• 5xx（服务端错误）：自动重试一次
• 422（验证错误）：不重试 — 立即返回错误，并附上修复建议

故障排除

问题	解决方案
“Cannot find module” 或 npx 错误	确保已安装 Node.js 22+：node --version
“Invalid API key”	在 kit.com → Developer 仔细检查密钥
Claude 中未显示工具	完全退出并重启 Claude Desktop（不只是关闭窗口）
“requires OAuth authentication”	manage_purchases 和 bulk_operations 需要 KIT_OAUTH_TOKEN
速率限制错误	自动处理——服务会在退避后重试。如果问题持续存在，请等待 60 秒

开发

npm install
npm run dev          # Watch mode
npm run build        # Production build
npm test             # Unit tests (179 tests)
npm run test:int     # Integration tests (requires KIT_API_KEY)
npm run lint         # Biome check
npm run typecheck    # TypeScript check

许可证

MIT