MCP Kit

🚀 MCP Kit Server

このサーバーは、ClaudeなどのAIアシスタントをKit.com（旧ConvertKit）のメールマーケティングプラットフォームに接続するMCP（Model Context Protocol）サーバーです。自然言語でメールリスト、購読者、ブロードキャスト、シーケンスなどを管理できます。

🚀 クイックスタート

このMCPサーバーを使用すると、Kit.comでニュースレターやメールマーケティングを行う際に、自然言語で様々な操作を行うことができます。以下に、主な機能を紹介します。

✨ 主な機能

完全なツールリファレンス

アカウント

• 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 - すべてのカスタムフィールドを一覧表示

ウェブフック (3つのツール)

• kit_list_webhooks - 設定されたウェブフックを一覧表示
• kit_create_webhook - 新しいウェブフックを作成
• kit_delete_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

📚 ドキュメント

1. Kit.comのAPIキーを取得する

1. Kit.comにログインします。
2. 設定 > 開発者に移動します。
3. 新しいAPIキーを作成するか、既存のv4 APIキーをコピーします。

2. MCPクライアントを設定する

Claude Desktopの場合

Claude Desktopの設定ファイルに追加します。

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 Codeの場合

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の新しい購読者を作成し、'newsletter'というタグを付ける"

"subscriber@example.comにはどのタグが付いていますか？"

タグ操作

"すべてのタグと、それぞれのタグに付いている購読者の数を一覧表示して"

"「VIP Customers」というタグを作成する"

"今月登録したすべての購読者に「engaged」タグを付ける"

メールシーケンス

"すべてのメールシーケンスを表示して"

"user@example.comをウェルカムシーケンスに追加する"

ブロードキャスト

"件名が「Weekly Update」でプレビューテキストが「This week in AI...」の下書きブロードキャストを作成する"

"最近のすべてのブロードキャストとその統計情報を一覧表示して"

フォーム

"すべてのアクティブなフォームを表示して"

"メインのサインアップフォームに購読者を追加する"

🔧 技術詳細

このサーバーはKit.com API v4を使用しています。すべてのツールは、該当する場合、per_pageとafterカーソルパラメータを使用してページネーションをサポートしています。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。

リンク

• Kit.com
• Kit.com APIドキュメント
• Model Context Protocol
• MCP仕様