ChatGPT mit der Buchhaltung verbinden: der Konnektor Schritt für Schritt

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 Sie vorher brauchen

Zwei Seiten müssen mitspielen: Ihr ChatGPT-Konto und Ihre Gesellschaft bei jahresabschluss.io.

• ChatGPT im Web. Die Entwicklerdokumentation von OpenAI beschreibt das Anlegen eigener MCP-Server für ChatGPT im Browser.
• Einen ChatGPT-Tarif, der eigene MCP-Server zulässt. Laut Hilfe-Center von OpenAI (Stand 30.10.2026) gibt es eigene MCP-Server mit vollem Umfang, also auch mit schreibenden Aktionen, für ChatGPT Business, Enterprise und Edu im Web; Pro-Konten verbinden eigene Server danach nur lesend. In Firmen-Arbeitsbereichen gelten zusätzlich die Richtlinien Ihrer Administration. Den aktuellen Stand nennt das Hilfe-Center von OpenAI.
• Eine Gesellschaft mit Buchhaltungs- oder EÜR-Abo. Nutzt sie nur das Steuer-Modul, erreicht ChatGPT ausschließlich die Steuerwerkzeuge und die Stammdaten.
• Ihre Rolle im Arbeitsbereich: Administrator oder „Buchhaltung (Ersteller)“ — nur diese beiden Rollen dürfen den Zugang erlauben.
• Einen eingerichteten zweiten Faktor. Mit ihm bestätigen Sie die Freigabe, genau wie beim Anlegen eines Schlüssels von Hand.

Schritt 1: den Konnektor in ChatGPT anlegen

So steht der Weg in der englischsprachigen Entwicklerdokumentation von OpenAI (Stand 30.10.2026):

Bereich in ChatGPT:   Plugins  →  „+“  →  Add custom MCP server
Name:                 Buchhaltung   (frei wählbar)
Connection (URL):     https://jahresabschluss.io/mcp
Authentication:       OAuth
Danach:               Risikohinweis lesen → „I understand and want to continue“
                      → „Create as a plugin“

Die Bezeichnungen dieses Bereichs hat OpenAI in den vergangenen Monaten mehrfach geändert — ältere Hilfeartikel sprechen vom „Entwicklermodus“ und von Konnektoren oder Apps; je nach Konto und Sprache kann der Menüpunkt anders heißen. Maßgeblich sind zwei Angaben: die Adresse https://jahresabschluss.io/mcp und als Anmeldung OAuth. Eine Client-ID müssen Sie bei uns nicht anlegen — unser Server nimmt die Anmeldung eines Programms nach dem OAuth-Standard selbst entgegen.

Den Risikohinweis zeigt ChatGPT beim Anlegen eines eigenen Servers. In seiner Entwicklerdokumentation rät OpenAI, nur Server zu verbinden, denen Sie vertrauen, und warnt, dass fehlerhafte Schreibaktionen Daten verändern, löschen oder weitergeben können. Genau deshalb fragt ChatGPT vor schreibenden Werkzeugen nach — dazu weiter unten mehr.

Schritt 2: anmelden und auf der Freigabeseite erlauben

Beim ersten Verbinden leitet ChatGPT Sie zu jahresabschluss.io weiter. Sie melden sich an und landen auf der Seite /ki-verbinden. Oben steht „ChatGPT möchte auf Ihre Buchhaltung zugreifen“ und darunter „Zurück an: chatgpt.com“ mit einem grünen Haken — die Rücksprungadresse ist uns bekannt.

Unter den Feldern steht: „Gilt nur für diese eine Gesellschaft. Ans Finanzamt sendet das Programm nie selbst. Widerrufen können Sie jederzeit unter „KI-Agent & API“.“ Mit „Erlauben“ und Ihrem zweiten Faktor ist die Verbindung fertig, ChatGPT übernimmt wieder. Erscheint statt des grünen Hakens eine gelbe Warnung („Dieses Ziel kennen wir nicht“), erlauben Sie nur, wenn Sie die Verbindung gerade selbst gestartet haben — sonst „Ablehnen“.

