Verbinde Hermes Agent mit dem belege.ai-MCP. So kannst du offene Lexware-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 Lexware Office.
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 ordnet gefundene Dokumente anhand von Betrag, Datum und Gegenseite der passenden offenen Lexware-Buchung zu.
Hermes registriert die Remote-Tools beim Start. Mit aktivem Gateway kannst du denselben Ablauf auch aus Telegram anstoßen.
Hermes Agent einrichten
Die Buchhaltungsintegration und der MCP-Zugriff werden getrennt autorisiert.
Das Buchhaltungskonto zuerst in belege.ai verbinden und die erste Synchronisierung abwarten.
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 Hermes neu laden.
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. Nur spezialisierte Invoice-Finder-Tools dürfen ausdrücklich ausgewählte Suchläufe starten und Antworten an wartende Sessions übergeben.
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
Ja. belege.ai stellt einen Remote-MCP bereit, den Hermes Agent als Werkzeugserver verwenden kann. Zuerst verbindest du dein Buchhaltungskonto mit belege.ai, danach autorisierst du den MCP separat.
Hermes Agent liest die für dein Konto synchronisierten Lexware-Buchungen und Dokumente über begrenzte belege.ai-Tools. Kontakte, Angebote und Ausgangsrechnungen werden nicht frei verwaltet.
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 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.
Verbinde zuerst Lexware Office mit belege.ai und autorisiere danach den MCP in Hermes Agent. Der Einstieg ist kostenlos, ohne Kreditkarte.