Kit.com MCP Server

@dancumberland/kit-mcp

Kit.com（旧ConvertKit）向けの最も包括的なMCPサーバーです。エンゲージメント分析、一括操作、他のKit MCPにはないブロードキャストのクリック追跡など、Kit V4 APIの100％を網羅した、エージェントに最適化された13個のツールを提供します。

どこが違うのか

他のKit MCPサーバーは、各APIエンドポイントを個別のツール（29個以上）としてラップしています。この方法は、実際にはうまく機能しません。

	@dancumberland/kit-mcp	他のKit MCP
ツール数	13個の複合ツール（45個のアクション）	29個以上の個別ツール
エンゲージメント分析	購読者ごとの開封率・クリック率、100人までの一括比較、エンゲージメントに基づく絞り込み	なし
ブロードキャスト分析	ブロードキャストごとの統計、ブロードキャスト間の比較、リンクごとのクリック追跡	基本的な一覧表示・取得のみ
一括操作	購読者、タグ、フォーム登録を一括作成（1回の呼び出しにつき最大10,000件）	なし
レスポンス形式	整形済みのテキスト要約（エージェントに適した形式）	生のJSON（エージェントが解析する必要あり）
レート制限	スライディングウィンドウ方式、自動再試行、指数バックオフ	なし
エラー回復	対処方法を示すヒント付きの型付きエラー	一般的なエラー
Cursor対応	13個のツール（40個の上限を大幅に下回ります）	29個以上のツール（上限に達するリスクがあります）
トークンのオーバーヘッド	すべてのツール定義で約3,200トークン	8,000トークン以上

エンゲージメント分析（独自機能）

「最もエンゲージメントの高い購読者は誰ですか？」という質問に回答できるKit MCPは、これだけです。

> Find my most engaged 100 subscribers who've been on my list over 6 months

Subscriber Comparison (100 of 100 loaded, sorted by open rate):

  1. Alice <[email protected]> — Open: 82.3% | Click: 24.1% | Sent: 95 | Last open: 2026-03-15 (ID: 456)
  2. Bob <[email protected]> — Open: 71.0% | Click: 18.5% | Sent: 102 | Last open: 2026-03-14 (ID: 789)
  ...

他のKit MCPでは購読者の一覧表示や基本プロフィールの取得はできますが、エンゲージメント統計の取得、購読者間の比較、エンゲージメント指標による絞り込みはできません。

できること

あらゆるMCPクライアント（Claude Desktop、Claude Code、Cursor、Windsurfなど）を、Kit.comのメールマーケティングアカウントに接続します。自然な言葉で質問できます。

• 「購読者は何人いて、リストはどのように増えていますか？」
• 「先週のブロードキャストの統計を見せて」
• 「過去6か月間で、最もエンゲージメントの高い購読者を探して」
• 「ランディングページから登録した全員にタグを付けて」
• 「ニュースレターの下書きブロードキャストを作成して」
• 「前回のブロードキャストで最もクリックされたリンクはどれですか？」

コーディングは不要です。セットアップして、話しかけるだけです。

前提条件

1. Node.js 22以降 — nodejs.orgからダウンロードしてください。node --versionで確認できます。
2. Kit.comアカウント — 無料・有料を問わず、どのプランでも利用できます。
3. Kit APIキー — kit.com → アカウント設定 → Developerから取得してください。kit_で始まります。

セットアップ：Claude Desktopアプリ（推奨）

ステップ1：設定ファイルを探す

Mac：

open ~/Library/Application\ Support/Claude/

任意のテキストエディターでclaude_desktop_config.jsonを開きます。

Windows：

%APPDATA%\Claude\claude_desktop_config.json

ステップ2：Kit MCPサーバーを追加する

ファイルが空、または存在しない場合は、次の内容を貼り付けます（your-kit-api-keyを実際のキーに置き換えてください）。

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

すでに他のMCPサーバーがある場合は、既存の"mcpServers"ブロック内に"kit"を追加し、前のエントリの後にカンマを付けます。

ステップ3：Claude Desktopを再起動する

Claude Desktopを完全に終了し（ウィンドウを閉じるだけでは不十分です）、再度開きます。

ステップ4：動作を確認する

Kitへの接続をテストして

Claudeはアカウント名、認証方法、レート制限を返します。

セットアップ：Coworkを使ったClaude Desktop

Coworkは、Claude Desktopのバックグラウンドエージェントです。上記のセットアップを完了すると、CoworkからKitのツールを自動的に利用できるようになります。

タスクの例：

• 「毎朝8時に、過去24時間の購読者の増加とメールのパフォーマンスを要約して。」
• 「毎週月曜日の午前9時に、過去1週間のブロードキャスト統計（開封率、クリック率、登録解除数）を比較して。」
• 「毎週金曜日に、購読者が10人未満のタグをすべて一覧表示して（整理候補です）。」

セットアップ：Claude Code（CLI）

.claude/settings.local.jsonまたは~/.claude/settings.jsonに追加します。

{
  "mcpServers": {
    "kit": {
      "command": "npx",
      "args": ["-y", "@dancumberland/kit-mcp@latest"],
      "env": {
        "KIT_API_KEY": "your-kit-api-key"
      }
    }
  }
}

セットアップ：Cursor

1. 設定を開きます（Cmd+,）
2. 「MCP」を検索します
3. 「MCPサーバーを追加」をクリックします
4. 次を追加します。

