exportly

Deine E-Rechnungen im KI-Assistenten

Mit dem MCP-Server von „Exportly E-Rechnung“ fragst du Claude, Cursor oder VS Code einfach, was mit deinen E-Rechnungen los ist – und lässt Fehler erklären, Zeiträume auswerten und Rechnungen neu erzeugen oder versenden.

Live im Stripe App MarketplaceTestmodus in jedem Tarif · live mit Business und Enterprise, für Pro als Zusatzpaket „MCP live“ (ab Version 1.9)

Einführung

Frag einfach nach deinen E-Rechnungen

MCP (Model Context Protocol) ist der offene Standard, über den KI-Assistenten auf Werkzeuge zugreifen. Der MCP-Server von „Exportly E-Rechnung“ gibt deinem Assistenten Zugriff auf die E-Rechnungen deines Stripe-Kontos – lesend und, wenn du es bestätigst, auch handelnd.

  • Fragen und auswerten: E-Rechnungen suchen, Fehler erklären lassen, Monate auswerten, offene Rechnungen prüfen.
  • Aktionen: E-Rechnungen neu erzeugen oder versenden, Kunden-Einstellungen setzen, Händler pflegen.
  • Fertige Abläufe: Monatsabschluss prüfen, fehlgeschlagene E-Rechnungen beheben, Händler-Onboarding prüfen.

Insgesamt 19 Werkzeuge (12 zum Fragen, 7 Aktionen) und 3 fertige Abläufe. Für Entwickler, die Dokumente automatisch abholen wollen, gibt es weiterhin die Abruf-API und Webhooks.

So sieht das aus
Du:  Welche E-Rechnungen sind diesen Monat
     fehlgeschlagen – und warum?

KI:  → search_documents  (status: failed, Zeitraum)
     → explain_document_issue  (je Treffer)

     2 E-Rechnungen sind fehlgeschlagen:
     – Rechnung 2026-0142: Händler ohne USt-IdNr.
       Nächster Schritt: Stammdaten ergänzen …
     – Gutschrift GS-0031: …

Schnellstart

In drei Schritten verbunden

  1. Öffne die App im Stripe-Dashboard unter Einstellungen → Exportly E-Rechnung → Reiter „API“ und erzeuge einen API-Schlüssel. Das geht nur als Administrator des Stripe-Kontos. Es ist derselbe Schlüssel wie für die Abruf-API.
  2. Trag den Schlüssel als Authorization-Header in deinem KI-Client ein – zum Beispiel mit dem Befehl rechts für Claude Code.
  3. Stell deine erste Frage, etwa: „Welche E-Rechnungen sind diesen Monat fehlgeschlagen?“
Schnellstart
1. Stripe → Einstellungen → Exportly E-Rechnung
   → Reiter „API“ → Schlüssel erzeugen
2. Schlüssel als Bearer-Header im Client eintragen
3. Fragen: „Welche E-Rechnungen sind
   diesen Monat fehlgeschlagen?“

Einstieg

Endpunkt und Anmeldung

Der MCP-Server liegt unter https://mcp.exportly.de. Er spricht Streamable HTTP und arbeitet zustandslos – jede Anfrage steht für sich, es gibt keine Sitzungen.

Angemeldet wird mit deinem API-Schlüssel als Bearer-Token im Authorization-Header. Ein Schlüssel gilt für ein Stripe-Konto und einen Modus:

  • erk_test_… sieht nur Testdaten,
  • erk_live_… sieht nur Live-Daten.

Fehlt der Schlüssel, ist er ungültig oder widerrufen, antwortet der Server mit HTTP 401. Schlüssel erzeugst und widerrufst du im Reiter „API“ der App; mehr dazu in der API-Dokumentation.

Verbindung
https://mcp.exportly.de

Transport:  Streamable HTTP (zustandslos)
Header:     Authorization: Bearer erk_test_…

Einstieg

Tarife und Limits

Verfügbarkeit nach Modus
ModusSchlüsselVerfügbar
Testmoduserk_test_…in jedem Tarif
Live-Moduserk_live_…Business und Enterprise
Live-Modus mit Proerk_live_…Zusatzpaket „MCP live“: 9,90 € / Monat oder 99 € / Jahr (ab Version 1.9)

