Claude Desktop mit Ihrer Buchhaltung verbinden

Wie die Verbindung funktioniert

Drei Grundsätze, bevor Sie die Konfigurationsdatei anfassen.

In die claude_desktop_config.json eintragen

Öffnen Sie in Claude Desktop die Einstellungen, wechseln Sie in den Bereich Entwickler und wählen Sie „Konfiguration bearbeiten“. Claude Desktop startet MCP-Server als lokalen Befehl über stdio; einen gehosteten HTTP-Endpoint binden Sie deshalb über mcp-remote ein. Den Schlüssel übergeben Sie im Authorization-Header aus dem env-Block, damit er nicht in den Prozess-Argumenten steht:

{
  "mcpServers": {
    "buchhaltung": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp",
        "--header", "Authorization:${JAB_AUTH}"
      ],
      "env": { "JAB_AUTH": "Bearer jab_live_..." }
    }
  }
}

Speichern Sie die Datei und starten Sie Claude Desktop vollständig neu — die Konfiguration wird nur beim Start eingelesen. Meldet sich der Server „buchhaltung“ danach nicht mit seinen Werkzeugen, prüfen Sie zuerst den Schlüssel, die exakte Schreibweise des Authorization-Headers und ob npx auf Ihrem Rechner verfügbar ist.

mcp-remote ist eine veröffentlichte Brücke, die npx beim ersten Start lädt; der Eintrag oben ist der Weg, der heute funktioniert.

Die 91 Werkzeuge im Überblick

• 43 lesende Werkzeuge liefern Stammdaten, Kontenrahmen, Saldenliste, Buchungsjournal, offene Posten, Ein- und Ausgangsrechnungen, Zahlungen, Belege, Bankumsätze, Anlagen, Kasse, Rückstellungen, Abgrenzungen, die Kennzahlen der Umsatzsteuer-Voranmeldung sowie den Stand von Steuermeldungen und Jahresabschluss.
• 45 schreibende Werkzeuge — nur mit write-Scope — buchen und stornieren, stellen Rechnungen aus, erfassen Zahlungen und Belege, buchen Bankumsätze, Kasse, Anlagen, Rückstellungen und Abgrenzungen, pflegen Stammdaten und prüfen Steuermeldungen amtlich. Je ein weiteres Werkzeug versendet Rechnungen (Scope send) und schreibt Zeiträume fest (Scope finalize); ein drittes übermittelt an ELSTER, sein Recht wird derzeit aber noch nicht vergeben.
• Für reines Nachschlagen genügt ein Schlüssel mit read-Scope; dann sieht der Agent nur die lesenden Werkzeuge und kann nichts verändern.
• Claude Desktop blendet jedes Werkzeug vor dem ersten Aufruf zur Freigabe ein — Sie erteilen die Zustimmung bewusst und behalten besonders bei schreibenden Aktionen die Kontrolle.

GoBD bleibt erzwungen

Schreibende Aufrufe laufen durch denselben Buchungskern wie die manuelle Erfassung in der Anwendung. Es gibt kein Löschen und kein Überschreiben festgeschriebener Buchungen: Korrekturen erfolgen ausschließlich per Storno und Neubuchung, jeder Vorgang bleibt unveränderbar protokolliert (append-only, Festschreibung).

Jeder Buchungssatz muss ausgeglichen sein — Soll gleich Haben. Verstößt eine vom Agenten vorgeschlagene Buchung gegen diese Regel, weist die API sie zurück, bevor etwas gespeichert wird. Ob ein Mensch in der Übersicht oder Claude Desktop im Chat bucht, macht für die Verfahrensdokumentation keinen Unterschied — dieselben Kontrollen greifen.

Was Sie danach im Chat erledigen

Häufige Fragen

Was brauche ich, um Claude Desktop anzubinden?

Einen aktiven Buchhaltungszugang mit einem jab_live_-Schlüssel und eine aktuelle Version von Claude Desktop. Den Schlüssel erzeugen Sie in der Anwendung unter Einstellungen → „KI-Agent & API“ und wählen dort den Scope; eine Anleitung mit der fertigen Konfiguration finden Sie dort unter „KI-Anbindung einrichten“. Anschließend tragen Sie den Server in die claude_desktop_config.json ein und starten Claude Desktop neu.

Wo liegt die claude_desktop_config.json?

Sie müssen den Pfad nicht suchen: In Claude Desktop öffnen die Einstellungen im Bereich Entwickler die Datei direkt über „Konfiguration bearbeiten“. Physisch liegt sie unter macOS im Anwendungsunterstützungs-Ordner von Claude und unter Windows im Claude-Ordner innerhalb von %APPDATA%. Nach jeder Änderung ist ein vollständiger Neustart der Anwendung nötig, da die Konfiguration nur beim Start eingelesen wird.

Warum die gehostete URL statt eines direkten npx-Pakets?

Claude Desktop startet MCP-Server als lokalen Befehl über stdio. Einen gehosteten HTTP-Endpunkt binden Sie deshalb über die Brücke mcp-remote ein und übergeben Ihren Schlüssel im Authorization-Header. So läuft jede Anfrage über denselben Server wie bei allen anderen Programmen; ein eigenes Paket brauchen Sie dafür nicht.

Kann Claude Desktop darüber einen Jahresabschluss oder eine E-Bilanz erstellen?

Nein. E-Bilanz, Jahresabschluss und Steuererklärungen entstehen in der App. Claude Desktop bucht, liest und wertet aus, übergibt am Jahresende die Saldenliste an das Jahresabschluss-Modul und kann Steuermeldungen amtlich prüfen und vorbereiten; übermittelt wird über den Freigabe-Link in der App.

Kann ein Schlüssel auf mehrere Firmen zugreifen?

Nein. Jeder Schlüssel ist genau einer Gesellschaft zugeordnet; die Firma wird aus dem Schlüssel abgeleitet und ist kein Parameter im Aufruf. Für mehrere Mandanten legen Sie je Firma einen eigenen Schlüssel an und tragen sie als getrennte Server-Einträge in Claude Desktop ein.

Ist mein Schlüssel im Chatverlauf sichtbar?

Nein. Der Schlüssel steht in Ihrer lokalen claude_desktop_config.json, nicht im Chat und nicht in den Nachrichten an den Agenten. Behandeln Sie ihn wie ein Passwort, geben Sie ihn nicht weiter und rotieren Sie ihn bei Verdacht. Mit einem reinen read-Scope kann der Agent ohnehin nichts verändern.