Verbinde Hermes Agent mit dem belege.ai-MCP. So kannst du offene ADDISON-Belegfälle abfragen, gezielte Suchläufe starten und vorhandene Dokumente direkt im Agenten finden.
Das ist keine freie Fernsteuerung deiner Buchhaltung. Hermes Agent greift über klar begrenzte MCP-Tools auf deinen belege.ai-Datenbestand zu. belege.ai übernimmt die Belegsuche und den kontrollierten Rückweg zu ADDISON Direkt.
Ablauf
Nach Zeitraum, Händler oder Betrag fragen und fehlende Dokumente im belege.ai-Datenbestand erkennen.
Ausgewählte Belegfälle an den Invoice Finder übergeben; Login- und 2FA-Rückfragen laufen weiter kontrolliert über Telegram.
belege.ai sendet ausgewählte Originalbelege an die von ADDISON Direkt erzeugte Upload-Adresse und wertet die Rückmeldung aus.
Hermes registriert die Remote-Tools beim Start. Mit aktivem Gateway kannst du denselben Ablauf auch aus Telegram anstoßen.
Reichweite
Für Lexware und sevDesk liest belege.ai die dort erfassten Buchungen ein und schreibt gefundene Belege wieder zurück. Bei ADDISON ist der Funktionsumfang schmaler — das ändert nichts an den MCP-Werkzeugen, aber an dem, was sie beantworten können.
ADDISON Direkt gibt keine Buchungen an belege.ai zurück. Einen Import, der dort erfasste Belege oder Buchungen einliest, gibt es nicht — sichtbar ist allein der in belege.ai protokollierte Übergabestatus.
Belegfragen werden aus den in belege.ai vorhandenen Bank-, Karten- und Zahlungsdienst-Umsätzen samt zugehörigen Dokumenten beantwortet — nicht aus ADDISON.
Gefundene Dokumente gehen per E-Mail an die Upload-Adresse des Belegordners. Eine Schnittstelle, die einen Beleg an eine bereits in ADDISON erfasste Buchung anheftet, existiert nicht.
Hermes Agent kann Belegfälle lesen und eine Suche anstoßen. Kein MCP-Werkzeug überträgt einen Beleg; der Versand wird in belege.ai ausgelöst, nicht im Chat.
Hermes Agent einrichten
Die Buchhaltungsintegration und der MCP-Zugriff werden getrennt autorisiert.
Die von ADDISON Direkt erzeugte Upload-Adresse in belege.ai eintragen und den bestätigten Testbeleg abwarten. Zugangsdaten werden nicht hinterlegt.
Den HTTP-Server unter mcp_servers in ~/.hermes/config.yaml eintragen und auth auf oauth setzen.
hermes mcp login belege_ai starten, den Browser-Dialog abschließen und die Werkzeugliste in der laufenden Sitzung mit /reload-mcp aktualisieren.
mcp_servers:
belege_ai:
url: "https://belege.ai/mcp"
auth: oauthRemote-MCP-Endpunkt: https://belege.ai/mcp. Die Anmeldung erfolgt per OAuth 2.1 mit PKCE und kann widerrufen werden.
Beispiel-Prompts
Sicherheit
Dein belege.ai-Passwort bleibt bei belege.ai. Hermes Agent erhält stattdessen einen widerrufbaren Token, den du in den API-Token-Einstellungen jederzeit zurückziehen kannst.
Jedes Tool läuft unter deiner Postgres-Identität. Hermes Agent kann nur auf die Daten zugreifen, die deinem Konto beziehungsweise deiner Organisation freigegeben sind.
belege.ai übermittelt Hermes Agent nur die Ergebnisse, die für deine konkrete Anfrage erforderlich sind. Es findet kein unbeschränkter Export deines Buchhaltungsbestands statt.
Freie SQL-Schreibzugriffe bleiben gesperrt. Typisierte Tools starten Belegsuchen, beantworten Rückfragen und markieren Buchungen als „kein Beleg nötig“ — mit Audit-Grund, ohne freies UPDATE.
Die belege.ai-Infrastruktur läuft in Deutschland. Mehr zu Verschlüsselung und Unter-Auftragsverarbeitern auf der Trust-Seite und in der Datenschutzerklärung.
Agent-Auswahl
Der Datenzugriff bleibt gleich; Einrichtung und Bedienoberfläche unterscheiden sich je Client.
Claude · Claude Desktop · Claude Code
Für Nutzer, die ihre Buchungsfragen direkt in Claude stellen und den Remote-MCP als eigenen Connector aktivieren möchten.
ChatGPT App
Für Nutzer, die belege.ai in ChatGPT als eigene App anbinden und Belegfälle im normalen Chat bearbeiten möchten.
Codex App · CLI · IDE
Für agentische Abläufe in Codex App, CLI oder IDE – mit gemeinsam genutzter MCP-Konfiguration und nachvollziehbaren Tool-Aufrufen.
Hermes Agent · CLI · Telegram
Für einen selbst gehosteten Agenten, der den belege.ai-MCP auch aus Telegram, Discord oder der Hermes-CLI verwenden kann.
FAQ
Nicht direkt — und das ist der Punkt. belege.ai stellt einen Remote-MCP bereit, den Hermes Agent als Werkzeugserver verwendet. Der Agent arbeitet mit deinem belege.ai-Datenbestand; ADDISON Direkt ist ausschließlich das Ziel für den anschließenden Belegversand.
Nein, und zwar deutlicher als bei Lexware oder sevDesk: Es gibt keine Leseverbindung zu ADDISON. Hermes Agent sieht nur den belege.ai-Datenbestand — deine Umsätze, die zugehörigen Dokumente und den protokollierten Status der Belegübergabe.
Der Agent kann offene Fälle abfragen und für eine von dir ausgewählte Liste den Invoice Finder starten. belege.ai sucht anschließend in verbundenen E-Mail-Postfächern und Portalen; Rückfragen bleiben nachvollziehbar.
Nein. Der MCP-Zugriff ist lesend: SQL-Abfragen laufen in einer Read-only-Transaktion, und kein Werkzeug überträgt ein Dokument. Den Versand an die ADDISON-Upload-Adresse löst belege.ai nach einem bestätigten Testbeleg selbst aus. Hermes Agent kann den Stand sehen, nicht das Senden auslösen.
Nein. Der gehostete belege.ai-MCP ist unter https://belege.ai/mcp erreichbar. Du musst keinen lokalen Prozess installieren oder dauerhaft betreiben.
Die Anmeldung läuft über OAuth 2.1 mit PKCE. Row-Level Security begrenzt jeden Tool-Aufruf auf deinen freigegebenen Datenbestand; der Token kann jederzeit widerrufen werden.
Hinterlege zuerst die ADDISON-Upload-Adresse in belege.ai und autorisiere danach den MCP in Hermes Agent. Der Einstieg ist kostenlos, ohne Kreditkarte.