Die Erweiterung „Buchhaltung für Claude“ für die Claude-App auf Mac und Windows

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 in der Datei steckt

Eine .mcpb-Datei ist laut Dokumentation des Herstellers ein ZIP-Archiv mit einem lokalen MCP-Server und einer manifest.json. Unsere ist rund 10 KB groß und enthält drei Teile:

Installation: vom Schlüssel bis zum ersten Satz

• Schlüssel anlegen: in der App unter Buchhaltung → Einstellungen → „KI-Agent & API“ → „Neuer Schlüssel“. Soll Claude buchen, setzen Sie den Haken bei „Buchen“; für reine Auswertungen genügt Lesen. Der Schlüssel erscheint nur dieses eine Mal — gleich kopieren.
• Datei laden: über „Buchhaltung für Claude herunterladen“ direkt am frisch angezeigten Schlüssel oder unter jahresabschluss.io/downloads/buchhaltung-fuer-claude.mcpb.
• Öffnen: Doppelklick auf die Datei. Laut Herstellerdokumentation können Sie sie auch ins Fenster der Claude-App ziehen oder unter „Settings > Extensions > Advanced settings > Install Extension…“ auswählen.
• Installationsfenster: Die App zeigt Name und Beschreibung der Erweiterung und fragt nach „Ihr Schlüssel“. Einfügen und die Installation bestätigen („Installieren“, in der englischen Oberfläche „Install“). Ein mitkopiertes Leerzeichen oder ein vorangestelltes „Bearer“ entfernt die Brücke selbst.
• Ausprobieren: In einem neuen Chat fragen Sie „Wie heißt die verbundene Gesellschaft, und liegen Belege im Belegeingang?“. Claude ruft get_entity und list_receipts auf, sobald Sie es erlauben.

Wo der Schlüssel liegt

Das Feld „Ihr Schlüssel“ ist in der manifest.json als vertraulich markiert. Solche Werte speichert die Claude-App laut Herstellerhilfe verschlüsselt im sicheren Speicher des Betriebssystems: unter macOS im Schlüsselbund, unter Windows in der Anmeldeinformationsverwaltung. In einer Textdatei wie claude_desktop_config.json steht er nicht.

Beim Start übergibt die App den Schlüssel der Brücke als Umgebungsvariable JAB_API_KEY, nicht als Argument im Startbefehl. Bei uns kommt er als Kopfzeile Authorization: Bearer an; gespeichert wird von ihm nur ein Hash. In den Chat gehört er nie — der Server weist Claude ausdrücklich an, ihn in kein Feld und keine Nachricht zu schreiben.

Belege direkt vom Rechner einliefern

Das ist der praktische Unterschied zum Konnektor im Browser: In der Erweiterung nimmt upload_receipt zusätzlich einen Dateipfad an. Ein Beispiel mit erfundenen Werten (SKR03):

Sie:    Liefere /Users/ihrname/Downloads/telefon-oktober.pdf als
        Eingangsbeleg ein und zeig mir den Buchungsvorschlag.

Claude: upload_receipt        file_path=/Users/ihrname/Downloads/telefon-oktober.pdf
        get_receipt_proposal  Soll 4920 Telefon 40,00 €
                              Soll 1576 Vorsteuer 19 % 7,60 €
                              Haben Kreditor 47,60 €
                              (sobald die Belegerkennung fertig ist)
        Soll ich so buchen?

Die Brücke liest die Datei auf Ihrem Rechner — PDF, PNG, JPEG, WebP oder XML, bis 20 MB — und schickt sie mit Ihrem Schlüssel an uns. Claude sieht dabei nur den Pfad, nicht den Inhalt. Ist die Nachricht größer als 10 MB, geht der Beleg direkt an die REST-API.

Im Belegeingang liest die App E-Rechnungen im XML-Format ohne KI, alle anderen Belege mit ihrer Belegerkennung; das zählt zum Kontingent der KI-erkannten Belege. Eindeutige Belege bucht der Autopilot, die übrigen warten auf Ihre Prüfung. Den Ordner auf Ihrem Rechner kennt Claude nicht von selbst — nennen Sie den vollständigen Pfad, unter macOS beginnend mit /Users/, unter Windows etwa mit C:\Users\.

Verlängern, Schlüssel tauschen, neue Version

