ClickBank MCP Server

Stdio Model Context Protocol サーバー（ClickBank REST 1.3 用）です。Cursor やその他の MCP ホストは、アナリティクス、注文、商品、Quickstats、配送、チケットを照会できます。書き込み操作（返金、カタログ編集、サブスクリプション変更）は、オプトインしない限り無効です。

セットアップ

1. ClickBank で API キーを作成します: ClickBank API キーの作成方法。

2. キーに必要なロールを付与します（api_order_read、api_products_client、api_order_write、api_subscription_modifications など）。

3. .env.example をコピーして値を入力します（サーバーが読み取るのはファイルではなくプロセス環境変数です。ホストが注入する場合を除きます）。

npm install
npm run build

必須環境変数:

ClickBank はもはや開発者キーを必要としません。Authorization ヘッダーをログに記録したり、コミットしたりしないでください。

Related MCP server: wealthbox-mcp

Cursor

まずビルドしてから、Cursor に dist/index.js を指定します:

{
  "mcpServers": {
    "clickbank": {
      "command": "node",
      "args": ["/absolute/path/to/clickbank-mcp/dist/index.js"],
      "env": {
        "CLICKBANK_API_KEY": "API-your-key-here",
        "CLICKBANK_ACCOUNT": "yournick",
        "CLICKBANK_ENABLE_WRITES": "false"
      }
    }
  }
}

モデルに返金、商品の削除、サブスクリプションの変更をさせたい場合を除き、CLICKBANK_ENABLE_WRITES は false のままにしてください。

ツール

読み取りツールは常に登録されます:

• アナリティクス: get_analytics、get_subscription_analytics

• 注文: list_orders、count_orders、get_order、get_order_upsells、check_order_active

• 商品: list_products、get_product

• Quickstats: list_quickstats、summarize_quickstats、list_clickbank_accounts

• 配送: list_shippable_orders、count_shippable_orders、get_ship_notices

• チケット: list_tickets、count_tickets、get_ticket、get_refund_amounts

書き込みツール（CLICKBANK_ENABLE_WRITES=true の場合のみ）:

• modify_subscription — 商品の交換、住所、再請求日、延長、一時停止、復元

• save_product、delete_product

• create_ship_notice

• create_ticket、update_ticket、confirm_physical_return

一覧系エンドポイントは 1 ページあたり 100 行を返します。page とオプションの maxPages（最大 10）を渡します。HTTP 206 は、まだページが残っていることを意味します。クライアントは、ClickBank の毎秒 10 リクエストのクォータ内に収まるよう、リクエストの間隔を空けます（約 8/秒）。

開発

npm test
npm run dev

npm run dev でも環境内に CLICKBANK_API_KEY が必要です。テストは fetch をモックし、ClickBank を呼び出しません。