ClickBank MCP Server

用于 ClickBank REST 1.3 的 Stdio Model Context Protocol 服务器。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

列表端点每页返回 100 行。传入 page 以及可选的 maxPages（最大 10）。HTTP 206 表示还有更多页面。客户端会对请求进行间隔控制（约 8 次/秒），以保持在 ClickBank 每秒 10 次请求的配额之内。

开发

npm test
npm run dev

npm run dev 仍然需要环境中有 CLICKBANK_API_KEY。测试会模拟 fetch，不会调用 ClickBank。