MCP oder REST-API
MCP-Server oder REST-API — was wählen?
Ob KI-Agent oder eigenes System: Für die Anbindung Ihrer Buchhaltung stehen zwei Zugänge bereit. Der MCP-Server ist der direkte Weg für KI-Clients wie Claude Code, Claude Desktop oder Cursor; die REST-API der klassische Weg für eigene Skripte, ERP-Systeme und geplante Abläufe. Beide sprechen denselben Buchungskern an — gleicher Schlüssel, gleiche Scopes, gleiche GoBD-Regeln. Diese Seite zeigt, wann welcher Zugang der richtige ist — und warum Sie sich nicht dauerhaft festlegen müssen.
Zwei Zugänge, ein Buchungskern
MCP und REST sind auf der Datenebene kein Entweder-oder — sie sind zwei Türen zum selben Raum.
MCP-Server: Adapter für KI-Clients
Der MCP-Server ist ein schlanker Adapter über der REST-API. Er meldet Ihrem KI-Client 14 klar benannte Werkzeuge, die dieser von sich aus aufrufen kann — ohne dass Sie Endpunkte, Parameter oder JSON von Hand zusammenbauen. Der Agent bleibt dabei Ihr Werkzeug; er ist kein Bestandteil unserer Software.
REST-API: direkte HTTP-Schnittstelle
Die REST-API spricht jedes System an, das HTTP beherrscht: eigene Skripte, ein ERP, ein Shop-Backend oder eine No-Code-Software. Sie rufen Endpunkte mit einem Bearer-Schlüssel auf und erhalten JSON zurück — volle Kontrolle über jeden einzelnen Aufruf.
Ein Schlüssel, eine Firma
Beide Wege nutzen denselben Schlüssel mit dem Präfix jab_live_. Die Gesellschaft wird aus dem Schlüssel abgeleitet, nicht als Parameter übergeben — ein Schlüssel gehört zu genau einer Firma. Das schließt Verwechslungen zwischen Mandanten aus.
Wann der MCP-Server passt
Immer dann, wenn am anderen Ende ein KI-Client sitzt, der selbst Werkzeuge aufrufen soll.
- Sie arbeiten in einem KI-Client wie Claude Code, Claude Desktop, Cursor oder einem MCP-fähigen Chat und wollen die Buchhaltung im Dialog abfragen und bebuchen.
- Sie möchten in natürlicher Sprache formulieren ("Zeig mir die offenen Posten über 30 Tage"), statt Endpunkte und Parameter zu kennen.
- Der Agent soll selbst entscheiden, welches der 14 Werkzeuge er für eine Aufgabe braucht — Sie geben das Ziel vor, nicht den einzelnen Aufruf.
- Sie wollen ohne eigenen Programmcode starten: ein Befehl fügt den gehosteten Server hinzu, der Schlüssel steht im Authorization-Header.
- Interaktive, explorative Arbeit steht im Vordergrund — nicht ein starr geplanter, wiederkehrender Ablauf.
Wann die REST-API passt
Immer dann, wenn Ihr eigener Code oder eine Automatisierungs-Software den Aufruf auslöst.
Geplante, wiederkehrende Abläufe
Ein nächtlicher Cron-Job zieht die Saldenliste, ein Skript bucht Bankumsätze im Stapel: Für deterministische, wiederkehrende Aufgaben ohne KI im Loop ist die REST-API der direkte Weg.
Eigene Systeme und Backends
Ihr Shop-System, Ihr ERP oder Ihre selbst gebaute Software spricht HTTP — nicht MCP. Die REST-API bindet diese Systeme ohne Umweg an und liefert JSON, das Sie weiterverarbeiten.
Automatisierungen und No-Code
Plattformen wie n8n, Zapier oder Make rufen die REST-API über ihren HTTP-Baustein auf. Auch LangChain oder ein eigenes Agenten-Framework sprechen die API direkt an, wenn sie MCP nicht nutzen.
Entscheidung in 30 Sekunden
Faustregel: Sitzt am anderen Ende ein KI-Client, der von sich aus Werkzeuge aufrufen soll, nehmen Sie den MCP-Server. Sitzt dort Ihr eigener Code oder eine Automatisierungs-Software, nehmen Sie die REST-API. Der Unterschied ist die Kontrolle: Beim MCP-Server wählt der Agent das passende Werkzeug, bei der REST-API bestimmen Sie jeden Aufruf selbst.
Sie müssen sich nicht festlegen. Beide Zugänge laufen parallel über denselben Schlüssel — Sie können morgens im Chat mit dem MCP-Server arbeiten und nachts einen REST-Job laufen lassen, ohne etwas zu duplizieren.
Ein praktischer Hinweis zum MCP-Server: Das npm-Paket @jahresabschluss/buchhaltung-mcp ist noch nicht veröffentlicht. Der verlässliche Weg ist deshalb die gehostete Variante, die Sie per URL einbinden — kein lokaler Installationsschritt nötig.
So sieht der Zugang aus
Oben der MCP-Server per URL, unten derselbe Lesezugriff über die REST-API — beide mit demselben Schlüssel.
# MCP-Server (gehostet) in Claude Code hinzufügen claude mcp add --transport http buchhaltung \ "$MCP_URL" --header "Authorization: Bearer jab_live_…" # Derselbe Lesezugriff direkt über die REST-API curl -H "Authorization: Bearer jab_live_…" \ "$API_URL/saldenliste?jahr=2025"
Gleiche Rechte, gleiche GoBD-Regeln
- 10 lesende Werkzeuge: Stammdaten, Saldenliste, Buchungsjournal, offene Posten, Eingangs- und Ausgangsrechnungen, Bankumsätze, Kontenrahmen und mehr.
- 4 schreibende Werkzeuge (nur mit Schreib-Scope): u. a. Buchung anlegen, Buchung stornieren und Rechnung erstellen.
- Die 14 Werkzeuge des MCP-Servers bilden dieselben Fähigkeiten ab, die die REST-API als Endpunkte bereitstellt.
Egal welchen Zugang Sie wählen: Die Rechte hängen am Schlüssel, nicht am Weg. Ein Schlüssel trägt einen Lese- und optional einen Schreib-Scope. Ohne Schreibrecht kann weder der MCP-Server noch ein REST-Aufruf eine Buchung anlegen — der Zugriff bleibt read-only.
Auch die Buchungsregeln sind für beide identisch, weil jeder schreibende Aufruf durch denselben Buchungskern läuft. Gebucht wird append-only: Festgeschriebenes wird nicht gelöscht und nicht überschrieben, eine Korrektur erfolgt per Storno, und jede Buchung muss ausgeglichen sein (Soll = Haben). So bleibt die Nachvollziehbarkeit nach GoBD gewahrt — unabhängig davon, ob ein KI-Agent oder ein Skript den Aufruf ausgelöst hat.
Häufige Fragen
MCP-Server oder REST-API — was ist schneller eingerichtet?
Für die Arbeit in einem KI-Client ist der MCP-Server schneller: ein Befehl fügt den gehosteten Server hinzu, der Schlüssel steht im Authorization-Header, fertig. Für ein eigenes System ist die REST-API der direkte Weg — ein curl-Aufruf mit Bearer-Schlüssel genügt, um Daten zu lesen. Welcher Weg schneller ist, hängt also davon ab, wer am anderen Ende sitzt.
Kann ich beide gleichzeitig nutzen?
Ja. Beide Zugänge laufen parallel über denselben jab_live_-Schlüssel und greifen auf denselben Buchungskern zu. Sie können interaktiv per MCP-Server im Chat arbeiten und zusätzlich einen nächtlichen REST-Job laufen lassen, ohne Daten oder Logik zu duplizieren.
Kann ich über die API oder den MCP-Server einen Jahresabschluss oder eine E-Bilanz erstellen?
Nein. Beide Zugänge arbeiten ausschließlich mit Buchhaltungsdaten — Buchungen, Salden, offene Posten, Rechnungen. Sie bereiten damit die Zahlen vor, aus denen später in der App ein Jahresabschluss oder eine E-Bilanz entsteht. Die Erstellung und Übermittlung dieser Abschlüsse sowie Steuererklärungen erfolgt in der Anwendung selbst, nicht per API oder MCP.
Brauche ich für den MCP-Server das npm-Paket?
Nein. Das Paket @jahresabschluss/buchhaltung-mcp ist derzeit noch nicht veröffentlicht. Der verlässliche Weg ist die gehostete Variante, die Sie per URL einbinden — ein Installationsschritt auf Ihrem Rechner entfällt, Sie brauchen nur die URL und Ihren Bearer-Schlüssel.
Ist mein KI-Agent Teil Ihrer Software?
Nein. Der Agent — ob Claude Code, Claude Desktop, Cursor oder ein anderer Client — ist Ihr eigenes Werkzeug. Unsere Software stellt lediglich die Buchhaltung als MCP-Server und als REST-API bereit; der Agent verbindet sich damit über Ihren Schlüssel und Ihre Scopes.
Unterscheiden sich die Rechte je nach Zugang?
Nein. Die Rechte hängen am Schlüssel, nicht am Zugangsweg. Ein Schlüssel ohne Schreib-Scope bleibt read-only — über den MCP-Server genauso wie über die REST-API. Und die GoBD-Regeln (append-only, Festschreibung, Storno statt Löschen, Soll = Haben) gelten für jeden schreibenden Aufruf gleichermaßen.