{
  "kit": {
    "command": "npx",
    "args": ["-y", "@dancumberland/kit-mcp@latest"],
    "env": {
      "KIT_API_KEY": "your-kit-api-key"
    }
  }
}

ツール

ツール	アクション	できること
manage_subscribers	10	最大100人の購読者の検索、一覧表示、作成、更新、購読解除、統計の表示、エンゲージメントの比較、1回の呼び出しでエンゲージメント上位の購読者を検索、ステータスやタグによる絞り込み、エンゲージメント指標による絞り込み
manage_tags	6	一覧表示、作成、更新、購読者へのタグ付け／タグ解除、タグ付け済みの購読者の一覧表示
manage_broadcasts	8	一覧表示、取得、下書きの作成、更新、削除、統計の表示、ブロードキャスト間の統計比較、リンクごとのクリックデータの分析
manage_forms	3	フォームの一覧表示、購読者の一覧表示、購読者の追加
manage_sequences	3	シーケンスの一覧表示、購読者の追加、購読者の一覧表示
manage_custom_fields	4	一覧表示、作成、更新、削除
manage_purchases	3	一覧表示、取得、作成（OAuth が必要）
manage_segments	1	セグメントの一覧表示
manage_webhooks	3	一覧表示、作成、削除
manage_email_templates	1	テンプレートの一覧表示
get_account	—	メールと成長統計を含むアカウントの全体概要
test_connection	—	API キーが機能することを確認
bulk_operations	7	購読者／タグ／フォーム／フィールドの一括操作（OAuth が必要）

できること

入力例	実行される処理
「メールリストの状況はどうですか？」	アカウント統計、購読者数、成長傾向を表示
「[email protected] を探して」	タグ、カスタムフィールド、エンゲージメント統計を含む購読者プロフィールを表示
「最もエンゲージメントの高い購読者は誰ですか？」	開封率／クリック率で順位付けした、エンゲージメントで絞り込まれた一覧を表示
「最近のブロードキャストを表示して」	ステータス（下書き／予約済み／送信済み）とともにブロードキャストを表示
「直近のブロードキャストの成果はどうでしたか？」	開封率、クリック率、購読解除数、リンクごとのクリックデータを表示
「最もクリックされたリンクはどれですか？」	任意のブロードキャストのリンクごとのクリック分析を表示
「ブロードキャストの成果を比較して」	すべてのブロードキャストの統計を並べて表示
「vip-customers というタグを作成して」	Kit にタグを作成
「[email protected] に vip-customers のタグを付けて」	タグを適用
「件名が『Big News』のブロードキャストを下書きして」	下書きを作成（送信はしません）

認証

API キー（ほとんどの機能に対応）：kit.com → Developer で取得します。KIT_API_KEY として設定してください。

OAuth トークン（任意。購入と一括操作に使用）：API キーとともに KIT_OAUTH_TOKEN を設定してください。

{
  "env": {
    "KIT_API_KEY": "your-api-key",
    "KIT_OAUTH_TOKEN": "your-oauth-token"
  }
}

レート制限は自動的に適用されます：120 req/min（API キー）または600 req/min（OAuth）。429 エラーの場合は再試行とバックオフを行います。

アーキテクチャ：29 個以上ではなく 13 個のツールを使う理由

ほとんどの MCP サーバーは API エンドポイントごとに 1 つのツールを作成します。Kit の API では 29 個以上のツールが必要になり、実際に次のような問題が生じます。

• コンテキストの肥大化 — ツール定義だけで8,000トークン以上を消費し、実際の会話に使える余地が減ります
• 精度の低下 — ツールが20個を超えると、AI によるツール選択の精度が測定可能なほど低下します（研究）
• 互換性 — Cursor はすべてのサーバーを合わせてツール数が40個までという厳しい制限があります。1つのサーバーで29個のツールを使うと、ほかのサーバーに割り当てられる余地がほとんどありません

このサーバーでは、識別可能な action パラメーターを持つ13個の複合ツールを使用します。同じ API 範囲をカバーしながら、トークンを60％削減し、精度を高めます。各ツールは関連する操作をまとめており（例：すべての購読者操作を manage_subscribers に集約）、AI が最初の試行で適切なツールを選べるようにします。

エラー処理

エラーには、Claude が実行できる復旧のヒントが含まれます。

Error 401: Invalid API key
Recovery: Check your KIT_API_KEY. Find your key at kit.com → Account Settings → Developer.

• 429（レート制限）：最大3回まで、指数バックオフで自動再試行
• 5xx（サーバーエラー）：1回、自動再試行
• 422（検証エラー）：再試行せず、修正案とともにエラーをただちに返します

トラブルシューティング

問題	解決方法
「モジュールが見つかりません」または npx のエラー	Node.js 22 以降がインストールされていることを確認してください：node --version
「API キーが無効です」	kit.com → Developer でキーを再確認してください
Claude にツールが表示されない	Claude Desktop を完全に終了して再起動してください（ウィンドウを閉じるだけでは不十分です）
「OAuth 認証が必要です」	manage_purchases と bulk_operations には KIT_OAUTH_TOKEN が必要です
レート制限エラー	自動で再試行されます。サーバーはバックオフしながら再試行します。解消しない場合は、60 秒待ってください

開発

npm install
npm run dev          # Watch mode
npm run build        # Production build
npm test             # Unit tests (179 tests)
npm run test:int     # Integration tests (requires KIT_API_KEY)
npm run lint         # Biome check
npm run typecheck    # TypeScript check

ライセンス

MIT