mcp-kit

为什么使用它？

如果你在 Kit.com 上运营新闻简报或开展邮件营销，这个 MCP 服务可以让你：

• 管理订阅者 - 列出、创建、更新和整理邮件订阅者
• 高效处理标签 - 创建标签、为订阅者添加或移除标签、按标签列出订阅者
• 处理邮件序列 - 查看邮件序列，并将订阅者加入自动化序列
• 创建群发邮件 - 起草和管理邮件营销活动
• 分析邮件列表 - 使用筛选条件（状态、日期范围、自定义字段）查询订阅者数据
• 自动化工作流 - 让 Claude 处理重复的邮件营销任务

功能

工具完整参考

账户

• kit_get_account - 获取 Kit.com 账户信息

订阅者（7 个工具）

• kit_list_subscribers - 按筛选条件（状态、日期范围、分页）列出订阅者
• kit_get_subscriber - 按 ID 获取指定订阅者
• kit_create_subscriber - 创建新订阅者
• kit_update_subscriber - 更新订阅者详情
• kit_get_subscriber_tags - 获取订阅者的所有标签
• kit_add_tag_to_subscriber - 为订阅者添加标签
• kit_remove_tag_from_subscriber - 移除订阅者的标签

标签（6 个工具）

• kit_list_tags - 列出所有标签
• kit_get_tag - 获取指定标签
• kit_create_tag - 创建新标签
• kit_update_tag - 重命名标签
• kit_delete_tag - 删除标签
• kit_list_tag_subscribers - 列出带有指定标签的所有订阅者

序列（3 个工具）

• kit_list_sequences - 列出所有邮件序列
• kit_get_sequence - 获取序列详情
• kit_add_subscriber_to_sequence - 将订阅者添加到序列

广播（5 个工具）

• kit_list_broadcasts - 列出所有广播
• kit_get_broadcast - 获取广播详情
• kit_create_broadcast - 创建新广播
• kit_update_broadcast - 更新广播
• kit_delete_broadcast - 删除广播

表单（3 个工具）

• kit_list_forms - 列出所有表单
• kit_get_form - 获取表单详情
• kit_add_subscriber_to_form - 通过表单添加订阅者

自定义字段（1 个工具）

• kit_list_custom_fields - 列出所有自定义字段

Webhook（3 个工具）

• kit_list_webhooks - 列出已配置的 Webhook
• kit_create_webhook - 创建新的 Webhook
• kit_delete_webhook - 删除 Webhook

前置要求

• Node.js 18+
• 一个 Kit.com 账户
• 你的 Kit.com API 密钥（v4 API）

安装

选项 1：从 npm 安装（推荐）

npx kit-mcp-server

或全局安装：

npm install -g kit-mcp-server

选项 2：克隆并构建

git clone https://github.com/aplaceforallmystuff/mcp-kit.git
cd mcp-kit
npm install
npm run build

配置

1. 获取 Kit.com API 密钥

1. 登录 Kit.com
2. 前往 Settings > Developer
3. 创建新的 API 密钥，或复制现有的 v4 API 密钥

2. 配置 MCP 客户端

用于 Claude Desktop

将以下内容添加到你的 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

用于 Claude Code

claude mcp add kit -e KIT_API_KEY=your-api-key-here -- node /path/to/mcp-kit/dist/index.js

或添加到 ~/.claude.json：

{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用示例

配置完成后，你可以通过自然语言与 Kit.com 交互：

订阅者管理

“显示过去 30 天内的所有活跃订阅者”

“创建一个邮箱为 [email protected] 的新订阅者，并为其添加 ‘newsletter’ 标签”

“[email protected] 有哪些标签？”

标签操作

“列出我的所有标签以及每个标签对应的订阅者数量”

“创建一个名为 ‘VIP Customers’ 的标签”

“为本月注册的所有订阅者添加 ‘engaged’ 标签”

邮件序列

“显示我的所有邮件序列”

“将 [email protected] 添加到欢迎序列”

广播

“创建一封草稿广播，主题为 ‘Weekly Update’，预览文本为 ‘This week in AI...’”

“列出我最近的所有广播及其统计数据”

表单

“显示所有启用的表单”

“将一位订阅者添加到我的主注册表单”

开发

# Run in development mode (watches for changes)
npm run dev

# Build for production
npm run build

# Run the built version
npm start

故障排除

“KIT_API_KEY 环境变量是必需的”

请确保已在 MCP 配置中设置 KIT_API_KEY 环境变量。

“Kit API error (401)”

你的 API 密钥无效或已过期。请从 Kit.com 的 Settings > Developer 生成新密钥。

“Kit API error (403)”

你的 API 密钥无权执行此操作。请确认使用的是具有适当权限范围的 v4 API 密钥。

“Kit API error (404)”

未找到该资源（订阅者、标签、广播等）。请确认 ID 正确。

“Kit API error (422)”

请求数据无效。请检查邮箱地址是否有效，并确保已提供必填字段。

API 参考

此服务使用 Kit.com API v4。所有工具均支持分页（如适用），使用 per_page 和 after 游标参数。

贡献

此项目已弃用，不再接受贡献。请改用 Kit 的官方 MCP 服务。

许可证

MIT 许可证——详情请参阅 LICENSE。

链接

• Kit.com
• Kit.com API 文档
• 模型上下文协议
• MCP 规范