ClickBank MCP Server

Stdio-сервер Model Context Protocol для ClickBank REST 1.3. Cursor и другие MCP-хосты могут запрашивать аналитику, заказы, продукты, quickstats, доставку и тикеты. Операции записи (возвраты, изменения каталога, изменения подписок) отключены, если вы не включите их явно.

Настройка

1. Создайте API-ключ в ClickBank: Как создать API-ключи ClickBank.

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/s), чтобы не превышать квоту ClickBank в 10 запросов в секунду.

Разработка

npm test
npm run dev

npm run dev по-прежнему требует CLICKBANK_API_KEY в окружении. Тесты имитируют fetch и не обращаются к ClickBank.