MCP-Server einrichten

MCP-Server für die Buchhaltung

Der MCP-Server macht Ihre Buchhaltung zu einer Quelle, die ein KI-Agent direkt abfragen und bebuchen kann. Er ist ein schlanker Adapter über dieselbe REST-API — gleicher Schlüssel, gleiche Scopes, gleiche GoBD-Regeln. Die gehostete Variante per URL ist sofort einsatzbereit, ganz ohne Installation. In wenigen Minuten spricht Claude Code oder Claude Desktop mit Ihrem echten Kontenwerk, zieht die Saldenliste und bucht auf Wunsch offene Posten.

Was der MCP-Server macht

Das Model Context Protocol beschreibt, wie ein KI-Agent externe Werkzeuge entdeckt und aufruft. Unser MCP-Server stellt Ihre Buchhaltung als solche Werkzeugquelle bereit — ohne dass der Agent freien Zugriff auf Ihre Datenbank bekommt.

Adapter über die REST-API

Der MCP-Server ruft im Hintergrund exakt dieselben Endpoints wie die öffentliche REST-API auf. Es gibt keinen zweiten Datenpfad und keine Sonderrechte: gleicher Bearer-Schlüssel, gleiche Scopes, dieselben Prüfungen. Was die API nicht kann, kann der MCP-Server auch nicht.

Ein Schlüssel, eine Firma

Die Gesellschaft wird aus dem Schlüssel abgeleitet, nie aus einem Parameter der Anfrage. Ein Agent mit Ihrem Schlüssel sieht genau eine Firma und kommt niemals an die Daten eines anderen Mandanten. Das gilt für jedes einzelne Werkzeug.

14 Werkzeuge

Der Server stellt 14 Werkzeuge bereit — 10 lesende und 4 schreibende. Der Agent ruft sie gezielt auf, statt frei im Datenbestand zu suchen. Jedes Werkzeug entspricht einem festen Endpoint mit klarem Zweck.

Gehostet per URL hinzufügen (sofort startklar)

Die gehostete Variante läuft ohne Installation. Sie fügen den Server mit einem einzigen Befehl hinzu und hinterlegen Ihren Bearer-Schlüssel im Header. Die konkrete Adresse $MCP_URL und den Schlüssel finden Sie in der App unter API-Zugang.

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

Lokale Variante per npx

Für eine lokale Node-Anbindung per stdio sieht der Befehl so aus. Wichtiger Hinweis: das npm-Paket ist noch nicht veröffentlicht — bis dahin ist die gehostete Variante oben der verlässliche Weg. Für Claude Desktop tragen Sie denselben npx-Aufruf mit dem Schlüssel als Umgebungsvariable JAB_API_KEY in die Datei claude_desktop_config.json unter mcpServers ein.

claude mcp add buchhaltung --env JAB_API_KEY=jab_live_… \
  -- npx -y @jahresabschluss/buchhaltung-mcp

Lesen und Schreiben: die Werkzeuge im Überblick

Welche Werkzeuge zur Verfügung stehen, hängt am Scope Ihres Schlüssels. Ein reiner read-Schlüssel gibt dem Agenten nur Lesezugriff; für Buchungen brauchen Sie einen Schlüssel mit read und write.

  • Lesen: Stammdaten der Firma, Wirtschaftsjahre samt Status, Kontenrahmen (SKR03/SKR04 sowie eigene Konten), Journal, Saldenliste mit HGB-Zuordnung, offene Posten aus Debitoren und Kreditoren, Ausgangs- und Eingangsrechnungen sowie Bankumsätze.
  • Schreiben (nur mit Scope read und write): manuelle Buchung mit Konto, Gegenkonto und Steuerschlüssel; Storno statt Löschen; Ausgangsrechnung stellen; Eingangsrechnung erfassen.
  • Ein reiner read-Schlüssel kann niemals buchen — der Agent zieht dann ausschließlich Zahlen und rührt den Datenbestand nicht an.
  • Kein SQL und kein freier Query: der Agent bewegt sich in einer festen Liste von Endpoints, nicht in Ihrer Datenbank.

GoBD bleibt erzwungen

Der MCP-Server ist ein Adapter, kein Umweg an den Regeln vorbei. Schreibende Aufrufe laufen durch denselben Buchungskern wie die Oberfläche und unterliegen denselben Prüfungen.

  • Jede schreibende Anfrage folgt den GoBD-Grundsätzen: append-only, Festschreibung, Storno statt Löschen, Soll gleich Haben.
  • Der Server kann diese Regeln nicht umgehen — eine fehlerhafte Buchung wird abgelehnt, eine bestehende Buchung nie überschrieben.
  • Schlüssel sind zeitlich begrenzbar (etwa 90 Tage, ein Jahr oder unbegrenzt), jederzeit widerrufbar und werden nur als Hash gespeichert.
  • Der Schlüssel wird beim Anlegen genau einmal angezeigt. Geht er verloren, widerrufen Sie ihn und legen einen neuen an — die Buchhaltung selbst bleibt unberührt.

Häufige Fragen

Was brauche ich, um den MCP-Server zu nutzen?

Einen API-Schlüssel mit dem Präfix jab_live_ aus der App (Buchhaltung, Bereich API-Zugang) und einen MCP-fähigen Client wie Claude Code oder Claude Desktop. Für die gehostete Variante ist keine Installation nötig, Sie fügen den Server mit einem Befehl hinzu.

Sollte ich die gehostete oder die lokale Variante wählen?

Die gehostete Variante per URL ist sofort startklar und die empfohlene Standardvariante. Die lokale npx-Variante ist bereits vorgesehen, das npm-Paket ist aber noch nicht veröffentlicht — verlassen Sie sich deshalb heute auf die URL-Anbindung.

Kann der Agent über den Schlüssel meine anderen Firmen sehen?

Nein. Ein Schlüssel gehört zu genau einer Gesellschaft, die aus dem Schlüssel selbst abgeleitet wird und nicht als Parameter mitgegeben werden kann. Fremde Mandanten sind über diese Anbindung technisch nicht erreichbar.

Kann der MCP-Server einen Jahresabschluss erstellen?

Nein. Der Server arbeitet ausschließlich mit Buchhaltungsdaten und Buchungen. Er kann die Zahlen vorbereiten, die später in der App zum Jahresabschluss werden — den Abschluss, den Anhang oder eine E-Bilanz erstellt er nicht über die Anbindung.

Wie sperre ich den Zugang wieder?

In der App unter API-Zugang widerrufen Sie den Schlüssel jederzeit mit einem Klick. Danach ist die Anbindung sofort wirkungslos, und Sie können bei Bedarf einen neuen Schlüssel mit passendem Scope anlegen.