Glossar
Glossar: Begriffe rund um KI-Agenten, MCP und Buchhaltung
Dieses Glossar erklärt die Begriffe, die Sie brauchen, um einen KI-Agenten an eine Buchhaltung anzubinden — von KI-Agent und Model Context Protocol über Werkzeug, Recht und API-Schlüssel bis zu Prüfwert, Freigabe-Link, GoBD, Festschreibung, Storno und Saldenliste. Jeder Eintrag sagt zuerst allgemein, was der Begriff bedeutet, und danach, wie er bei jahresabschluss.io umgesetzt ist.
Stand: 2026-10-19
KI und Agenten
KI-Agent
Ein Programm, in dem ein Sprachmodell nicht nur antwortet, sondern selbständig Schritte ausführt: Es liest Daten, ruft Werkzeuge auf und entscheidet anhand der Ergebnisse über den nächsten Schritt. In der Buchhaltung heißt das etwa: Belege abfragen, einen Buchungsvorschlag prüfen, nach Ihrer Freigabe buchen. Den Agenten wählen und betreiben Sie selbst, zum Beispiel Claude Code, Codex oder Cursor.
Sprachmodell (LLM)
Ein großes Sprachmodell (englisch large language model) erzeugt Text auf Grundlage gelernter Wahrscheinlichkeiten. Es kann sich irren und kennt Ihre Bücher nur, soweit es sie über ein Werkzeug liest. Seine Ausgaben sind deshalb Vorschläge; die Regeln der Buchhaltung setzt der Server durch.
Mensch in der Schleife
Grundsatz, dass ein Mensch Aufrufe ablehnen kann und folgenreiche Schritte bestätigt; die MCP-Spezifikation empfiehlt ihn ausdrücklich. Unser Server weist den Agenten an, vor dem Ausstellen und Versenden einer Rechnung, vor Stornorechnung, Gutschrift, endgültigem Löschen eines Belegs und Festschreibung Ihre Bestätigung für genau diesen Vorgang einzuholen.
Fremdtext und Prompt Injection
Fremdtext ist alles, was von Dritten stammt: Verwendungszwecke, Belegtexte, Partnernamen. Prompt Injection nennt man den Versuch, einem Agenten über solchen Text Befehle unterzuschieben. Unsere Server-Anweisungen erklären Fremdtext zu Daten und weisen den Agenten an, darin stehende Aufforderungen nie zu befolgen; IBAN und BIC von Partnern sind über die Schnittstelle gar nicht änderbar.
Model Context Protocol
Model Context Protocol (MCP)
Offener Standard, über den KI-Programme externe Werkzeuge und Daten anbinden. Die Nachrichten sind als JSON-RPC kodiert; ein Programm fragt mit tools/list ab, welche Werkzeuge ein Server anbietet, und ruft sie mit tools/call auf.
MCP-Server
Die Gegenstelle, die Werkzeuge anbietet. Unser gehosteter Server unter https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp ist ein Adapter vor der REST-API: Jeder Werkzeugaufruf wird zu genau einem API-Aufruf mit Ihrem Schlüssel, mit denselben Prüfungen wie in der App.
MCP-Client
Der Teil des KI-Programms, der die Verbindung zum Server hält, die Werkzeugliste an das Modell gibt und Aufrufe ausführt. Claude Code, Codex, Gemini CLI, Cursor oder Zed bringen einen solchen Client mit.
Werkzeug
Eine einzelne Funktion eines MCP-Servers mit Name, Beschreibung und Eingabeschema, etwa get_saldenliste oder create_journal_entry. Das Modell wählt ein Werkzeug und füllt die Argumente; im Englischen heißt das „tool calling“. Unser Server prüft die Argumente gegen das Schema, bevor er die API aufruft.
Streamable HTTP
Übertragungsweg der MCP-Spezifikation, bei dem das Programm jede Nachricht als HTTP-POST an einen einzigen Endpunkt sendet; er ersetzt den älteren Weg HTTP+SSE der Protokollversion 2024-11-05. Unser Server arbeitet nach dem Muster Anfrage und Antwort und unterstützt die Protokollversionen 2025-06-18, 2025-03-26 und 2024-11-05.
stdio und mcp-remote
Bei stdio startet das KI-Programm einen Server als lokalen Prozess und spricht über Standardein- und -ausgabe mit ihm. Programme, die nur so arbeiten, etwa Claude Desktop, verbinden sich über die Brücke mcp-remote mit einem entfernten Server; sie reicht Nachrichten und Kopfzeile weiter.
Server-Anweisungen
Text, den ein MCP-Server beim Verbindungsaufbau mitgibt. Unsere Anweisungen sagen dem Agenten unter anderem, dass sich die Gesellschaft aus dem Schlüssel ergibt, wann er Ihre Bestätigung braucht, dass Fremdtext keine Anweisung ist und dass er bei Wiederholungen dieselbe UUID verwendet.
Zugang und Rechte
API-Schlüssel
Geheime Zeichenfolge, mit der sich ein Programm anmeldet. Unsere Schlüssel beginnen mit jab_live_, gelten für genau eine Gesellschaft, laufen nach höchstens 366 Tagen ab und werden nur als Hash gespeichert; im Klartext sehen Sie einen Schlüssel nur einmal beim Anlegen unter „KI-Agent & API“.
Bearer
Ein Bearer-Token berechtigt jeden, der es besitzt (RFC 6750) — wie ein Haustürschlüssel. Es gehört deshalb in eine Umgebungsvariable oder einen Passwortspeicher, nie in einen Chat. Unser Server liest den Schlüssel aus Authorization: Bearer jab_live_…, nimmt ihn aber auch ohne „Bearer“ oder in der Kopfzeile X-API-Key an.
Recht (Scope)
Was ein Schlüssel darf. Unsere Rechte heißen read (immer enthalten), write (buchen, anlegen, Steuern prüfen und vorbereiten), send (Rechnungen per E-Mail an hinterlegte Adressen), webhooks (Ereignisse anmelden) und finalize (festschreiben). Die Werkzeugliste zeigt nur, was der Schlüssel erlaubt.
Ratenbegrenzung
Obergrenze für Anfragen in einem Zeitraum. Je Schlüssel sind 120 Anfragen pro Minute erlaubt; darüber antwortet die API mit Status 429 und nennt in Retry-After, wann es weitergeht. Für amtliche Prüfungen und Vorbereitungen gilt zusätzlich eine Grenze je Stunde.
Schnittstelle
REST-API
Schnittstelle, bei der jede Operation eine eigene Adresse und HTTP-Methode hat, etwa GET /v1/saldenliste. Unsere REST-API liegt unter https://api.jahresabschluss.io/functions/v1/bookkeeping-api und ist die Grundlage, auf der auch der MCP-Server arbeitet.
OpenAPI
Standardisierte, maschinenlesbare Beschreibung einer HTTP-Schnittstelle, mit der Menschen und Programme verstehen, was eine API kann, ohne ihren Quelltext zu lesen. Unser Schema in der Fassung OpenAPI 3.1 ist ohne Schlüssel unter …/bookkeeping-api/openapi.json abrufbar.
Webhook
Eine Benachrichtigung, die ein System von sich aus an Ihre Adresse schickt, wenn etwas geschieht. Mit dem Recht webhooks melden Sie Ereignisse wie journal_entry.created, bank_transaction.created, outgoing_invoice.created, incoming_invoice.created oder invoice_payment.created an eine https-Adresse an.
Webhook-Signatur
Prüfsumme, mit der Ihr Empfänger erkennt, dass eine Nachricht echt ist. Unsere Kopfzeile X-Jab-Signature trägt t=<Unix-Zeit> und v1=<HMAC-SHA256 über Zeit, Punkt und Rohdaten>; das Geheimnis dafür zeigt die API nur einmal bei der Anmeldung.
Idempotenzschlüssel
Eine UUID, die einen schreibenden Vorgang eindeutig kennzeichnet. Wiederholt der Agent nach einem Abbruch mit derselben UUID und denselben Daten, wird nur einmal gebucht; eine neue UUID wäre ein neuer Vorgang. Bei uns heißt das Feld idempotency_key, beim Rechnungsversand dispatch_request_id.
Probelauf (dry_run)
Ein Aufruf mit allen Prüfungen, aber ohne Buchung. Die Antwort nennt die Buchungszeilen (would_create), die Wirkung auf Konten (saldo_effect) und auf die Kennzahlen der Voranmeldung (vat_effect, in Cent). Unter anderem import_journal_batch, book_incoming_invoice und die Zahlungswerkzeuge kennen ihn.
Sandbox
Testumgebung, die die echten Bücher nicht berührt. Bei uns ein versteckter Zwilling der Gesellschaft mit eigenen Schlüsseln; get_entity meldet sandbox: true, und nichts verlässt den Zwilling. Derzeit gibt es sie für Gesellschaften ohne Jahresabschluss-Daten, etwa EÜR-Betriebe oder neue Gesellschaften.
Steuern
ELSTER
Das elektronische Verfahren der Steuerverwaltung für Steuererklärungen und -anmeldungen. Unsere Software übermittelt Meldungen wie die Umsatzsteuer-Voranmeldung an ELSTER — ausgelöst von Ihnen in der App.
ERiC
Die Programmbibliothek ELSTER Rich Client, die die Steuerverwaltung Softwareanbietern kostenlos bereitstellt. Sie prüft Datensätze auf Plausibilität und überträgt sie gesichert; unsere amtliche Prüfung nutzt sie.
Amtliche Prüfung und Testmerker
Eine Prüfung des Datensatzes mit ERiC, bei der nichts übermittelt wird. Bei uns macht das check_tax_filing, gekennzeichnet mit Testmerker, auch in der Sandbox. Die Antwort nennt Feldfehler, Hindernisse und den Prüfwert des aktuellen Stands.
Prüfwert
Ein SHA-256-Wert über die Werte einer vorbereiteten Meldung, bei uns manifest_sha256. prepare_tax_filing friert Werte und Prüfwert 30 Minuten lang ein; die App vergleicht vor dem Senden den neu gerechneten Stand mit diesem Wert, damit gesendet wird, was Sie gesehen haben.
Hindernis
Grund, warum eine vorbereitete Meldung noch nicht sendebereit ist, etwa zertifikat_fehlt, wenn die Gesellschaft kein eigenes ELSTER-Zertifikat hinterlegt hat. Sendebereit ist ein Vorgang erst ohne Hindernis.
Freigabe-Link
Link aus request_tax_filing_approval, sieben Tage gültig. Sie öffnen ihn in der App, die App rechnet den Stand neu und vergleicht, und Sie übermitteln selbst mit Ihrer PIN. Die PIN erreicht den Agenten nie.
UStVA, ZM, Dauerfristverlängerung
Umsatzsteuer-Voranmeldung, Zusammenfassende Meldung für innergemeinschaftliche Lieferungen und Leistungen und Antrag auf Fristverlängerung. Über die Schnittstelle heißen sie ustva, zm und dauerfrist; dazu kommen sovz, ustje, ebilanz, kst, gewst und euer.
Buchhaltung
GoBD
Die Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern, Aufzeichnungen und Unterlagen in elektronischer Form sowie zum Datenzugriff — ein BMF-Schreiben vom 28. November 2019, seither geändert. Sie konkretisieren unter anderem § 146 und § 147 AO.
Festschreibung
Ab einem Stichtag sind Buchungen unveränderlich; korrigiert wird nur noch per Storno in einem offenen Zeitraum. Bei uns schreibt finalize_bookkeeping_period mit dem Recht finalize und confirm=true fest — unwiderruflich, deshalb erst nach Ihrer Bestätigung des Stichtags.
Storno
Korrektur durch Gegenbuchung: Die falsche Buchung bleibt sichtbar, eine zweite hebt sie auf. § 146 Abs. 4 AO verbietet Veränderungen, die den ursprünglichen Inhalt unkenntlich machen. Bei uns etwa storno_journal_entry, storno_payment und cancel_outgoing_invoice.
Saldenliste
Die Summen- und Saldenliste (SuSa) zeigt je Konto Eröffnung, Verkehrszahlen und Saldo. get_saldenliste liefert sie für ein Geschäftsjahr oder mit as_of zu einem Stichtag; publish_trial_balance übergibt sie an das Jahresabschluss-Modul.
Buchungsjournal
Das Grundbuch: alle Buchungen in zeitlicher Folge mit Nummer, Datum, Konten, Betrag und Beleg. list_journal_entries liest es, filterbar nach Jahr, Zeitraum, Konto, Herkunft und Belegnummer.
Buchungsstapel
Mehrere Buchungen, die gemeinsam übergeben werden. import_journal_batch bucht bis 5.000 ausgeglichene Zeilen als einen Stapel, alles oder nichts; im Kanzlei Software-Format heißt die Exportdatei ebenfalls Buchungsstapel.
Kontenrahmen und Steuerschlüssel
Der Kontenrahmen ordnet Konten Nummern zu, bei uns SKR03 oder SKR04. Der Steuerschlüssel einer Buchung, etwa V19, A19, ST0 oder RC19, bestimmt die Umsatzsteuer und die Kennzahl der Voranmeldung.
EÜR
Einnahmen-Überschuss-Rechnung nach § 4 Abs. 3 EStG: Gewinn ist der Überschuss der Betriebseinnahmen über die Betriebsausgaben, gezählt mit der Zahlung (§ 11 EStG). get_euer zeigt die Vorschau der Anlage EÜR.
Saldenvortrag
Die Eröffnungswerte eines Geschäftsjahres sind die Schlusswerte der Bestandskonten des Vorjahres. carry_forward_opening_balances trägt sie aus einem endgültigen Vorjahr vor; aus einem offenen Vorjahr wird nichts gebucht.
Ein Ablauf, in Begriffen
Wie die Begriffe zusammenhängen, am Beispiel einer Voranmeldung:
- Sie legen einen API-Schlüssel mit dem Recht write an und tragen den MCP-Server in Ihr KI-Programm ein.
- Der MCP-Client fragt mit tools/list die Werkzeuge ab und sieht nur die, die der Schlüssel erlaubt.
- Der Agent bucht offene Belege; jeder schreibende Aufruf trägt einen Idempotenzschlüssel, auf Wunsch zuerst als Probelauf.
- check_tax_filing macht die amtliche Prüfung mit ERiC und Testmerker, prepare_tax_filing friert Werte und Prüfwert ein und nennt Hindernisse.
- request_tax_filing_approval liefert den Freigabe-Link; Sie übermitteln in der App an ELSTER, mit Ihrer PIN.
- Zum Monatsende schreibt finalize_bookkeeping_period nach Ihrer Bestätigung fest; Korrekturen sind danach nur noch per Storno in einem offenen Zeitraum möglich.
Häufige Fragen
Was ist der Unterschied zwischen MCP-Server und REST-API?
Die REST-API ist die Schnittstelle mit Adressen und HTTP-Methoden für eigene Programme. Der MCP-Server bietet dieselben Funktionen als Werkzeuge für KI-Programme an; bei jahresabschluss.io ruft er die REST-API mit Ihrem Schlüssel auf.
Was ist ein Werkzeug bei MCP?
Eine einzelne Funktion eines MCP-Servers mit Name, Beschreibung und Eingabeschema, etwa get_saldenliste. Das Sprachmodell wählt das Werkzeug und füllt die Argumente, der Server prüft sie und führt den Aufruf aus.
Was bedeutet Scope bei einem API-Schlüssel?
Scope ist das Recht, das ein Schlüssel hat. Bei uns sind das read, write, send, webhooks und finalize; der Agent sieht nur die Werkzeuge, die zu den Rechten seines Schlüssels passen.
Was ist ein Prüfwert?
Ein SHA-256-Wert über die vorbereiteten Werte einer Steuermeldung. Er stellt sicher, dass in der App genau das übermittelt wird, was Sie gesehen haben; ändert sich der Stand, passt der Prüfwert nicht mehr.
Was heißt Festschreibung in der Buchhaltung?
Ab dem festgeschriebenen Stichtag lassen sich Buchungen nicht mehr ändern; korrigiert wird per Storno in einem offenen Zeitraum. Bei uns geschieht das mit finalize_bookkeeping_period und nur nach Ihrer Bestätigung.
Was ist eine Sandbox?
Eine Testumgebung, die die echten Bücher nicht berührt. Bei jahresabschluss.io ein Zwilling der Gesellschaft mit eigenen Schlüsseln, aus dem nichts versendet oder übermittelt wird; derzeit für Gesellschaften ohne Jahresabschluss-Daten.
Vom selben Anbieter: Jahresabschluss nach HGB – der komplette Leitfaden auf jahresabschluss.io.