ClickBank MCP Server

Ein Stdio-Model Context Protocol-Server für ClickBank REST 1.3. Cursor und andere MCP-Hosts können Analysen, Bestellungen, Produkte, Quickstats, Versand und Tickets abfragen. Schreiboperationen (Erstattungen, Katalogänderungen, Abonnementänderungen) sind deaktiviert, sofern Sie sie nicht aktivieren.

Einrichtung

1. Erstellen Sie einen API-Schlüssel in ClickBank: So erstellen Sie ClickBank-API-Schlüssel.

2. Erteilen Sie dem Schlüssel die benötigten Rollen (api_order_read, api_products_client, api_order_write, api_subscription_modifications usw.).

3. Kopieren Sie .env.example und füllen Sie die Werte aus (der Server liest die Prozessumgebung, nicht die Datei, es sei denn, Ihr Host injiziert sie).

npm install
npm run build

Erforderliche Umgebungsvariablen:

ClickBank verlangt keinen Entwicklerschlüssel mehr. Der Authorization-Header darf weder protokolliert noch committet werden.

Related MCP server: wealthbox-mcp

Cursor

Führen Sie zuerst den Build aus und verweisen Sie Cursor dann auf 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"
      }
    }
  }
}

Lassen Sie CLICKBANK_ENABLE_WRITES auf false, außer Sie möchten, dass das Modell Erstattungen durchführen, Produkte löschen oder Abonnements ändern kann.

Werkzeuge

Lese-Werkzeuge sind immer registriert:

• Analysen: get_analytics, get_subscription_analytics

• Bestellungen: list_orders, count_orders, get_order, get_order_upsells, check_order_active

• Produkte: list_products, get_product

• Quickstats: list_quickstats, summarize_quickstats, list_clickbank_accounts

• Versand: list_shippable_orders, count_shippable_orders, get_ship_notices

• Tickets: list_tickets, count_tickets, get_ticket, get_refund_amounts

Schreib-Werkzeuge (nur wenn CLICKBANK_ENABLE_WRITES=true):

• modify_subscription — Produkttausch, Adresse, Folgeabrechnungsdatum, Verlängerung, Pausierung, Reaktivierung

• save_product, delete_product

• create_ship_notice

• create_ticket, update_ticket, confirm_physical_return

Listen-Endpunkte geben 100 Zeilen pro Seite zurück. Übergeben Sie page und optional maxPages (maximal 10). HTTP 206 bedeutet, dass noch weitere Seiten vorhanden sind. Der Client drosselt die Anfragen (~8/s), um unter ClickBanks Limit von 10 Anfragen pro Sekunde zu bleiben.

Entwicklung

npm test
npm run dev

npm run dev benötigt weiterhin CLICKBANK_API_KEY in der Prozessumgebung. Die Tests mocken fetch und rufen ClickBank nicht auf.