sevDesk MCP Server für Claude & ChatGPT

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.

MCP-Adresse für Claude, ChatGPT, Codex und Hermes Agent https://belege.ai/mcp

Welche Belege fehlen noch für meinen sevDesk-Monatsabschluss im Juni?

belege.ai · run_sql · read-only

In deinem belege.ai-Datenbestand sind drei Ausgaben noch ohne Dokument:

05.06.Google Ads 480,00 €
14.06.Hotel Berlin 219,00 €
23.06.Adobe 71,39 €

Ich kann die Suche gesammelt starten. Gefundene PDFs überträgt belege.ai danach in deinen sevDesk-Beleg-Eingang.

Ja, starte die Suche für alle drei.

belege.ai · start_invoice_finder

Erledigt — Zwischenstand des Suchlaufs:

05.06.Google_Ads_Juni.pdf in sevDesk
23.06.Adobe_Rechnung_71-39.pdf in sevDesk
14.06.Hotel Berlin wartet auf 2FA

Die 2FA-Rückfrage fürs Hotelportal kommt gleich per Telegram; danach liegt auch diese Rechnung im Beleg-Eingang.

Beispieldaten. Die Antwort formuliert dein KI-Agent, Buchungen und Belege kommen aus belege.ai.

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.

Der Portal-Login fragt nach — und zwar in Telegram

Rückfragen der Belegsuche, etwa ein Login-Code, schickt dir der belege.ai-Bot per Telegram. Du antwortest dort, und der Suchlauf macht weiter, auch wenn das Gespräch mit dem KI-Agenten längst geschlossen ist.

Was dein KI-Agent für deine sevDesk-Belege tut

Offene Belegfälle abfragen

Der Agent listet Buchungen aus deinem belege.ai-Datenbestand ohne Dokument nach Zeitraum, Anbieter oder Betrag und zeigt vorhandene PDFs direkt im Chat.

Belegsuche im Chat starten

Wähle die betreffenden Ausgaben aus. belege.ai sucht gebündelt in Postfächern und Portalen; Login- und 2FA-Rückfragen kommen über Telegram.

Gefundene PDFs nach sevDesk

Rechnungen und genehmigte Bewirtungsbelege landen kontrolliert im sevDesk-Beleg-Eingang und sind dort bereit zur weiteren Verarbeitung.

Übergabe an sevDesk vorbereiten

Frag, welche Dokumente noch fehlen, welche bereits beschafft wurden und welche gefundenen PDFs für den sevDesk-Beleg-Eingang bereitstehen.

Was du den Agenten konkret fragen kannst

Jede Abfrage läuft über die MCP-Werkzeuge gegen deine eigenen Daten — zum Ausprobieren einfach in Claude, ChatGPT oder Codex einfügen.

  • „Welche Buchungen aus Juli haben noch keinen Beleg für sevDesk?“
  • „Starte die Belegsuche für die drei offenen Google-Ads-Ausgaben.“
  • „Zeig mir die Hotelrechnung aus Berlin vom 14. Juni.“
  • „Was habe ich dieses Jahr bisher für Software-Abos ausgegeben?“
  • „Welche gefundenen PDFs stehen für den sevDesk-Beleg-Eingang bereit?“
  • „Rechne die OpenAI-Rechnung über 20 US-Dollar zum Buchungsdatum in Euro um.“

Welche Werkzeuge einen sevDesk-Lauf tragen

Der MCP-Server stellt acht Werkzeuge bereit. Für einen sevDesk-Ablauf tragen vor allem diese vier die Arbeit.

  • run_sql

    Liest 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_finder

    Startet 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_statusreply_invoice_finder

    Fragt 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_currency

    Rechnet 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.

belege.ai liest, sevDesk empfängt

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.

API-Werkzeug oder Beleg-Agent?

Beide Ansätze heißen MCP, lösen aber unterschiedliche Aufgaben.

AufgabeGenerischer sevDesk-MCPbelege.ai MCP
Kontakte, Angebote und Ausgangsrechnungen verwaltenTypischer SchwerpunktNicht der Zweck
Offene Belegfälle erkennenÜber direkte API-Abfragen möglichJa, im belege.ai-Datenbestand
E-Mails und Lieferantenportale durchsuchenNeinJa, über den Invoice Finder
Login- und 2FA-Rückfragen begleitenNeinJa, über Telegram
Gefundene PDFs in den Beleg-Eingang übertragenAbhängig vom ServerJa, kontrolliert über die sevDesk-Integration

Was der sevDesk-MCP ausdrücklich nicht tut

  • Keine Verwaltung deines sevDesk-Kontos

    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.

  • Keine pauschale Live-Abfrage von sevDesk

    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.

  • Der Agent lädt nichts selbst hoch

    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.

  • Kein Eigenbeleg ohne deine Freigabe

    Bleibt eine Ausgabe ohne Original, entsteht daraus nicht automatisch ein Eigenbeleg. Ein neu erzeugtes Dokument braucht immer deine ausdrückliche Zustimmung.

In drei Schritten verbunden

Funktioniert mit Claude, ChatGPT, Codex und Hermes Agent.

  1. 1

    KI-Agent wählen

    Claude, ChatGPT, Codex oder Hermes Agent öffnen und dort einen eigenen Remote-MCP-Server hinzufügen.

  2. 2

    MCP-Adresse eintragen

    https://belege.ai/mcp als Remote-MCP-Endpunkt eintragen.

  3. 3

    Anmelden & freigeben

    Bei belege.ai anmelden und den Zugriff per OAuth bestätigen — fertig.

https://belege.ai/mcp

Die Anmeldung läuft über OAuth 2.1 mit PKCE. Der Zugriff kann jederzeit unter API-Tokens widerrufen werden.

Claude, ChatGPT und Codex im Detail

Gezielter Zugriff, keine offene Hintertür

  • OAuth 2.1 mit PKCE

    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.

  • Row-Level Security

    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.

  • Minimierte Datenübermittlung

    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.

  • Kontrollierte Aktionen

    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.

Häufige Fragen zum sevDesk-MCP

Gibt es einen sevDesk MCP Server?

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.

Liest der KI-Agent meinen vollständigen sevDesk-Datenbestand?

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.

Kann ein KI-Agent fehlende sevDesk-Belege suchen?

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.

Wie kommen gefundene Belege nach sevDesk?

belege.ai legt gefundene Rechnungen und genehmigte Bewirtungsbelege direkt in deinem sevDesk ab – du gibst die Buchung frei oder verbuchst sie selbst. Dafür wird ein sevDesk-Tarif mit Belegerfassung benötigt.

Welche KI-Agenten unterstützen den MCP?

Der Remote-MCP lässt sich mit Claude, ChatGPT, Codex und Hermes Agent verbinden. Die Autorisierung erfolgt jeweils über OAuth 2.1 mit PKCE.

Wie richte ich den sevDesk MCP Server in Claude, ChatGPT oder Codex ein?

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.

Ist der sevDesk-MCP DSGVO-konform?

Der Zugriff ist per Row-Level Security auf dein Konto begrenzt, Tokens sind widerrufbar und die belege.ai-Server stehen in Deutschland.

sevDesk und deinen KI-Agenten verbinden

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.