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瞭解貢獻指南。