MCP-Server für die Buchhaltung

Der einfachste Weg: Claude in vier Schritten

Ohne Technikkenntnisse — die technischen Wege stehen weiter unten.

• 1. Claude installieren: Laden Sie die Claude-App für Mac oder Windows von claude.ai/download, installieren Sie sie und melden Sie sich an.
• 2. Schlüssel erstellen: In Ihrer Buchhaltung bei jahresabschluss.io: „KI-Agent & API“ → „Neuer Schlüssel“. Soll Claude buchen, setzen Sie den Haken bei „Buchen“. Erstellen und kopieren — der Schlüssel ist wie ein Passwort für Claude und gilt nur für Ihre Gesellschaft.
• 3. Buchhaltung verbinden: „Buchhaltung für Claude“ herunterladen und die Datei im Ordner „Downloads“ doppelklicken. Claude fragt nach dem Schlüssel: einfügen und auf „Installieren“ klicken. Sonst ist nichts zu installieren.
• 4. Loslegen: Schreiben Sie Claude: „Buche die neuen Belege im Belegeingang.“ Claude fragt um Erlaubnis und bucht dann in Ihrem Journal.

Claude fragt um Erlaubnis, bevor es Ihre Buchhaltung benutzt, und vor Rechnungen, Stornos und dem Festschreiben noch einmal ausdrücklich. Jede Buchung steht im echten Journal — mit denselben Prüfungen wie in der App. Für Technik-Erfahrene gehen auch Claude Code und Codex.

„Buchhaltung für Claude“ herunterladen: https://jahresabschluss.io/downloads/buchhaltung-fuer-claude.mcpb

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.

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 Einstellungen → „KI-Agent & API“.

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

Claude Desktop und andere lokal startende Clients

Manche Clients starten MCP-Server nur als lokalen Befehl über stdio. Sie erreichen den gehosteten Server über die veröffentlichte Brücke mcp-remote. Für Claude Desktop gibt es eine fertige Brücke als Erweiterung „Buchhaltung für Claude“, per Doppelklick installiert und ohne Node.js; von Hand tragen Sie in die Datei claude_desktop_config.json unter mcpServers einen Eintrag wie unten ein und setzen für $MCP_URL die Adresse aus der App ein. Der Schlüssel steht im env-Block, nicht in den Argumenten. Jeder Weg führt über die gehostete Variante.

{
  "mcpServers": {
    "buchhaltung": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "$MCP_URL",
        "--header", "Authorization:${JAB_AUTH}"],
      "env": { "JAB_AUTH": "Bearer jab_live_…" }
    }
  }
}

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 braucht der Schlüssel zusätzlich write, für den Rechnungsversand send und für die Festschreibung finalize.

• Lesen: Stammdaten und Einstellungen der Firma, Wirtschaftsjahre samt Status, Kontenrahmen (SKR03/SKR04 sowie eigene Konten), Journal, Saldenliste mit HGB-Zuordnung, offene Posten, Ausgangs- und Eingangsrechnungen, Zahlungen, Belege samt Buchungsvorschlag, Bankkonten und Bankumsätze, Anlagen, Kassenbuch, Rückstellungen, Abgrenzungen, die Kennzahlen der Umsatzsteuer-Voranmeldung, den Festschreibungsstand, Exporte, Steuermeldungen mit Übermittlungsstand sowie den Stand des Jahresabschlusses mit ausgestellten Abschlüssen und Offenlegungsdateien.
• Schreiben (Scope write): buchen und stornieren, Buchungsstapel importieren, Ausgangsrechnungen ausstellen, Eingangsrechnungen buchen, Zahlungen erfassen, Belege einliefern und buchen, Bankumsätze buchen und zuordnen, Kasse, Anlagen, Rückstellungen und Abgrenzungen buchen, Stammdaten pflegen, Eröffnungswerte aus dem Vorjahr vortragen, die Saldenliste an den Jahresabschluss übergeben, Steuermeldungen amtlich prüfen und ihre Übermittlung vorbereiten. Den Versand einer Rechnung erlaubt erst der Scope send, das Festschreiben eines Zeitraums erst finalize; gesendet an ELSTER wird über den Freigabe-Link in der App.
• 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 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.
• 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 → Einstellungen → „KI-Agent & API“) und einen MCP-fähigen Client wie Claude Code, Claude Desktop oder Codex. 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 der Weg für alle Programme. Programme, die MCP-Server nur als lokalen Befehl starten, verbinden sich über die Brücke mcp-remote mit derselben URL; für Claude Desktop gibt es diese Brücke als Erweiterung „Buchhaltung für Claude“. Ein eigenes lokales Paket brauchen Sie nicht.

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. Den Jahresabschluss, den Anhang und die E-Bilanz erstellen Sie in der App. Über den Server übergibt der Agent die Saldenliste an das Jahresabschluss-Modul (publish_trial_balance), liest ausgestellte Abschlüsse und prüft Steuermeldungen — auch die E-Bilanz — amtlich; übermittelt wird über den Freigabe-Link in der App.

Wie sperre ich den Zugang wieder?

Unter Einstellungen → „KI-Agent & API“ 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.