Schritt 3: der erste Satz im Chat

Laut OpenAI wählen Sie den neuen Konnektor in einem neuen Gespräch mit „@“ aus. Ein guter erster Satz prüft, ob die richtige Gesellschaft verbunden ist:

Sie:      @Buchhaltung Welche Gesellschaft ist verbunden, welcher
          Kontenrahmen gilt, und welche Geschäftsjahre gibt es?

ChatGPT:  ruft get_entity und list_fiscal_years auf
          (beide nur lesend, deshalb ohne Rückfrage)

ChatGPT:  „Verbunden ist Ihre Gesellschaft (Beispiel), SKR04,
           Bilanzierer, Geschäftsjahre 2025 und 2026 …“

Stimmt die Gesellschaft nicht, trennen Sie den Konnektor in ChatGPT, verbinden neu und wählen auf der Freigabeseite die richtige. Stimmt sie, können Sie direkt weitermachen — etwa mit „Welche Bankumsätze aus Oktober sind noch nicht gebucht?“ (list_bank_transactions mit dem Status unbooked).

Wann ChatGPT um Erlaubnis fragt

OpenAI beschreibt das Verhalten so: Schreibaktionen eigener MCP-Server brauchen standardmäßig eine Bestätigung. ChatGPT richtet sich dabei nach der Kennzeichnung readOnlyHint; Werkzeuge ohne diese Kennzeichnung gelten als schreibend. Ihre Zustimmung oder Ablehnung können Sie sich für ein Werkzeug innerhalb eines Gesprächs merken lassen; ein neues Gespräch fragt wieder.

Unser Server kennzeichnet jedes lesende Werkzeug als nur lesend — get_saldenliste, list_open_items oder get_vat_return laufen also ohne Rückfrage. Alles, was bucht oder ausstellt, ist nicht so gekennzeichnet: book_incoming_invoice, confirm_receipt, create_outgoing_invoice, storno_journal_entry. Auch check_tax_filing fragt nach: Es ist nicht als nur lesend gekennzeichnet, obwohl die amtliche Prüfung nichts übermittelt.

Zusätzlich weist unser Server ChatGPT an, vor dem Ausstellen und Versenden einer Rechnung Empfänger und Betrag zu nennen und vor jedem nicht rückholbaren Schritt genau zu sagen, was passiert. Unser Rat: Lassen Sie sich die Zustimmung für Rechnungen und Stornos nicht merken, sondern bestätigen Sie jede einzeln.

Zweiter Weg: Codex mit festem Schlüssel

Wer lieber im Terminal oder in der Entwicklungsumgebung arbeitet, nutzt Codex von OpenAI. Für Codex beschreiben wir den Weg mit einem festen Schlüssel, den Sie unter „KI-Agent & API“ → „Neuer Schlüssel“ anlegen — ohne Freigabeseite. Die Schlüssel-Optionen von Codex stehen so in dessen Dokumentation:

# ~/.codex/config.toml
[mcp_servers.buchhaltung]
url = 'https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp'
bearer_token_env_var = 'JAB_API_KEY'
default_tools_approval_mode = 'writes'

# Schlüssel als Umgebungsvariable setzen, nicht in diese Datei schreiben:
# export JAB_API_KEY="jab_live_…"

Mit default_tools_approval_mode = 'writes' fragt Codex bei allen Werkzeugen nach, die nicht als lesend gekennzeichnet sind. Der Unterschied zum Konnektor: Beim Schlüssel von Hand wählen Sie die Rechte selbst und können zum Beispiel auch das Festschreiben von Zeiträumen erlauben, das die Freigabeseite für ChatGPT nicht anbietet.

Die Verbindung verwalten

