Mit dem boring MCP-Server verbindest du deinen eigenen KI-Agenten mit boring.tax. Ein Satz genügt, und der Agent holt die Rechnungen aus deinem Postfach und aus den Kundenportalen deiner Anbieter, ordnet sie deinen Banktransaktionen zu, bucht sie und bereitet die Umsatzsteuer-Voranmeldung vor.

Warum sich das lohnt und wie der Ablauf aus dem Video im Detail aussieht, liest du im Guide Belege rein, UStVA raus.

Was du brauchst

  1. boring MCP für den Zugriff auf deine Buchhaltung, im Rahmen der Rechte, die du dem Agenten gibst.
  2. Einen E-Mail-Connector (z. B. für Gmail oder Outlook) für die Suche im Postfach.
  3. Optional: Browser- oder Computer-Use-Funktion deines KI-Clients, damit der Agent Rechnungen aus Kundenportalen holen kann.

Schritt 1: Einen Agenten in boring anlegen

MCP-Zugriff läuft in boring immer über ein eigenes Agenten-Konto, nicht über deinen persönlichen Zugang.

  1. Öffne in boring.tax Integrationen und API → API & MCP. Der Bereich ist für Organisations-Admins sichtbar.
  2. Klicke auf Agent erstellen und gib ihm einen Namen, z. B. „Beleg-Agent“.
  3. Lege die Rechte fest. Für den kompletten Ablauf aus dem Video (Belege, Buchungen, Voranmeldung) reicht Buchhaltung verwenden. Wenn der Agent für Belege, die er nicht findet, Aufgaben anlegen soll, gib zusätzlich Aufgaben verwenden frei. Alles andere kannst du abwählen.
  4. Bestätige die Anlage. Ein Agent wird wie ein normaler Benutzer abgerechnet und erhält keine E-Mails.

Die Rechte kannst du später jederzeit unter Organisationsbenutzer ändern oder den Agenten dort entfernen.

Schritt 2: Deinen KI-Client mit boring verbinden

Die Verbindung braucht nur eine Adresse. Füge in deinem KI-Client diesen Remote-MCP-Server hinzu:

https://backend.boring.tax/api/mcp
  • Claude (App und claude.ai): Einstellungen → Connectors → eigenen Connector hinzufügen, URL eintragen, auf „Verbinden“ klicken.
  • ChatGPT: In den Einstellungen unter Apps & Connectors einen eigenen Connector mit der URL anlegen. Je nach Tarif musst du dafür den Entwicklermodus aktivieren.
  • Claude Code, Codex und andere Entwickler-Tools:
# Claude Code – danach /mcp aufrufen und anmelden
claude mcp add --transport http boring https://backend.boring.tax/api/mcp

# Codex
codex mcp add boring --url https://backend.boring.tax/api/mcp
codex mcp login boring

Beim ersten Verbinden öffnet sich boring.tax im Browser:

  1. Anmelden mit deinem boring.tax-Konto.
  2. Organisation und Agent wählen. Du legst fest, in welcher Organisation und als welcher Agent die App arbeiten darf.
  3. Zugriff erlauben. Fertig – dein KI-Client ist verbunden.

Die App sieht danach nur diese eine Organisation, mit genau den Rechten des gewählten Agenten. Es gibt keinen API-Schlüssel, den du kopieren oder aufbewahren musst. Unter Integrationen und API → API & MCP → Verbundene Apps siehst du jederzeit, welche Apps verbunden sind, und kannst den Zugriff mit einem Klick widerrufen.

Verbinden können nur Organisations-Admins und -Manager. Der Agent muss vorher angelegt sein (Schritt 1).

Schritt 3: Postfach verbinden

Verbinde in deinem KI-Client einen E-Mail-Connector für dein Postfach. Welcher das ist, hängt von deinem Client und deinem Mailanbieter ab.

Wichtig ist eine Sache: Der Connector muss Anhänge als Datei auslesen können, nicht nur Betreff und Text der Mails. Nur dann kann der Agent das PDF an boring weitergeben.