Das Zusatzpaket „MCP live“ buchst du in der App unter Einstellungen → Tarif → „Zusatzpakete“ über den Stripe-Checkout – nur im Live-Modus, im gleichen Intervall wie dein Tarif und zum Periodenende kündbar. Wechselst du von Pro zu Business, endet das Paket automatisch mit anteiliger Gutschrift, denn Business enthält MCP live. Preise netto zzgl. USt.

Ohne Live-Freischaltung kann sich dein Client trotzdem verbinden; jedes Werkzeug antwortet dann mit einem Hinweis auf die passenden Tarife. Funktionen für Händler (Stripe Connect) setzen im Live-Modus die Connect-Freischaltung voraus, die zu Enterprise gehört; Webhooks im Live-Modus gehören zu Business.

Limits je API-Schlüssel
LimitWert
Anfragen60 je Minute – gemeinsam mit der Abruf-API
Aktionenzusätzlich höchstens 20 je Minute
Versandje Dokument höchstens einmal je Minute
Einzelbelegerund 90 Tage; ältere als Monatszähler und im GoBD-Archiv der App
Auswertungbis zu 366 Tage je Abfrage

Wird das Anfrage-Limit überschritten, antwortet der Server mit HTTP 429 und einem Retry-After-Header.

Einrichtung

Claude Code

Ein Befehl im Terminal genügt. Ohne weitere Angabe gilt der Server nur für dich im aktuellen Projekt; mit --scope user in all deinen Projekten. Anschließend zeigt /mcp in Claude Code, ob die Verbindung steht.

Willst du den Server über eine .mcp.json mit deinem Team teilen, trag dort keinen Schlüssel ein, sondern eine Umgebungsvariable wie ${EXPORTLY_ERECHNUNG_KEY} – jede Person setzt sie mit ihrem eigenen Schlüssel.

Terminal
claude mcp add --transport http exportly-erechnung https://mcp.exportly.de \
  --header "Authorization: Bearer erk_test_…"

Einrichtung

Cursor

Leg die Datei .cursor/mcp.json im Projekt an (oder ~/.cursor/mcp.json für alle Projekte). Cursor setzt ${env:EXPORTLY_ERECHNUNG_KEY} aus deiner Umgebung ein – so steht der Schlüssel nicht in der Datei.

Konfiguration
{
  "mcpServers": {
    "exportly-erechnung": {
      "url": "https://mcp.exportly.de",
      "headers": {
        "Authorization": "Bearer ${env:EXPORTLY_ERECHNUNG_KEY}"
      }
    }
  }
}

Einrichtung

VS Code

In .vscode/mcp.json fragt VS Code den Schlüssel beim ersten Start über ein verdecktes Eingabefeld ab und speichert ihn – in der Datei selbst steht nur der Platzhalter ${input:exportly-erechnung-key}.

Konfiguration
{
  "inputs": [
    {
      "type": "promptString",
      "id": "exportly-erechnung-key",
      "description": "Exportly E-Rechnung: API-Schlüssel (erk_test_… oder erk_live_…)",
      "password": true
    }
  ],
  "servers": {
    "exportly-erechnung": {
      "type": "http",
      "url": "https://mcp.exportly.de",
      "headers": {
        "Authorization": "Bearer ${input:exportly-erechnung-key}"
      }
    }
  }
}

Einrichtung

Weitere Clients

Der Server funktioniert mit jedem MCP-Client, der Streamable HTTP mit einem eigenen Authorization-Header unterstützt. Du brauchst nur zwei Angaben: die Adresse https://mcp.exportly.de und den Header Authorization: Bearer erk_test_….

Funktionen

Fragen und auswerten

