Buchhaltung mit Claude Code verbinden

Warum Claude Code und die Buchhaltung gut zusammenpassen

Claude Code lebt im Terminal, wo ohnehin Skripte, Exporte und Auswertungen entstehen. Über MCP bekommt der Agent Ihre echten Zahlen in denselben Ablauf — ohne Copy-and-paste aus einer anderen Software.

MCP-Server in Claude Code hinzufügen

So binden Sie die Buchhaltung über die gehostete Variante an. $MCP_URL und Ihren Schlüssel mit dem Präfix jab_live_ finden Sie in der App unter Einstellungen → „KI-Agent & API“; setzen Sie beide in den Befehl ein.

claude mcp add --transport http --scope user buchhaltung \
  "$MCP_URL" --header "Authorization: Bearer jab_live_…"

Beispiel-Prompts für den Alltag

Sobald der Server steht, arbeiten Sie in ganzen Sätzen. Der Agent übersetzt Ihr Anliegen in die passenden Werkzeugaufrufe und gibt Ihnen strukturierte Ergebnisse zurück.

• "Gib mir die Saldenliste 2024" — der Agent ruft die Saldenliste für das Wirtschaftsjahr ab, inklusive der HGB-Zuordnung je Konto.
• "Zeig mir alle offenen Eingangsrechnungen" — er liest die offenen Posten aus den Kreditoren und listet Betrag und Fälligkeit.
• "Buche die offenen Eingangsrechnungen" — mit write-Scope erfasst er die Rechnungen samt Vorsteuer über den regulären Buchungskern.
• "Welche Bankumsätze im Dezember sind noch nicht zugeordnet?" — er zieht die Bankzeilen und stellt die offenen Positionen zusammen.

read, write, send, finalize — Sie entscheiden

Der Scope des Schlüssels bestimmt, was Claude Code darf. Beginnen Sie mit read für Auswertungen, nehmen Sie write dazu, wenn der Agent buchen soll, und vergeben Sie send oder finalize nur, wenn er Rechnungen versenden oder Zeiträume festschreiben soll.

• read: Stammdaten, Wirtschaftsjahre, Kontenrahmen, Journal, Saldenliste, offene Posten, Rechnungen und Bankumsätze lesen.
• read plus write: zusätzlich buchen und stornieren, Ausgangsrechnungen stellen, Eingangsrechnungen, Zahlungen und Belege buchen, Bankumsätze zuordnen sowie Kasse, Anlagen, Rückstellungen und Stammdaten pflegen. Rechnungsversand und Festschreibung verlangen eigene Rechte (send, finalize).
• Ein reiner read-Schlüssel kann niemals buchen — selbst wenn Sie es ausdrücklich verlangen, fehlt dem Agenten das Werkzeug dafür.
• Für einen abgegrenzten Auftrag wählen Sie die kürzeste Laufzeit von 30 Tagen und widerrufen den Schlüssel danach.

GoBD und Grenzen

Auch im Terminal gelten alle Regeln. Claude Code kann über die Anbindung nur das, was die API erlaubt — nicht mehr.

• Jede Buchung läuft durch denselben Kern wie die Oberfläche: append-only, Festschreibung, Storno statt Löschen, Soll gleich Haben.
• Jahresabschluss, Anhang und E-Bilanz erstellt der Agent nicht über die API, das geschieht in der App. Er übergibt die Saldenliste (publish_trial_balance), liest ausgestellte Abschlüsse (get_annual_report) und kann Steuermeldungen einschließlich der E-Bilanz amtlich prüfen und vorbereiten; übermittelt wird über den Freigabe-Link in der App.
• Ein Schlüssel gehört zu genau einer Firma — Claude Code kommt nie an die Daten eines anderen Mandanten.
• Kein SQL, kein freier Query: der Agent bleibt in der festen Endpoint-Liste.

Häufige Fragen

Welchen Client brauche ich für diese Anleitung?

Claude Code, den Agenten fürs Terminal. Der MCP-Server funktioniert genauso mit Claude Desktop; der Anbinde-Befehl ist derselbe, nur läuft er dort über die grafische Konfiguration statt über die Kommandozeile.

Muss ich etwas installieren?

Nein. Sie fügen den gehosteten Server mit einem Befehl über die URL hinzu und setzen Ihren Bearer-Schlüssel in den Header; ein lokales Paket brauchen Sie nicht.

Kann Claude Code wirklich buchen?

Ja, sofern Ihr Schlüssel den Scope read plus write hat. Der Agent legt manuelle Buchungen an, storniert oder erfasst Rechnungen — jeweils über den regulären Buchungskern mit allen GoBD-Prüfungen. Mit einem reinen read-Schlüssel liest er nur.

Sieht der Agent auch alte Wirtschaftsjahre?

Ja. Über die Werkzeuge liest er die Wirtschaftsjahre samt Status und kann die Saldenliste oder das Journal je Jahr abrufen. Schreibende Aktionen unterliegen dabei denselben Festschreibungsregeln wie in der Oberfläche.

Wie stoppe ich den Zugriff schnell?

Unter Einstellungen → „KI-Agent & API“ widerrufen Sie den Schlüssel. Sofort danach kann Claude Code keine Werkzeuge mehr aufrufen. Ihre Buchhaltung bleibt vollständig erhalten; nur die Anbindung ist getrennt.