mcp-kit

これを使う理由

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

ウェブフック（3 ツール）

• kit_list_webhooks - 設定済みのウェブフックを一覧表示
• kit_create_webhook - 新しいウェブフックを作成
• kit_delete_webhook - ウェブフックを削除

前提条件

• Node.js 18+
• 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. Settings > Developer に移動します
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 日間に登録したアクティブな購読者をすべて表示して」

「メールアドレス [email protected] で新しい購読者を作成し、'newsletter' タグを付けて」

「[email protected] にはどのタグが付いている？」

タグの操作

「すべてのタグと、それぞれの購読者数を一覧表示して」

「'VIP Customers' というタグを作成して」

「今月登録したすべての購読者に 'engaged' タグを追加して」

メールシーケンス

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

「[email protected] をウェルカムシーケンスに追加して」

一斉配信

「件名を 'Weekly Update'、プレビューテキストを 'This week in 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 environment variable is required」

MCP 設定で KIT_API_KEY 環境変数が設定されていることを確認してください。

「Kit API error (401)」

API キーが無効か、期限切れです。Kit.com の Settings > Developer から新しいキーを生成してください。

「Kit API error (403)」

API キーにこの操作を実行する権限がありません。適切なスコープが設定された v4 API キーを使用していることを確認してください。

「Kit API error (404)」

リソース（購読者、タグ、一斉配信など）が見つかりませんでした。ID が正しいことを確認してください。

「Kit API error (422)」

リクエストデータが無効です。メールアドレスが有効であり、必須フィールドが指定されていることを確認してください。

API リファレンス

このサーバーでは、Kit.com API v4を使用します。該当する場合、すべてのツールでper_pageおよびafterのカーソルパラメーターを使ったページネーションに対応しています。

コントリビューション

このプロジェクトは非推奨となっており、コントリビューションを受け付けていません。代わりに、Kit の公式 MCP サーバーをご利用ください。

ライセンス

MIT ライセンスです。詳細はLICENSEをご覧ください。

リンク

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