Diese 12 Werkzeuge lesen nur und ändern nichts. Du musst ihre Namen nicht kennen – frag in deinen eigenen Worten, der Assistent wählt das passende Werkzeug.

  • E-Rechnungen suchen

    search_documents

    Sucht in den E-Rechnungen der letzten rund 90 Tage – nach Kundenname, E-Mail oder Rechnungsnummer, Status, Format, Zustellung, Betrag, Zeitraum oder Händler.

    • „Welche E-Rechnungen sind diesen Monat fehlgeschlagen?“
    • „Zeig mir alle Rechnungen an Lumen Studio über 1.000 Euro.“
  • Nach Änderung auflisten

    list_documents

    Listet E-Rechnungen und Gutschriften, die sich seit einem Zeitpunkt geändert haben – genau wie die Abruf-API.

    • „Was hat sich seit gestern 18 Uhr geändert?“
  • E-Rechnung im Detail

    get_document

    Status, Beträge, Empfänger, Versandprotokoll, Fehler und Warnungen einer E-Rechnung, dazu Download-Links für PDF und XML (15 Minuten gültig).

    • „Gib mir den Download-Link für Rechnung 2026-0142.“
  • Problem erklären

    explain_document_issue

    Erklärt Fehler, Warnungen und Zustellprobleme in verständlichen Worten – mit konkreten nächsten Schritten.

    • „Warum ist die E-Rechnung zu in_1QxLumen7hK2 fehlgeschlagen?“
  • Zeitraum auswerten

    summarize_period

    Wertet bis zu 366 Tage aus: Anzahl je Status, Rechnungen und Gutschriften, versendet, unzustellbar, Bruttosummen je Währung.

    • „Wie viele E-Rechnungen haben wir im Oktober erzeugt und versendet?“
  • Offene und überfällige Rechnungen

    list_open_or_overdue_invoices

    Offene Stripe-Rechnungen, auf Wunsch nur überfällige, jeweils mit dem Status der E-Rechnung.

    • „Haben alle säumigen Kunden ihre E-Rechnung bekommen?“
  • Stripe-Rechnung lesen

    get_stripe_invoice

    Die Angaben einer Stripe-Rechnung, die in die E-Rechnung einfließen: Positionen, Steuern, Kunde, Zahlungsstatus, Fälligkeit, zugehörige Gutschriften.

    • „Welche Steuersätze stehen auf Rechnung in_1QxLumen7hK2?“
  • Stripe-Kunden finden

    find_customer

    Findet Kunden per Name oder E-Mail – nur Name, E-Mail, Land, Steuerstatus und E-Rechnungs-Angaben.

    • „Welche Kunden-ID hat die Stadtverwaltung Musterstadt?“
  • E-Rechnungs-Einstellungen eines Kunden

    get_customer_einvoice_settings

    Format (ZUGFeRD oder XRechnung), Leitweg-ID und abweichende Empfänger-Mail eines Kunden – mit Herkunft des wirksamen Werts.

    • „Bekommt dieser Kunde XRechnung, und mit welcher Leitweg-ID?“
  • Händler auflisten

    list_sellersStripe Connect

    Deine Händler (verbundene Konten) mit fehlenden Pflichtfeldern, Design und wartenden Rechnungen.

    • „Welche Händler haben unvollständige Stammdaten?“
  • Händler im Detail

    get_sellerStripe Connect

    Stammdaten, fehlende Pflichtfelder, Rechnungsdesign und wartende Rechnungen eines Händlers.

    • „Was fehlt bei acct_1NordLicht7 noch?“
  • Eigene Absender-Domain

    get_sender_domain

    Status deiner eigenen Absender-Domain mit den DNS-Einträgen und der Adresse, von der gerade versendet wird. Ab Version 1.9.

    • „Ist unsere Absender-Domain schon verifiziert?“

Funktionen

Aktionen

