邮件营销协议服务器

一个连接AI助手与Kit.com邮件营销平台的MCP服务器,用于管理邮件列表、订阅者、广播、序列等。

  • by aplaceforallmystuff
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 aplaceforallmystuff/mcp-kit

使用说明

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 -列出已配置的Webhook
  • kit_create_webhook -创建新的webhook
  • kit_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密钥

  1. 登录到 Kit.com
  2. 导航到“设置”>“开发人员”
  3. 创建新的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许可证-请参阅 许可证 了解详情。

链接