Cursor mit der Buchhaltung verbinden

Buchhaltungsdaten im Editor

Wer in Cursor an Auswertungen, Importen oder kleinen Werkzeugen arbeitet, muss die Zahlen bisher aus einer anderen Software kopieren. Über MCP liegen sie direkt im Editor — als echte Werte, nicht als Beispiel.

MCP-Server in Cursor hinzufügen

Die Anbindung läuft über die gehostete Variante: Sie tragen den Server in ~/.cursor/mcp.json (für alle Projekte) oder .cursor/mcp.json (nur dieses Projekt) mit url und headers ein. Den Schlüssel mit dem Präfix jab_live_ legen Sie in der App unter Einstellungen → „KI-Agent & API“ an und halten ihn in der Umgebungsvariable JAB_API_KEY, die Cursor über ${env:…} einsetzt.

{
  "mcpServers": {
    "buchhaltung": {
      "url": "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp",
      "headers": { "Authorization": "Bearer ${env:JAB_API_KEY}" }
    }
  }
}

Skripte gegen die REST-API generieren

Neben dem direkten Werkzeugaufruf ist Cursor stark darin, Ihnen Code zu schreiben. Bitten Sie den Editor um ein Skript, das die Saldenliste zieht — es baut den Aufruf gegen $BASIS_URL mit Ihrem Bearer-Schlüssel.

curl -H "Authorization: Bearer jab_live_…" \
  "$BASIS_URL/saldenliste?fiscal_year_id=<id aus GET /fiscal-years>"

Lesen und Buchen aus dem Editor

Was Cursor darf, hängt am Scope. Zum Entwickeln reicht meist ein read-Schlüssel; erst wenn ein Skript wirklich buchen soll, ziehen Sie einen write-Schlüssel nach.

• read: Stammdaten, Wirtschaftsjahre, Kontenrahmen, Journal, Saldenliste, offene Posten, Rechnungen und Bankumsätze lesen.
• read plus write: zusätzlich buchen und stornieren, Ausgangs- und Eingangsrechnungen, Zahlungen, Belege und Bankumsätze erfassen sowie Stammdaten pflegen.
• Ein reiner read-Schlüssel eignet sich ideal für die Entwicklung, weil kein Testlauf versehentlich echte Buchungen erzeugt.
• Kein SQL, kein freier Query: der generierte Code bleibt auf die feste Endpoint-Liste beschränkt.

GoBD und Grenzen im Blick

Auch aus dem Editor heraus gelten alle Regeln. Cursor kann über die Anbindung genau das, was die API erlaubt.

• Schreibende Aufrufe laufen durch den geprüften Buchungskern: append-only, Festschreibung, Storno statt Löschen, Soll gleich Haben.
• Ein Schlüssel gehört zu genau einer Firma; andere Mandanten sind über die Anbindung nicht erreichbar.
• Cursor kann über die API keinen Jahresabschluss, Anhang oder eine E-Bilanz erstellen. Es bereitet die Buchhaltungszahlen vor, liest ausgestellte Abschlüsse und kann Steuermeldungen amtlich prüfen und vorbereiten; übermittelt wird über den Freigabe-Link in der App.
• Schlüssel laufen nach der beim Anlegen gewählten Frist ab (30 Tage, 90 Tage oder ein Jahr), sind jederzeit widerrufbar und werden nur als Hash gespeichert.

Häufige Fragen

Unterstützt Cursor MCP-Server?

Ja. Cursor kann MCP-Server als Quellen einbinden. Sie fügen die Buchhaltung über die gehostete URL hinzu, und der Agent im Editor kennt danach die Werkzeuge, die Ihr Schlüssel freigibt — mit read nur die lesenden, mit write zusätzlich die buchenden.

Wofür ist die Anbindung in Cursor besonders nützlich?

Für alle, die Auswertungen, Importe oder kleine Werkzeuge rund um die Buchhaltung bauen. Sie entwickeln gegen echte Salden statt gegen Platzhalter und lassen sich Skripte generieren, die die REST-Endpoints korrekt aufrufen.

Welchen Scope sollte ich zum Entwickeln wählen?

Für die meiste Entwicklungsarbeit reicht read, weil dann kein Testlauf versehentlich bucht. write ziehen Sie erst nach, wenn ein Skript tatsächlich Buchungen anlegen soll; send und finalize brauchen Sie nur, wenn es Rechnungen versenden oder Zeiträume festschreiben soll. Einen Schlüssel mit mehr Rechten widerrufen Sie nach dem Test.

Kann Cursor Skripte schreiben, die buchen?

Ja, mit einem write-Schlüssel. Cursor generiert dann Code, der die POST-Endpoints aufruft — etwa eine manuelle Buchung oder eine erfasste Eingangsrechnung. Jede dieser Buchungen läuft durch den regulären Buchungskern mit allen GoBD-Prüfungen.

Kann ich den Zugriff aus Cursor jederzeit kappen?

Ja. Unter Einstellungen → „KI-Agent & API“ widerrufen Sie den Schlüssel. Danach kann Cursor weder Werkzeuge aufrufen noch die REST-API erreichen. Ihre Buchhaltung bleibt vollständig; nur die Anbindung ist getrennt.