Diese 7 Werkzeuge ändern etwas. Der Server weist deinen Assistenten an, jede Aktion vorher bei dir bestätigen zu lassen; viele Clients fragen ohnehin nach, bevor sie ein Werkzeug ausführen. Aktionen nutzen dieselbe Logik und dieselben Prüfungen wie die App und werden protokolliert.

  • E-Rechnung neu erzeugen

    regenerate_document

    Erzeugt die E-Rechnung zu einer Stripe-Rechnung oder Gutschrift neu, etwa nach einer Korrektur. Versendet nichts; die Beträge kommen unverändert aus Stripe.

    • „Erzeuge die fehlgeschlagene Rechnung 2026-0142 neu.“
  • E-Rechnung versenden

    send_document

    Versendet eine erzeugte E-Rechnung per E-Mail an den Kunden, auch erneut – höchstens einmal je Minute und Dokument. Im Testmodus geht die Mail nur an deine eigene Adresse.

    • „Schick Rechnung 2026-0142 noch einmal an den Kunden.“
  • Kunden-Einstellungen setzen

    set_customer_einvoice_settings

    Setzt Format, Leitweg-ID oder Empfänger-Mail eines Kunden in der App – mit derselben Prüfung wie in der App. Der Stripe-Kunde selbst bleibt unverändert.

    • „Stell die Stadtverwaltung Musterstadt auf XRechnung um.“
  • Händler-Stammdaten speichern

    upsert_sellerStripe Connect

    Legt die Stammdaten eines Händlers an oder ersetzt sie. Wartende Rechnungen des Händlers werden danach automatisch erzeugt.

    • „Trag für acct_1NordLicht7 diese Anschrift und USt-IdNr. ein: …“
  • Händler-Design ändern

    set_seller_designStripe Connect

    Ändert Vorlage, Akzentfarbe, Schrift, Logo oder Mailtext eines Händlers.

    • „Setz die Akzentfarbe von acct_1NordLicht7 auf #0F766E.“
  • Händler-Design zurücksetzen

    reset_seller_designStripe Connect

    Entfernt das eigene Design eines Händlers – danach gilt wieder das Design deiner Plattform.

    • „Nimm für acct_1NordLicht7 wieder unser Standard-Design.“
  • Webhook testen

    send_webhook_test

    Sendet ein Testereignis an den Webhook, den du in der App eingerichtet hast – wie „Test senden“ im Reiter „API“.

    • „Schick ein Testereignis an unseren Webhook.“

Mit einem Testschlüssel betreffen Aktionen nur Testdaten; Mails im Testmodus gehen ausschließlich an deine eigene Adresse.

Funktionen

Fertige Abläufe

Für wiederkehrende Aufgaben bringt der Server 3 fertige Abläufe (MCP-Prompts) mit. In vielen Clients findest du sie als Befehl oder im Prompt-Menü.

Fertige Abläufe (Prompts)
AblaufWas er tutAngaben
Monatsabschluss prüfenmonatsabschluss_pruefenPrüft einen Monat auf Vollständigkeit, Fehler, unzustellbare Mails und überfällige Rechnungen und fasst Summen je Währung zusammen.monat (JJJJ-MM)
Fehlgeschlagene E-Rechnungen behebenfehlgeschlagene_behebenFindet fehlgeschlagene E-Rechnungen, erklärt die Ursachen, gruppiert sie und schlägt Korrekturen vor. Neu erzeugt wird erst nach deiner Bestätigung.tage (optional, Standard 30)
Händler-Onboarding prüfenhaendler_onboarding_pruefenStripe Connect: zeigt je Händler, welche Pflichtangaben fehlen, welches Design gilt und wie viele Rechnungen warten.keine

Sicherheit

Schlüssel und Zugriff

  • Nur dein Konto: Konto und Modus ergeben sich ausschließlich aus dem Schlüssel. Der Assistent sieht nur dein Stripe-Konto – als Plattform mit Stripe Connect zusätzlich deine eigenen Händler, sonst nichts.
  • Schlüssel wie Passwörter behandeln: Leg ihn nie in geteilten Konfigurationen oder Quellcode-Repositories ab. Nutze Umgebungsvariablen oder die verdeckte Eingabe deines Clients.
  • Jederzeit widerrufbar: Im Reiter „API“ der App widerrufst du einen Schlüssel jederzeit – ab dann lehnt der Server ihn ab.
  • Erst testen: Mit einem erk_test_…-Schlüssel kommt der Assistent nicht an Live-Daten.

Sicherheit

Was der Server nicht kann

Der MCP-Server ist bewusst auf E-Rechnungen beschränkt. Er kann nicht:

  • Stripe-Rechnungen, Zahlungen, Kunden oder Abos ändern,
  • Zahlungsdaten lesen,
  • Dokumente aus dem GoBD-Archiv löschen,
  • API-Schlüssel, Tarif oder Abrechnung verwalten.

Fragen oder Wünsche zum MCP-Server? Schreib uns.