MCP Kit

🚀 MCP Kit Server

MCP（模型上下文协议）服务器，可将Claude等AI助手连接到Kit.com（原ConvertKit）电子邮件营销平台。你可以通过自然语言管理电子邮件列表、订阅者、广播、序列等内容。

🚀 快速开始

MCP Kit Server能让Claude等AI助手与Kit.com平台交互，通过自然语言完成各种电子邮件营销任务。使用前，你需要准备好Node.js 18+环境、Kit.com账户及对应的API密钥，然后按照安装和配置步骤操作，即可开始使用。

✨ 主要特性

使用场景

如果你在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

📦 安装指南

选项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

💻 使用示例

基础用法

配置完成后，你可以通过自然语言与Kit.com进行交互，以下是一些示例：

• 订阅者管理
  • "Show me all active subscribers from the last 30 days"（显示过去30天内的所有活跃订阅者）
  • "Create a new subscriber with email user@example.com and tag them as 'newsletter'"（创建一个新订阅者，邮箱为user@example.com，并将其标记为“时事通讯”）
  • "What tags does subscriber@example.com have?"（subscriber@example.com有哪些标签？）
• 标签操作
  • "List all my tags and how many subscribers each has"（列出我所有的标签以及每个标签下的订阅者数量）
  • "Create a tag called 'VIP Customers'"（创建一个名为“VIP客户”的标签）
  • "Add the 'engaged' tag to all subscribers who signed up this month"（为本月注册的所有订阅者添加“活跃”标签）
• 电子邮件序列
  • "Show me all my email sequences"（显示我所有的电子邮件序列）
  • "Add user@example.com to the welcome sequence"（将user@example.com添加到欢迎序列中）
• 广播
  • "Create a draft broadcast with subject 'Weekly Update' and preview text 'This week in AI...'"（创建一个草稿广播，主题为“每周更新”，预览文本为“本周AI动态...”）
  • "List all my recent broadcasts and their stats"（列出我最近的所有广播及其统计信息）
• 表单
  • "Show me all active forms"（显示所有活跃表单）
  • "Add a subscriber to my main signup form"（将一个订阅者添加到我的主要注册表单中）

📚 详细文档

配置步骤

1. 获取Kit.com API密钥

1. 登录Kit.com。
2. 导航到“设置”>“开发者”。
3. 创建新的API密钥或复制现有的v4 API密钥。

2. 配置MCP客户端

• Claude桌面版：
  • 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代码版：

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"
      }
    }
  }
}

开发相关

# 以开发模式运行（监听文件变化）
npm run dev

# 构建生产版本
npm run build

# 运行构建后的版本
npm start

故障排除

• "KIT_API_KEY environment variable is required"：确保在MCP配置中设置了KIT_API_KEY环境变量。
• "Kit API error (401)"：API密钥无效或已过期。从Kit.com“设置”>“开发者”中生成新的密钥。
• "Kit API error (403)"：API密钥没有执行此操作的权限。确保使用的是具有适当作用域的v4 API密钥。
• "Kit API error (404)"：未找到资源（订阅者、标签、广播等）。验证ID是否正确。
• "Kit API error (422)"：请求数据无效。检查电子邮件地址是否有效，并确保提供了必需的字段。

API参考

此服务器使用Kit.com API v4。所有工具在适用的情况下支持使用per_page和after游标参数进行分页。

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

🔗 相关链接

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

🤝 贡献说明

欢迎贡献代码！请参阅CONTRIBUTING.md了解贡献指南。