使用说明
MCP套件服务器
一个MCP(模型上下文协议)服务器,将克劳德等人工智能助手连接到 Kit.com (前身为ConvertKit)电子邮件营销平台。通过自然语言管理您的电子邮件列表、订阅者、广播、序列等。
[!警告] 此项目已弃用,不再维护。 Kit现在提供官方的第一方MCP服务器,以更广泛的API覆盖范围和托管身份验证取代它。请迁移——见下文。
⚠️ 弃用——使用Kit的官方MCP服务器
这个社区服务器是在Kit提供自己的MCP之前构建的。Kit现在维护 官方服务器 它涵盖了更多的Kit API v4表面(包括分析、商务、细分市场和批量操作),为您处理身份验证,并随时了解API的变化。 新用户和现有用户都应该迁移。
| 用例 | 官方服务器 | URL |
|---|---|---|
| 对您的Kit帐户进行操作——订阅者、标签、序列、广播, 分析商业 | MCP套件 | https://app.kit.com/mcp |
| 让编码代理实时访问Kit的开发人员文档+API | 工具包开发人员文档MCP | https://developers.kit.com/mcp |
用克劳德代码迁移
# Remove this deprecated server (if you added it as "kit")
claude mcp remove kit
# Add the official operational Kit MCP
claude mcp add --transport http kit https://app.kit.com/mcp
# Optional: add Kit's developer-docs MCP for building integrations
claude mcp add --transport http kit-docs https://developers.kit.com/mcp
官方设置指南(Claude Desktop、Cursor、Windsurf、Cline等): https://developers.kit.com/mcp/kit-developer-docs-mcp/mcp/overview
📦 Legacy documentation (for historical reference)
为什么使用这个?
如果您在Kit.com上运行时事通讯或电子邮件营销,此MCP服务器可以让您:
- 管理订阅者 -列出、创建、更新和组织您的电子邮件订阅者
- 高效处理标签 -创建标签,在订阅者中添加/删除标签,按标签列出订阅者
- 使用序列 -查看电子邮件序列并将订阅者添加到自动序列中
- 创建广播 -起草和管理电子邮件活动
- 分析您的列表 -使用筛选器(状态、日期范围、自定义字段)查询订阅者数据
- 自动化工作流程 -让克劳德处理重复的电子邮件营销任务
特性
| 类别 | 工具 |
|---|---|
| 账户 | 获取帐户信息 |
| 订阅者 | 列出、获取、创建、更新、管理标签 |
| 标签 | 按标签列出、创建、更新、删除、获取订阅者 |
| 序列 | 列出、获取、添加订阅者 |
| 广播 | 列出、获取、创建、更新、删除 |
| 表单 | 列出、获取、添加订阅者 |
| 自定义字段 | 列出可用字段 |
| 网络钩子 | 列出、创建、删除 |
完整的工具参考
账户
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-列出所有自定义字段
Webhooks(3个工具)
kit_list_webhooks-列出已配置的Webhookkit_create_webhook-创建新的webhookkit_delete_webhook-删除webhook
先决条件
- Node.js 18+
- A. 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密钥
- 登录到 Kit.com
- 导航到“设置”>“开发人员”
- 创建新的API密钥或复制现有的v4 API密钥
2.配置您的MCP客户端
适用于克劳德桌面
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %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 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天的所有活动订阅者”
“使用电子邮件创建新订户user@example.com并将其标记为“时事通讯”
“标签做什么subscriber@example.com有?"
标签操作
“列出我的所有标签以及每个标签有多少订阅者”
“创建一个名为‘VIP客户’的标签”
“为本月注册的所有订阅者添加“已参与”标签”
电子邮件序列
“显示我的所有电子邮件序列”
“添加user@example.com欢迎序列”
广播
“创建主题为“每周更新”的广播草稿,并预览文本“本周在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环境变量是必需的”
确保您已设置 KIT_API_KEY MCP配置中的环境变量。
“套件API错误(401)”
您的API密钥无效或已过期。从Kit.com设置>开发人员生成一个新的。
“工具包API错误(403)”
您的API密钥没有执行此操作的权限。请检查您是否正在使用具有适当作用域的v4 API密钥。
“工具包API错误(404)”
找不到资源(订阅者、标签、广播等)。验证ID是否正确。
“套件API错误(422)”
请求数据无效。检查电子邮件地址是否有效,是否提供了必填字段。
API 参考
此服务器使用 Kit.com API v4。所有工具都支持分页(如适用),使用 per_page 和 after 光标参数。
贡献
这个项目是 弃用 不接受捐款。请使用Kit的 官方MCP服务器 相反。
许可证
MIT许可证-请参阅 许可证 了解详情。