MCP-Server für KI-Agenten: E-Rechnungen prüfen
Mit dem MCP-Server von eRechio kann ein KI-Agent oder Assistent eine XRechnung (UBL oder CII) oder das XML einer ZUGFeRD-/Factur-X-Rechnung prüfen lassen und bekommt dieselbe Antwort wie von der REST-API: Schemaprüfung, Regelprüfung nach KoSIT, jede Meldung mit deutscher Erklärung.
Adresse: https://api.erechio.de/mcp · Model Context Protocol, Transport „Streamable HTTP“ · seit API-Version 1.4.0 (22.11.2026). Anmeldung mit dem vorhandenen API-Schlüssel. Testschlüssel sofort erzeugen: kostenlos, 50 Dokumente im Monat.
Wozu
Ein Agent, der Rechnungen entgegennimmt oder erzeugt (etwa in einer Buchhaltungs- oder Automatisierungsumgebung), kann damit selbst prüfen, ob eine Rechnung als XRechnung beziehungsweise ZUGFeRD-XML formal in Ordnung ist, und die Erklärungen zu den Fehlern direkt weiterverarbeiten. Ergebnis und Regeln sind dieselben wie bei POST /v1/validate; der MCP-Server ist nur ein zweiter Zugang zur selben Prüfung.
Einrichtung
Sie brauchen einen API-Schlüssel (pk_…), z. B. den Testschlüssel. Er wird als Header Authorization: Bearer pk_… mitgeschickt (alternativ X-API-Key). OAuth gibt es nicht.
Claude Code
claude mcp add --transport http erechio https://api.erechio.de/mcp --header "Authorization: Bearer pk_IHR_SCHLUESSEL"
Andere Clients (z. B. Cursor, VS Code)
Clients mit Remote-MCP über HTTP lesen die Konfiguration meist aus einer JSON-Datei. Die Feldnamen weichen je nach Client leicht ab; prüfen Sie sie in der Dokumentation Ihres Clients.
{
"mcpServers": {
"erechio": {
"type": "http",
"url": "https://api.erechio.de/mcp",
"headers": {
"Authorization": "Bearer pk_IHR_SCHLUESSEL"
}
}
}
}
Test mit curl
Die Werkzeugliste lässt sich ohne Schlüssel abrufen:
curl -s https://api.erechio.de/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Technik
- Transport „Streamable HTTP“, zustandslos. Anfragen sind
POSTmit JSON-RPC; die Antwort kommt als JSON (kein SSE-Stream).GETundDELETEwerden mit 405 beantwortet. - Protokollversionen: 2025-06-18 (Standard), 2025-03-26 und 2024-11-05.
- Ohne Schlüssel gehen
initialize,tools/listund die Werkzeugeexplain_ruleundget_status. Nurvalidate_invoicebraucht den Schlüssel. - Werkzeugnamen und -beschreibungen sind seit Version 1.5.0 englisch, damit Verzeichnisse und Clients sie einheitlich anzeigen; Ergebnisse und Meldungen bleiben deutsch. Die alten Namen
rechnung_pruefenundstatusnimmt der Server bis mindestens 22.02.2027 weiter an (Änderungen).
Werkzeuge
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
validate_(Rechnung prüfen) | xml (Pflicht): die Rechnung als XML-Text – XRechnung UBL/CII oder das XML einer ZUGFeRD-/Factur-X-Rechnung, höchstens 2 MB.idempotency_key (optional): wie der Header Idempotency-Key, siehe Idempotenz; gleiche Regeln. | structuredContent ist genau die Antwort von POST /v1/validate mit denselben Feldern (vollstaendig_validiert, regelpruefung_bestanden, schemapruefung, meldungen mit erklaerung, kontingent, regelstand usw.; Felder: Antwort). Dazu eine kurze deutsche Zusammenfassung als Text. |
explain_(Regel erklären) | code (Pflicht): ein Regelcode, wie ihn ein Prüfer meldet, z. B. BR-DE-15; auch aus anderen Prüfern wie dem KoSIT-Validator. | Deutsche Erklärung: titel, was (was die Regel verlangt), beheben, pfad_ubl, pfad_cii und mehr (Link auf die Fehlerseite). Erklärt sind die häufigsten Regeln; für andere Codes kommt gefunden: false, kein Fehler. Ohne Schlüssel, zählt nicht. |
get_(Zustand) | keine | Die Antwort von GET /v1/status. Ohne Schlüssel, zählt nicht. |
Verlassen Sie sich bei validate_invoice auf vollstaendig_validiert, nicht auf die Textzusammenfassung. Ein erfolgreicher Aufruf heißt nur: Die Prüfung ist gelaufen, nicht: Die Rechnung ist fehlerfrei.
Limits und Kontingent
Es gelten dasselbe Kontingent und dieselben Limits wie bei der REST-API: Jede erfolgreiche Prüfung zählt ein Dokument im Monatskontingent Ihres Schlüssels (Testschlüssel: 50 Dokumente im Monat), höchstens 60 Prüfungen pro Minute, höchstens 2 MB je Rechnung. Aufrufe über REST und MCP teilen sich dasselbe Kontingent.
Fehler
Fehler der API (401, 413, 422, 429 …) kommen als Werkzeugergebnis mit isError=true und demselben Fehlercode und -text wie in der API (Statuscodes). Ein fehlender oder ungültiger Schlüssel bei validate_invoice ist ein 401.
Datenschutz
Die Rechnung wird nur im Arbeitsspeicher geprüft und danach verworfen, nicht gespeichert, wie bei der REST-API. Protokolliert werden je Prüfung nur Zeitpunkt, Schlüssel-Kennung, Syntax, Ergebnis, Anzahl der Fehler und Laufzeit, ohne IP-Adresse (Einzelheiten: Datenschutz der API). Bedenken Sie: Ihr KI-Client oder dessen Anbieter sieht die Rechnung ebenfalls; das liegt außerhalb von eRechio.
Was es nicht gibt
- Kein Erzeugen von Rechnungen per MCP oder API (das Erzeugen im Browser gibt es unter /erstellen/).
- Keine PDF-Annahme: Senden Sie das XML (bei ZUGFeRD das eingebettete XML).
- Keine inhaltliche oder steuerliche Prüfung.
- Kein OAuth, kein npm-Paket.
Technische Hinweise zum Datenformat, keine Steuer- oder Rechtsberatung. eRechio ist kein Angebot der KoSIT. Zurück zur API-Dokumentation.