FinCobra MCP — Krypto-Checkout für Claude, Cursor und Codex

Model Context Protocol (MCP)-Server für den FinCobra-Krypto-Checkout und Zahlungen. Erstellen Sie gehostete Rechnungen für BTC, USDT und USDC (Settlement-Assets stammen aus den Zahlungsmethoden des Dashboards; Beträge sind in USD). Funktioniert mit Claude Code, Cursor und Codex. Der Watchlist-Zugriff ist schreibgeschützt. Noch nicht auf npm — von GitHub installieren.

Dokumentation: FinCobra Checkout MCP

fincobra-mcp 0.1.0 ist noch nicht auf npm veröffentlicht. Bis dahin von GitHub installieren:

npx -y github:dexstandard/fincobra-mcp

Pinnen Sie eine Quell-Release mit npx -y github:dexstandard/fincobra-mcp#v0.1.0. Erfordert Node.js 20+.

• Checkout: eine gehostete Zahlungsrechnung erstellen und deren Status abrufen

• Watchlist: schreibgeschützte Quellenliste und manuelle Nettovermögensaufstellung

Dies ist keine Zahlungsplattform und keine Watchlist-Schreib-API.

Tools (v0)

Checkout

Es gibt kein list_invoices-Tool. Checkout-API-Schlüssel können keine Rechnungen auflisten.

Rechnungsbeträge sind in USD. Settlement-Assets stammen aus den Zahlungsmethoden des Dashboards:

Watchlist (schreibgeschützt)

Die Watchlist hat keinen öffentlichen API-Schlüssel. Die Authentifizierung erfolgt über das Identity-session-Cookie, das von der Watchlist-Web-App verwendet wird.

Banken, Bargeld und Immobilien sind manuelle Produkteinträge, keine Live-Bank- oder Grundbuch-Feeds. Live-Krypto-USD-Salden werden in der Watchlist-Oberfläche berechnet und sind nicht in der Listen-API enthalten. Der Server erfindet keine cryptoUsd-Summe.

Watchlist-Tools fügen keine Wallets hinzu, bearbeiten keine Banken, ändern keine Abrechnung und exportieren keine Steuern.

Related MCP server: Infini Payment MCP Server

Umgebung

Konfigurieren Sie Checkout, Watchlist oder beides. Tools für eine fehlende Oberfläche geben einen Konfigurationsfehler zurück.

Entwicklungs-Origins: https://dev.fincobra.com und https://watch.dev.fincobra.com.

Cursor

Fügen Sie zu .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (Benutzer) hinzu:

{
  "mcpServers": {
    "fincobra": {
      "command": "npx",
      "args": ["-y", "github:dexstandard/fincobra-mcp"],
      "env": {
        "FINCOBRA_CHECKOUT_API_KEY": "fc_live_...",
        "FINCOBRA_CHECKOUT_BASE_URL": "https://fincobra.com",
        "FINCOBRA_WATCHLIST_SESSION_TOKEN": "<session-cookie-value>",
        "FINCOBRA_WATCHLIST_BASE_URL": "https://watch.fincobra.com"
      }
    }
  }
}

Claude Code

claude mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

Oder fügen Sie dasselbe mcpServers-Objekt zu .mcp.json / ~/.claude.json hinzu.

Codex

codex mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

Oder in ~/.codex/config.toml:

[mcp_servers.fincobra]
command = "npx"
args = ["-y", "github:dexstandard/fincobra-mcp"]

[mcp_servers.fincobra.env]
FINCOBRA_CHECKOUT_API_KEY = "fc_live_..."
FINCOBRA_WATCHLIST_SESSION_TOKEN = "<session-cookie-value>"

Lokal ausführen

npm install
FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm start

Der Prozess spricht MCP über stdio. Schreiben Sie keine Anwendungsprotokolle nach stdout.

Smoke-Test

FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm run smoke

Unit-Tests mocken die APIs und benötigen keine Anmeldedaten:

npm test

Authentifizierung

Kopieren Sie das Watchlist-session-Cookie aus einem angemeldeten Browser (DevTools → Application → Cookies). Bewahren Sie Schlüssel und Session-Tokens in der MCP-Server-Umgebung auf, nicht im Chat.

API

Checkout:

• POST /api/checkout/invoices

• GET /api/checkout/invoices/:id

• Authentifizierung: X-Api-Key

Watchlist:

• GET /api/watchlist/wallets

• GET /api/watchlist/exchanges

• GET /api/watchlist/manual-assets

• GET /api/watchlist/fx-rates

• Authentifizierung: Cookie: session=...

Senden Sie den Zahlenden an paymentUrl. Behandeln Sie confirmed und paid_out_of_band als bezahlt. Behandeln Sie payment_detected als ausstehend, es sei denn, Sie akzeptieren unbestätigte Krypto-Zahlungen.

Lizenz

MIT