Deine Instanz für Agenten — die Programmschnittstelle

Veröffentlicht am 09. September 2026, zuletzt geprüft am 20. September 2026

Alles, was du in deiner Instanz von Hand tust — Konten anlegen, den Kontenrahmen wählen, Belege hochladen, Buchungen zuordnen, den Export erzeugen — läuft über eine Schnittstelle. Dieselbe, die auch die Oberfläche benutzt. Und dafür kannst du Schlüssel erzeugen und sie einem Werkzeug deiner Wahl geben — zum Beispiel einem KI-Assistenten, der die Einrichtung nach den Vorgaben deines Steuerbüros übernimmt, deine Belege einliefert und beim ersten Durchgang die Zuordnung macht.

Der Schlüssel

Den Schlüssel erzeugst du in deiner Instanz unter Einstellungen → Zugang → Programmschnittstelle. Er wird genau einmal angezeigt — gespeichert wird nur sein Fingerabdruck — und lässt sich jederzeit mit einem Klick widerrufen. In der Liste siehst du je Schlüssel, wann er zuletzt benutzt wurde und ob er freigeben darf.

Die Anleitung für den Agenten

Die maschinenlesbare Anleitung liegt frei abrufbar unter www.jubeljahr.com/agents.md. Du musst sie nicht lesen (darfst aber): sie ist für Agenten geschrieben und beschreibt die Abläufe — Einrichtung, Einliefern, Zuordnen, Freigeben, Export — samt der Regeln, die dabei gelten. Der Satz an deinen Agenten ist damit kurz:

Lies https://www.jubeljahr.com/agents.md  (öffnet in einem neuen Tab). Hier ist mein Schlüssel. Richte meine Instanz nach dem Schreiben meiner Kanzlei ein.

Dieselben Prüfungen wie für dich

Ein Schlüssel ist kein Hintereingang. Jede Anfrage über die Schnittstelle durchläuft exakt die Prüfungen, die auch deine eigenen Eingaben durchlaufen: Ein Konto mit Buchungen lässt sich nicht löschen, eine Buchung ohne Kategorie nicht freigeben, ein unvollständiges Exportziel blockiert den Export mit benanntem Grund. Und die Zugangsverwaltung — Passkeys, Einladungen, der Verwaltungszugang, weitere Schlüssel — ist für Schlüssel gesperrt: Wer einen stiehlt, hat ein Werkzeug, keine Instanz.

Freigeben nur, wenn du es erlaubst

Zuordnen ist Vorbereitung; Freigeben ist die Entscheidung, dass eine Buchung so stimmt und in den Export darf. Diese Entscheidung bleibt bei dir — es sei denn, du gibst sie ausdrücklich ab. Beim Erzeugen eines Schlüssels gibt es dafür den Haken „Darf auch freigeben“. Ohne ihn bereitet der Schlüssel nur vor: einrichten, Belege einliefern, Kontoauszüge importieren, zuordnen. Versucht ein Agent trotzdem freizugeben, lehnt die Instanz ab und nennt den Grund; der Agent soll dir dann sagen, was fertig zur Freigabe liegt.

Mit dem Haken darf der Schlüssel freigeben — und jede so freigegebene Buchung trägt in der Prüfung eine Marke mit dem Namen des Schlüssels, auch nach dem Export. So bleibt erkennbar, wer entschieden hat: du oder dein Werkzeug. Die Erlaubnis gilt ab dem Erzeugen und lässt sich nicht nachträglich umschalten; willst du sie ändern, erzeugst du einen neuen Schlüssel und widerrufst den alten. Das ist Absicht: Die Entscheidung soll bewusst fallen, nicht nebenbei.

Was bleibt, bleibt: Auch ein freigebender Schlüssel kommt nicht an einer fehlenden Kategorie vorbei, und ob eine Zuordnung fachlich richtig ist, prüft weiterhin niemand für dich — dazu unten mehr.

Was der Agent lernt, bleibt deiner Instanz

Wenn dein Agent beim ersten Durchgang zuordnet, lernt deine Instanz dabei dieselben Regeln, die sie auch bei dir lernt: Zahlungspartner → Kategorie. Beim nächsten Import sitzt die Zuordnung von selbst — der Agent macht sich Stück für Stück überflüssig, genau wie du es tätest.

Der MCP-Anschluss

Spricht dein Agent MCP (Model Context Protocol), brauchst du nicht einmal die Anleitung: Trage in seiner MCP-Konfiguration zwei Dinge ein, und er bekommt die Werkzeuge deiner Instanz direkt gereicht.

• Adresse: https://mcp.jubeljahr.com/i/<kennung>/mcp — die Kennung ist die Subdomain deiner Instanz. Heißt deine Instanz beispiel.jubeljahr.com, lautet die Adresse https://mcp.jubeljahr.com/i/beispiel/mcp.
• Zugang: dein Schlüssel, als Kopfzeile Authorization: Bearer jj_….

Dahinter liegt exakt die Schnittstelle, die dieser Artikel beschreibt — der Anschluss ist ein Übersetzer, kein zweiter Weg. Er merkt sich nichts: keine Sitzungen, keine Daten, keine Schlüssel. Auch hier gilt die Sperrzone, und ein widerrufener Schlüssel ist auch dort sofort tot.