金大哥 - mcp-kit MCP 详情

article

README

🚀 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处理重复性的电子邮件营销任务。

功能分类

| 类别 | 工具 | |------|------| | 账户 | 获取账户信息 | | 订阅者 | 列出、获取、创建、更新、管理标签 | | 标签 | 列出、创建、更新、删除、按标签获取订阅者 | | 序列 | 列出、获取、添加订阅者 | | 广播 | 列出、获取、创建、更新、删除 | | 表单 | 列出、获取、添加订阅者 | | 自定义字段 | 列出可用字段 | | Webhook | 列出、创建、删除 |

完整工具参考

账户
- 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密钥

登录Kit.com。
导航到“设置”>“开发者”。
创建新的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游标参数进行分页。

mcp-kit