• Jede Freigabe erscheint als Schlüssel unter Buchhaltung → Einstellungen → „KI-Agent & API“, benannt nach dem Programm und der Adresse chatgpt.com. In der Liste sehen Sie, wann er zuletzt genutzt wurde und bis wann er gilt.
• Die API-Nutzung der letzten 30 Tage zeigt je Schlüssel die Zahl der Aufrufe, wie viele davon schreibend waren, wie viele mit Fehler endeten und den letzten Aufruf.
• „Widerrufen“ macht den Zugang sofort ungültig. ChatGPT bekommt danach bei jedem Aufruf eine Ablehnung.
• Verbinden Sie ChatGPT erneut für dieselbe Gesellschaft, ersetzt Ihre neue Freigabe Ihre alte. Je Gesellschaft sind höchstens 10 Schlüssel gleichzeitig aktiv.
• Läuft die Gültigkeit ab, verbinden Sie neu. Ein Hintergrund-Token, mit dem sich ChatGPT selbst verlängern könnte, gibt es nicht.

Was über den Konnektor nicht geht

• Übermittlungen an das Finanzamt: ChatGPT prüft amtlich und bereitet vor; übermittelt wird über den Freigabe-Link in der App mit Ihrer PIN.
• Festschreiben und Webhooks: Diese Rechte bietet die Freigabeseite nicht an.
• Bankanbindung, Einstellungen der Gesellschaft sowie IBAN und BIC Ihrer Geschäftspartner bleiben in der App.
• Jahresabschluss und E-Bilanz erstellen Sie in der App. ChatGPT kann ausgestellte Abschlüsse lesen und mit publish_trial_balance die Saldenliste an den Jahresabschluss übergeben. Sind Buchungen des Jahres noch nicht festgeschrieben, übergibt es erst nach Ihrer ausdrücklichen Bestätigung, denn die Zahlen können sich danach noch ändern. Für den endgültigen Abschluss gilt: erst in der App festschreiben, dann übergeben.
• Was ChatGPT aus Ihrer Buchhaltung abruft, wird Teil Ihres Gesprächs bei OpenAI. Was das bedeutet, steht auf der Seite zum Datenschutz.

Häufige Fragen

Brauche ich einen API-Schlüssel, um ChatGPT zu verbinden?

Nein. Beim Konnektor entsteht der Schlüssel automatisch, wenn Sie auf der Freigabeseite „Erlauben“ wählen und mit dem zweiten Faktor bestätigen. Sie sehen und kopieren ihn nicht; er steht danach in Ihrer Schlüsselliste und lässt sich dort widerrufen.

Welche Adresse trage ich in ChatGPT ein?

https://jahresabschluss.io/mcp, mit OAuth als Anmeldung. Die längere Adresse unter api.jahresabschluss.io ist für Programme gedacht, die einen festen Schlüssel mitschicken, etwa Codex.

Warum zeigt ChatGPT nur lesende Werkzeuge?

Meist, weil auf der Freigabeseite „Buchen“ nicht angehakt war: ChatGPT bekommt nur die Werkzeuge angezeigt, die der Zugang erlaubt. Verbinden Sie neu und setzen Sie den Haken. Auch Ihr ChatGPT-Tarif kann schreibende Aktionen ausschließen — laut OpenAI verbinden etwa Pro-Konten eigene Server nur lesend.

Wie lange gilt die Verbindung?

So lange, wie Sie auf der Freigabeseite gewählt haben: 30 Tage, 90 Tage oder 1 Jahr. Danach verbinden Sie neu. Widerrufen können Sie jederzeit vorher unter „KI-Agent & API“.

Kann ChatGPT über den Konnektor die Umsatzsteuer-Voranmeldung abschicken?

Nein. ChatGPT kann die Voranmeldung lesen, amtlich prüfen und vorbereiten und Ihnen einen Freigabe-Link geben. Übermitteln können nur Sie selbst, in der App und mit Ihrer PIN.

Funktioniert der Konnektor für mehrere Gesellschaften?

Eine Verbindung gilt für genau eine Gesellschaft. Für eine andere Gesellschaft verbinden Sie erneut und wählen sie auf der Freigabeseite aus; den Zugang zur ersten widerrufen Sie bei Bedarf unter „KI-Agent & API“.