• Schlüssel läuft ab: Unter „KI-Agent & API“ klicken Sie beim Schlüssel auf „Verlängern“. Kennung, Rechte und Webhooks bleiben gleich, die Erweiterung läuft ohne Änderung weiter.
• Andere Rechte oder andere Gesellschaft: Legen Sie einen neuen Schlüssel an. Für Felder aus der manifest.json erzeugt die Claude-App laut Herstellerdokumentation eine Einstellungsseite der Erweiterung; dort tragen Sie den neuen Schlüssel ein und widerrufen danach den alten.
• Neue Version der Datei: Erweiterungen, die nicht aus dem Verzeichnis des Herstellers stammen, aktualisieren sich laut Herstellerhilfe nicht selbst. Eine neue .mcpb installieren Sie wie die erste. Neue Werkzeuge des Servers erscheinen dagegen ohne neue Datei, weil die Brücke den Katalog jedes Mal vom Server holt.
• Verwalten: Nach der Installation erscheint die Erweiterung in den Einstellungen der Claude-App in der Liste der Erweiterungen; die Hilfeseiten des Herstellers beschreiben den Menüweg dorthin unterschiedlich. Der sichere Schnitt ist der Widerruf des Schlüssels — ohne gültigen Schlüssel erreicht die Erweiterung nichts mehr.

Erweiterung oder Konnektor?

Grenzen — und was bei Ihnen bleibt

• Nur macOS und Windows: Für diese beiden Systeme ist die Erweiterung freigegeben. Auf Telefon und Tablet nutzen Sie den Konnektor.
• In Team- und Enterprise-Organisationen können die Inhaber Erweiterungen laut Herstellerhilfe abschalten oder auf eine Auswahl beschränken. Fehlt der Bereich für Erweiterungen in Ihren Einstellungen, ist er abgeschaltet — dann bleibt der Konnektor.
• Ein Schlüssel, eine Gesellschaft. Wer mehrere Gesellschaften gleichzeitig in der Claude-App braucht, findet in der Anleitung der App unter „Andere Wege“ die Einrichtung von Hand mit je einem Eintrag pro Gesellschaft.
• Fachlich prüft die Brücke nichts. Soll gleich Haben, Storno statt Löschen, die Sperre festgeschriebener Zeiträume und die Dublettenprüfung erzwingt der Server, gleich auf welchem Weg ein Aufruf ankommt.
• Steuermeldungen prüft und bereitet Claude vor; übermittelt wird über den Freigabe-Link in der App mit Ihrer PIN, die nie in den Chat gehört.
• Freigaben bleiben bei Ihnen: Lassen Sie Buchen, Rechnungen und Stornos in der Claude-App vor jedem Aufruf bestätigen.

Häufige Fragen

Brauche ich Node.js für die Erweiterung?

Nein. Laut Hersteller bringt die Claude-App für macOS und Windows ein eigenes Node.js mit und startet die Erweiterung damit. Sie installieren nur die .mcpb-Datei.

Wo bekomme ich die Datei buchhaltung-fuer-claude.mcpb?

Unter jahresabschluss.io/downloads/buchhaltung-fuer-claude.mcpb und in der App direkt neben einem frisch erstellten Schlüssel.

Steht mein Schlüssel in einer Datei auf dem Rechner?

Nicht in einer Textdatei. Vertrauliche Felder einer Erweiterung legt die Claude-App laut Herstellerhilfe verschlüsselt im Schlüsselbund (macOS) beziehungsweise in der Anmeldeinformationsverwaltung (Windows) ab.

Was passiert, wenn der Schlüssel abläuft?

Claudes Aufrufe scheitern dann mit einem Anmeldefehler. Verlängern Sie den Schlüssel unter „KI-Agent & API“; an der Erweiterung ändern Sie nichts.

Kann Claude mit der Erweiterung Zeiträume festschreiben?

Nur wenn der Schlüssel das Recht „Zeiträume festschreiben“ trägt. Der Server schreibt Claude für diesen Schritt vor, zuerst Ihr ausdrückliches Ja samt Stichtag einzuholen. Für den Alltag genügt ein Schlüssel ohne dieses Recht.

Läuft die Erweiterung auf dem iPad oder dem Telefon?

Nein, sie ist für die Claude-App auf Mac und Windows gebaut. Auf mobilen Geräten verbinden Sie Claude über den Konnektor mit der Adresse https://jahresabschluss.io/mcp.