Registrieren

Remote MCP verbinden

So verbindest du Cursor, Claude oder andere MCP-Clients mit dem zahls.ch Remote-MCP-Endpoint.

Mit dem Remote MCP von zahls.ch kannst du KI-Clients wie Cursor oder Claude direkt an deine zahls.ch-API anbinden. Die Tools entsprechen den OpenAPI-Operationen und werden serverseitig an die REST-API weitergeleitet.

Marketing-Überblick: Remote MCP.

Voraussetzungen

  1. Ein aktives zahls.ch-Konto
  2. Einen API-Schlüssel im Dashboard unter API und Integrationen
  3. Deinen Instanznamen — der erste Teil deiner URL. Bei beispiel.zahls.ch ist die Instanz beispiel.

Endpoint und Authentifizierung

Endpointhttps://www.zahls.ch/mcp
HeaderX-API-KEY — dein API-Schlüssel
HeaderX-Instance — dein Instanzname (ohne .zahls.ch)

Ohne beide Header antwortet der Endpoint mit 401.

Cursor verbinden

Lege in der Projekt- oder User-Konfiguration einen MCP-Server an (z. B. .cursor/mcp.json oder die Cursor-MCP-Einstellungen):

{
  "mcpServers": {
    "zahls-ch": {
      "url": "https://www.zahls.ch/mcp",
      "headers": {
        "X-API-KEY": "DEIN_API_SCHLUESSEL",
        "X-Instance": "deine-instanz"
      }
    }
  }
}

Ersetze die Platzhalter, speichere die Datei und starte den MCP-Server in Cursor neu. Danach sollten die zahls.ch-Tools in der Tool-Liste erscheinen.

Andere MCP-Clients

Jeder Client, der Remote MCP (HTTP) mit eigenen Request-Headern unterstützt, kann denselben Endpoint nutzen:

  • URL: https://www.zahls.ch/mcp
  • Header X-API-KEY und X-Instance wie oben

Die genaue Konfigurationssyntax hängt vom Client ab — entscheidend sind Endpoint und die beiden Header.

Was die Tools können

Über MCP stehen die dokumentierten API-Operationen als Tools bereit, zum Beispiel:

  • Zahlungslinks erstellen und verwalten
  • Rechnungen und Spenden anlegen
  • Transaktionen und Zahlungsstatus abfragen
  • Abonnemente und Rückerstattungen anstossen

Die genauen Tool-Namen und Parameter kommen aus der OpenAPI-Spezifikation von zahls.ch.

Sichere Nutzung

  • Nutze einen eigenen API-Schlüssel nur für den MCP-Client — so kannst du ihn bei Bedarf rotieren.
  • Kritische Aktionen (hohe Beträge, Rückerstattungen) im Prompt klar einschränken oder manuell bestätigen lassen.
  • Für asynchrone Status-Updates weiterhin Webhooks einrichten — MCP ersetzt Polling nicht in allen Fällen.

Weiterführend

Verwandte Themen