Nutze sevDesk mit Claude, ChatGPT, Codex oder Hermes: Frag in natürlicher Sprache, welche Belege noch fehlen. belege.ai sucht die Rechnungen in E-Mails und Portalen und überträgt gefundene PDFs kontrolliert in deinen sevDesk-Beleg-Eingang.
Was macht der sevDesk MCP Server? Er verbindet deinen KI-Agenten mit dem Belegprozess vor sevDesk: Statt sevDesk, Postfach und Anbieterportale einzeln zu durchsuchen, fragst du einmal nach offenen Belegfällen, lässt fehlende Originalrechnungen suchen und gefundene PDFs an sevDesk übergeben. Der MCP liest dafür Buchungen und Dokumente in belege.ai read-only; er ist kein allgemeiner Zugriff auf Kontakte, Angebote oder Ausgangsrechnungen in deinem sevDesk-Konto.
In deinem belege.ai-Datenbestand sind drei Ausgaben noch ohne Dokument:
Ich kann die Suche gesammelt starten. Gefundene PDFs überträgt belege.ai danach in deinen sevDesk-Beleg-Eingang.
Erledigt — Zwischenstand des Suchlaufs:
Die 2FA-Rückfrage fürs Hotelportal kommt gleich per Telegram; danach liegt auch diese Rechnung im Beleg-Eingang.
Und dann in Telegram
Anwendungen
Der Agent listet Buchungen aus deinem belege.ai-Datenbestand ohne Dokument nach Zeitraum, Anbieter oder Betrag und zeigt vorhandene PDFs direkt im Chat.
Wähle die betreffenden Ausgaben aus. belege.ai sucht gebündelt in Postfächern und Portalen; Login- und 2FA-Rückfragen kommen über Telegram.
Rechnungen und genehmigte Bewirtungsbelege landen kontrolliert im sevDesk-Beleg-Eingang und sind dort bereit zur weiteren Verarbeitung.
Frag, welche Dokumente noch fehlen, welche bereits beschafft wurden und welche gefundenen PDFs für den sevDesk-Beleg-Eingang bereitstehen.
Beispielabfragen
Jede Abfrage läuft über die MCP-Werkzeuge gegen deine eigenen Daten — zum Ausprobieren einfach in Claude, ChatGPT oder Codex einfügen.
Werkzeuge
Der MCP-Server stellt acht Werkzeuge bereit. Für einen sevDesk-Ablauf tragen vor allem diese vier die Arbeit.
run_sqlLiest deine Buchungen und Dokumente read-only — die Transaktion weist INSERT, UPDATE und DELETE mit SQLSTATE 25006 ab. So beantwortet der Agent „welche Juli-Buchungen haben noch keinen Beleg für sevDesk“ ohne fertigen Report.start_invoice_finderStartet einen gebündelten Suchlauf für genau die Ausgaben, die du benannt hast. Den Upload in den sevDesk-Beleg-Eingang übernimmt danach die sevDesk-Anbindung — kein MCP-Werkzeug überträgt selbst ein Dokument.get_invoice_finder_status · reply_invoice_finderFragt Fortschritt, Fehler und offene Rückfragen des Laufs ab und beantwortet sie. Ein Portal-2FA-Code lässt sich damit auch direkt im MCP-Client zurückgeben statt in Telegram.convert_currencyRechnet Fremdwährungsrechnungen mit dem historischen EZB-Kurs zum Buchungsdatum um — der Grund, warum eine OpenAI- oder AWS-Rechnung in US-Dollar am Ende mit dem richtigen Euro-Betrag in sevDesk landet.Datenbasis
Dein KI-Agent fragt nicht pauschal den vollständigen Live-Datenbestand deines sevDesk-Kontos ab. Der MCP arbeitet mit den Buchungen und Dokumenten, die in belege.ai vorhanden und für dich freigegeben sind.
Gefundene Rechnungen und genehmigte Bewirtungsbelege überträgt belege.ai anschließend über die sevDesk-Integration in den Beleg-Eingang. Dafür benötigst du einen sevDesk-Tarif mit Belegerfassung.
Unterschied
Beide Ansätze heißen MCP, lösen aber unterschiedliche Aufgaben.
| Aufgabe | Generischer sevDesk-MCP | belege.ai MCP |
|---|---|---|
| Kontakte, Angebote und Ausgangsrechnungen verwalten | Typischer Schwerpunkt | Nicht der Zweck |
| Offene Belegfälle erkennen | Über direkte API-Abfragen möglich | Ja, im belege.ai-Datenbestand |
| E-Mails und Lieferantenportale durchsuchen | Nein | Ja, über den Invoice Finder |
| Login- und 2FA-Rückfragen begleiten | Nein | Ja, über Telegram |
| Gefundene PDFs in den Beleg-Eingang übertragen | Abhängig vom Server | Ja, kontrolliert über die sevDesk-Integration |
Grenzen
Kontakte, Angebote, Ausgangsrechnungen und Mahnwesen bleiben in sevDesk. Der MCP ist auf den Belegprozess davor spezialisiert, nicht auf die sevDesk-API in ihrer ganzen Breite.
Gefragt wird der belege.ai-Datenbestand, nicht dein sevDesk-Konto in Echtzeit. sevDesk ist das Ziel für gefundene PDFs, nicht die Datenquelle des Agenten.
Die Übergabe in den Beleg-Eingang läuft über die sevDesk-Integration von belege.ai und setzt einen sevDesk-Tarif mit Belegerfassung voraus. Im Chat siehst du den Status, nicht den Upload-Knopf.
Bleibt eine Ausgabe ohne Original, entsteht daraus nicht automatisch ein Eigenbeleg. Ein neu erzeugtes Dokument braucht immer deine ausdrückliche Zustimmung.
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.
Einrichtung
Funktioniert mit Claude, ChatGPT, Codex und Hermes Agent.
Claude, ChatGPT, Codex oder Hermes Agent öffnen und dort einen eigenen Remote-MCP-Server hinzufügen.
https://belege.ai/mcp als Remote-MCP-Endpunkt eintragen.
Bei belege.ai anmelden und den Zugriff per OAuth bestätigen — fertig.
Die Anmeldung läuft über OAuth 2.1 mit PKCE. Der Zugriff kann jederzeit unter API-Tokens widerrufen werden.
Einrichtung je Client
Unter Anpassen → Connectors einen eigenen Connector anlegen, https://belege.ai/mcp eintragen und den OAuth-Dialog abschließen.
sevDesk mit Claude — die AnleitungEntwicklermodus aktivieren, unter Apps eine eigene App mit https://belege.ai/mcp anlegen und belege.ai per OAuth freigeben.
sevDesk mit ChatGPT — die Anleitungcodex mcp add belege-ai --url https://belege.ai/mcp, dann codex mcp login belege-ai — danach in App, CLI und IDE verfügbar.
sevDesk mit Codex — die AnleitungSicherheit
Dein belege.ai-Passwort bleibt bei belege.ai. Dein verbundener KI-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. Dein verbundener KI-Agent kann nur auf die Daten zugreifen, die deinem Konto beziehungsweise deiner Organisation freigegeben sind.
belege.ai übermittelt Dein verbundener KI-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.
FAQ
belege.ai stellt einen standardkonformen MCP-Server über deine eigenen Buchungen und Belege bereit. Er konzentriert sich auf fehlende Dokumente, Belegsuche und die Übergabe gefundener PDFs an sevDesk.
Nein. Der MCP arbeitet mit den Buchungen und Dokumenten in belege.ai. Gefundene PDFs werden anschließend über die kontrollierte sevDesk-Integration in den Beleg-Eingang übertragen.
Ja. Claude, ChatGPT, Codex oder Hermes können offene Fälle identifizieren und für eine ausgewählte Liste die gebündelte Suche in verbundenen E-Mail-Postfächern und Portalen starten.
belege.ai lädt gefundene Rechnungen und genehmigte Bewirtungsbelege über eine sichere Browser-Sitzung in den sevDesk-Beleg-Eingang. Dafür wird ein sevDesk-Tarif mit Belegerfassung benötigt.
Der Remote-MCP lässt sich mit Claude, ChatGPT, Codex und Hermes Agent verbinden. Die Autorisierung erfolgt jeweils über OAuth 2.1 mit PKCE.
Immer über denselben Remote-Endpunkt https://belege.ai/mcp: in Claude als eigener Connector, in ChatGPT als App im Entwicklermodus, in Codex per codex mcp add und codex mcp login. Für jeden Client gibt es auf dieser Seite eine eigene Schritt-für-Schritt-Anleitung.
Der Zugriff ist per Row-Level Security auf dein Konto begrenzt, Tokens sind widerrufbar und die belege.ai-Server stehen in Deutschland.
Verbinde zuerst sevDesk als Ziel für gefundene Dokumente und autorisiere danach den MCP in deinem bevorzugten KI-Agenten. Der Einstieg ist kostenlos, ohne Kreditkarte.