Verbinde Codex mit dem belege.ai-MCP. So kannst du offene sevDesk-Belegfälle abfragen, gezielte Suchläufe starten und vorhandene Dokumente direkt im Agenten finden.
Das ist keine freie Fernsteuerung deiner Buchhaltung. Codex greift über klar begrenzte MCP-Tools auf deinen belege.ai-Datenbestand zu. belege.ai übernimmt die Belegsuche und den kontrollierten Rückweg zu sevDesk.
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 überträgt gefundene Rechnungen und genehmigte Bewirtungsbelege kontrolliert in den sevDesk-Beleg-Eingang.
Codex zeigt die MCP-Werkzeuge in App, CLI und IDE; dieselbe lokale Konfiguration gilt auf allen drei Oberflächen.
Codex einrichten
Die Buchhaltungsintegration und der MCP-Zugriff werden getrennt autorisiert.
Das Buchhaltungskonto zuerst in belege.ai verbinden und die erste Synchronisierung abwarten.
Den Remote-Server per Codex CLI oder über Einstellungen → MCP servers als Streamable HTTP eintragen.
codex mcp login belege-ai ausführen; danach steht der Server in Codex App, CLI und IDE bereit.
codex mcp add belege-ai --url https://belege.ai/mcp codex mcp login belege-ai
Remote-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. Codex 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. Codex kann nur auf die Daten zugreifen, die deinem Konto beziehungsweise deiner Organisation freigegeben sind.
belege.ai übermittelt Codex 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 Codex als Werkzeugserver verwenden kann. Zuerst verbindest du dein Buchhaltungskonto mit belege.ai, danach autorisierst du den MCP separat.
Codex arbeitet mit den Buchungen und Dokumenten, die in belege.ai vorhanden sind. sevDesk ist das kontrollierte Ziel für gefundene PDFs; es findet keine pauschale Live-Abfrage des vollständigen sevDesk-Kontos statt.
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 sevDesk mit belege.ai und autorisiere danach den MCP in Codex. Der Einstieg ist kostenlos, ohne Kreditkarte.