Claude Desktop mit Ihrer Buchhaltung verbinden

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

Wie die Verbindung funktioniert

Drei Grundsätze, bevor Sie Claude Desktop verbinden.

Erweiterung installieren oder die claude_desktop_config.json eintragen

Am einfachsten installieren Sie die Erweiterung „Buchhaltung für Claude“: Datei herunterladen und doppelklicken, Claude Desktop fragt nach dem Schlüssel — einfügen und „Installieren“ wählen. Claude Desktop startet die Brücke dann mit seinem eingebauten Node.js und legt den Schlüssel im Schlüsselbund des Rechners ab. Von Hand öffnen Sie in Claude Desktop die Einstellungen, wechseln in den Bereich Entwickler und wählen „Konfiguration bearbeiten“. Dort startet Claude Desktop 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; dafür muss Node.js installiert sein. Der Eintrag von Hand bietet sich an, wenn Sie mehrere Gesellschaften als getrennte Server eintragen. Ganz ohne Schlüssel verbinden Sie claude.ai im Browser und die Claude-App auf dem Telefon: In claude.ai unter „Einstellungen“ → „Konnektoren“ die Adresse https://jahresabschluss.io/mcp als eigenen Konnektor hinzufügen und nach der Anmeldung bei jahresabschluss.io Gesellschaft, Rechte und Gültigkeit wählen.

Die 94 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.
• 48 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 installieren Sie die Erweiterung „Buchhaltung für Claude“ per Doppelklick und fügen den Schlüssel ein — oder tragen den Server von Hand 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?

Die gehostete URL ist der eine Server für alle Programme. Claude Desktop erreicht ihn über eine Brücke: am einfachsten über die Erweiterung „Buchhaltung für Claude“, die Claude Desktop mit eigenem Node.js startet, oder von Hand über mcp-remote mit Ihrem 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. Mit der Erweiterung legt Claude Desktop den Schlüssel im Schlüsselbund des Rechners ab, beim Eintrag von Hand steht er in Ihrer lokalen claude_desktop_config.json — nie 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.