ClickBank MCP Server

ClickBank REST 1.3을 위한 Stdio Model Context Protocol 서버입니다. Cursor 및 기타 MCP 호스트는 애널리틱스, 주문, 상품, 퀵스탯, 배송, 티켓을 조회할 수 있습니다. 쓰기 작업(환불, 카탈로그 편집, 구독 변경)은 옵트인하지 않으면 꺼져 있습니다.

설정

1. ClickBank에서 API 키를 생성하세요: How to create ClickBank API keys.

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

• 퀵스탯: 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은 더 많은 페이지가 남아 있음을 의미합니다. 클라이언트는 ClickBank의 초당 10회 요청 할당량을 지키기 위해 요청 간격(~8/s)을 둡니다.

개발

npm test
npm run dev

npm run dev는 여전히 환경에 CLICKBANK_API_KEY가 필요합니다. 테스트는 fetch를 모킹하며 ClickBank를 호출하지 않습니다.