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 und übergeben den Schlüssel im Authorization-Header:

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.

Sobald das npm-Paket erscheint, ersetzt ein direkter npx-Eintrag ohne mcp-remote diese Variante — die Konfiguration wird dann noch kürzer, und der Schlüssel wandert aus den args in einen env-Block.

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

Die 14 Werkzeuge im Überblick

• Zehn lesende Werkzeuge liefern Stammdaten, Kontenrahmen, Saldenliste und BWA, Buchungsjournal, offene Posten sowie Ein- und Ausgangsrechnungen und Bankumsätze.
• Vier schreibende Werkzeuge — nur mit write-Scope — erfassen Buchungssätze, stornieren Buchungen, legen Ausgangsrechnungen an und verbuchen Bankbewegungen.
• Für reines Nachschlagen genügt ein Schlüssel mit read-Scope; ohne write-Scope nutzt der Agent die zehn lesenden Werkzeuge, kann aber 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 API-Zugang und wählen dort read- oder write-Scope. 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?

Zum einen ist das npm-Paket @jahresabschluss/buchhaltung-mcp noch nicht veröffentlicht. Zum anderen startet Claude Desktop MCP-Server als lokalen Befehl über stdio; einen gehosteten HTTP-Endpoint binden Sie deshalb über mcp-remote ein und übergeben Ihren Schlüssel im Authorization-Header. Sobald das Paket erscheint, genügt ein direkter npx-Eintrag ohne diese Brücke.

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

Nein. Die API und der MCP-Server arbeiten ausschließlich mit Buchhaltungsdaten: buchen, lesen, auswerten. Sie können damit die Zahlen sauber vorbereiten, aber E-Bilanz, Jahresabschluss und Steuererklärung entstehen bewusst in der Anwendung selbst und werden nicht über die API erzeugt oder übermittelt.

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.