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.
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.
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
- Ö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.
- Trag den Schlüssel als
Authorization-Header in deinem KI-Client ein – zum Beispiel mit dem Befehl rechts für Claude Code. - Stell deine erste Frage, etwa: „Welche E-Rechnungen sind diesen Monat fehlgeschlagen?“
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?“claude mcp add --transport http exportly-erechnung https://mcp.exportly.de \
--header "Authorization: Bearer erk_test_…"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.
https://mcp.exportly.de
Transport: Streamable HTTP (zustandslos)
Header: Authorization: Bearer erk_test_…curl https://mcp.exportly.de \
-H "Authorization: Bearer erk_test_…" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Einstieg
Tarife und Limits
| Modus | Schlüssel | Verfügbar |
|---|---|---|
| Testmodus | erk_test_… | in jedem Tarif |
| Live-Modus | erk_live_… | Business und Enterprise |
| Live-Modus mit Pro | erk_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.
| Limit | Wert |
|---|---|
| Anfragen | 60 je Minute – gemeinsam mit der Abruf-API |
| Aktionen | zusätzlich höchstens 20 je Minute |
| Versand | je Dokument höchstens einmal je Minute |
| Einzelbelege | rund 90 Tage; ältere als Monatszähler und im GoBD-Archiv der App |
| Auswertung | bis 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.
claude mcp add --transport http exportly-erechnung https://mcp.exportly.de \
--header "Authorization: Bearer erk_test_…"claude mcp add --transport http exportly-erechnung --scope user https://mcp.exportly.de \
--header "Authorization: Bearer erk_test_…"{
"mcpServers": {
"exportly-erechnung": {
"type": "http",
"url": "https://mcp.exportly.de",
"headers": {
"Authorization": "Bearer ${EXPORTLY_ERECHNUNG_KEY}"
}
}
}
}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.
{
"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}.
{
"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_documentsSucht 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_documentsListet 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_documentStatus, 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_issueErklä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_periodWertet 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_invoicesOffene 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_invoiceDie 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_customerFindet 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_settingsFormat (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 ConnectDeine Händler (verbundene Konten) mit fehlenden Pflichtfeldern, Design und wartenden Rechnungen.
- „Welche Händler haben unvollständige Stammdaten?“
Händler im Detail
get_sellerStripe ConnectStammdaten, fehlende Pflichtfelder, Rechnungsdesign und wartende Rechnungen eines Händlers.
- „Was fehlt bei acct_1NordLicht7 noch?“
Eigene Absender-Domain
get_sender_domainStatus 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_documentErzeugt 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_documentVersendet 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_settingsSetzt 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 ConnectLegt 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 ConnectEntfernt 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_testSendet 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ü.
| Ablauf | Was er tut | Angaben |
|---|---|---|
Monatsabschluss prüfenmonatsabschluss_pruefen | Prü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_beheben | Findet 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_pruefen | Stripe 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.