Schritt 4 (optional): Kundenportale freischalten

Manche Anbieter verschicken Rechnungen nicht per Mail, sondern stellen sie nur im Kundenportal bereit. Kann dein KI-Client einen Browser bedienen (oft „Computer Use“ oder Browser-Erweiterung genannt), holt der Agent sie dort ab.

So funktioniert das sicher:

  • Du meldest dich selbst an. Der Agent arbeitet in deiner bestehenden Browser-Sitzung. Ist er nicht eingeloggt, bittet er dich um Hilfe; nach deinem Passwort fragt er nie.
  • boring speichert keine Portal-Zugangsdaten. Das Einloggen passiert ausschließlich zwischen dir, deinem Browser und deinem KI-Client.
  • Der Agent fragt vorher. Bevor er ein Portal öffnet, sagt er dir, wo und wonach er suchen will.

Schritt 5: Den Agenten arbeiten lassen

Nach dem Verbinden kennt der Agent die verfügbaren boring-Werkzeuge und bringt Arbeitsanleitungen für fehlende Belege, Buchungen und die Voranmeldung mit. Ein Satz genügt:

Hol die Rechnungen für September, verknüpfe sie mit meinen Banktransaktionen und bereite die UStVA vor.

Du kannst auch kleiner anfangen:

Welche Transaktionen aus dem September haben noch keinen Beleg? Such in meinem Postfach nach den passenden Rechnungen und ordne sie zu.

Such alle Rechnungen von Adobe aus diesem Jahr und prüf, ob sie in boring sind.

Welche Belege fehlen noch für die Umsatzsteuer-Voranmeldung im Oktober?

Am Ende bekommst du eine Übersicht: was zugeordnet und gebucht wurde, was noch fehlt und warum. Für Belege, die weder im Postfach noch im Portal liegen, legt der Agent auf Wunsch eine Aufgabe pro Transaktion an, damit nichts untergeht.

Was der Agent nicht tut

  • Die Voranmeldung abschicken. Der Agent bereitet vor, prüft und schließt die Periode ab. Freigabe und Übermittlung an ELSTER machst du selbst in boring.tax.
  • Sich mit gespeicherten Passwörtern einloggen. boring speichert keine Zugangsdaten zu Anbieterportalen. Ins Portal kommt der Agent nur über deine eigene, angemeldete Browser-Sitzung.
  • Belege erfinden. Der Agent lädt nur echte Originaldateien hoch. Fehlt ein Beleg dauerhaft, schlägt er dir einen Eigenbeleg vor, den du prüfst.
  • Zahlungen auslösen. Zahlungen kann ein Agent höchstens vorbereiten. Freigeben und bei der Bank autorisieren kannst nur du.

Häufige Fragen

Mit welchen KI-Clients funktioniert das? Mit Claude, ChatGPT, Codex und jedem anderen MCP-Client, der Remote-MCP-Server mit Anmeldung (OAuth) unterstützt. Für den Ablauf aus dem Video braucht dein Client außerdem einen E-Mail-Connector und, für Kundenportale, eine Browser- oder Computer-Use-Funktion.

Liest boring meine E-Mails? Nein. Die Verbindung zu deinem Postfach besteht nur in deinem KI-Client. In boring landen nur die Dateien, die der Agent hochlädt.

Wie widerrufe ich den Zugriff? Unter Integrationen und API → API & MCP → Verbundene Apps mit einem Klick. Alternativ entfernst du den Agenten unter Organisationsbenutzer; dann erlischt auch jede Verbindung, die über ihn läuft.

Gibt es eine Größenbeschränkung? Ja, einzelne Dateien dürfen höchstens 10 MB groß sein. Das reicht für nahezu jede Rechnung. Doppelte Dateien erkennt boring automatisch.

Sind die Buchungen des Agenten endgültig? Nein. Du siehst jede Buchung in boring.tax, kannst sie prüfen und korrigieren. Die Voranmeldung geht erst raus, wenn du sie freigibst.