E-Rechnung per MCP

Eine KI kann Rechnungsdaten verstehen, aber keine gültige E-Rechnung garantieren. Dafür braucht sie ein Werkzeug, das nach den Regeln der EN 16931 arbeitet und jede Datei prüft. Über MCP bekommt Ihr Assistent genau dieses Werkzeug: XRIO.

Was ist MCP?

MCP steht für Model Context Protocol – ein offener Standard, über den KI-Assistenten externe Werkzeuge aufrufen. Ein MCP-Server beschreibt seine Werkzeuge: was sie tun, welche Angaben sie brauchen, was sie zurückgeben. Die KI entscheidet im Gespräch selbst, wann sie ein Werkzeug aufruft, und arbeitet mit dem Ergebnis weiter.

Für E-Rechnungen heißt das: Sie sprechen mit Ihrer KI wie bisher. Wenn eine Rechnung entstehen soll, ruft die KI das passende Werkzeug von XRIO auf und bekommt eine geprüfte Datei zurück – oder eine genaue Liste, was noch fehlt.

Die Werkzeuge von XRIO

Werkzeug	Was passiert	Preis
validate_invoice	PDF oder XML gegen die offiziellen Regeln prüfen (KoSIT-Validator)	0,05 €
generate_invoice	Aus Rechnungsdaten eine XRechnung (XML) und ZUGFeRD-PDF erzeugen, vorher geprüft	0,25 € je E-Rechnung
render_invoice	XML prüfen und als PDF zum Lesen ausgeben (PDF-Ansicht)	0,25 €
lookup_rule	Eine Regel im Originalwortlaut der offiziellen Quelle nachschlagen	kostenlos

Dazu kommen kostenlose Werkzeuge für Ihre Firmendaten, Bankverbindungen, Ihr Logo, Ihre Einstellungen und den Verlauf der letzten 7 Tage, describe_invoice_fields und describe_invoice_types für die Felder und Rechnungsarten sowie get_job: Dauert ein Ergebnis länger, kommt ein Auftrag zurück, den die KI damit abfragt. Werkzeuge, die etwas ändern, nutzt die KI nur auf Ihre ausdrückliche Bitte.

Die Werkzeuge sind eine dünne Schicht über dieselben Funktionen wie die E-Rechnung-API – gleiche Prüfung, gleiche Ergebnisse, gleiche Preise. Alle Preise netto, Details unter Preise.

XRIO verbinden

Der MCP-Server von XRIO ist erreichbar unter https://api.xrio.de/mcp (Streamable HTTP). Ihr Assistent meldet sich mit einem API-Schlüssel an. Den Schlüssel erzeugen Sie im XRIO-Portal unter „API-Schlüssel” und legen ihn in die Umgebungsvariable XRIO_API_KEY – er steht nie im Befehl und in keiner Datei. Das gilt für Claude Code, Cursor, VS Code, die Gemini CLI, die Codex CLI und jeden MCP-Client, der einen eigenen Header senden kann.

In Claude Code genügt ein Befehl:

claude mcp add-json xrio '{"type":"http","url":"https://api.xrio.de/mcp","headers":{"Authorization":"Bearer ${XRIO_API_KEY}"}}' --scope user

In Cursor tragen Sie XRIO in die MCP-Konfiguration ein (.cursor/mcp.json):

{
  "mcpServers": {
    "xrio": {
      "url": "https://api.xrio.de/mcp",
      "headers": { "Authorization": "Bearer ${env:XRIO_API_KEY}" }
    }
  }
}

Die Einrichtung für die Gemini CLI zeigt die Seite E-Rechnung mit Gemini erstellen.

Wie Dateien reisen

Eine Datei läuft bei XRIO nie durch Ihre KI. Das hat zwei Gründe: Eine Kopie, die ein Sprachmodell abtippt, ist nicht das Original. Und eine Datei im Gesprächsverlauf belegt viel Platz im Kontext der KI.

• Erstellen: Ihre KI übergibt nur Werte – Käufer, Positionen, Beträge, Daten. Über MCP sieht XRIO Ihr Ausgangsdokument also nie.
• Prüfen: Das Werkzeug gibt Ihrem Agenten einen einmaligen Upload-Link, 10 Minuten gültig. Der Agent schickt die Datei direkt dorthin, XRIO prüft sie sofort und bewahrt sie nicht auf.
• Ergebnisse: Fertige Dateien kommen als Download-Link, 24 Stunden gültig. XRIO hält sie 7 Tage bereit und löscht sie dann.

Befunde, mit denen Ihre KI arbeiten kann

Besteht eine Rechnung die Prüfung nicht, liefert XRIO keine Datei, sondern Befunde. Jeder Befund nennt die Regel, die Stelle, die Anforderung im Wortlaut der offiziellen Quelle und die Quelle selbst:

Regel:        BR-DE-1
Stufe:        error
Anforderung:  „Eine Rechnung (INVOICE) muss Angaben zu "PAYMENT INSTRUCTIONS" (BG-16) enthalten."
Quelle:       XRechnung (KoSIT)

Solche Befunde kommen als normales Werkzeug-Ergebnis bei Ihrer KI an, nicht als technischer Fehler. Die KI sieht also, was fehlt, fragt Sie gezielt nach und ruft das Werkzeug erneut auf. Abgelehnte Versuche kosten nichts – die KI darf so lange korrigieren, bis die E-Rechnung gültig ist.

XRIO selbst ändert oder errät dabei keinen Wert. Korrekturen kommen immer vom Aufrufer, die Verantwortung für den Inhalt der Rechnung bleibt beim Rechnungssteller.

Warum MCP statt eigener Programmierung?

Mit der REST-API binden Sie XRIO in Ihre Software ein. MCP lohnt sich, wenn Rechnungen im Gespräch entstehen: aus einer Notiz, einer E-Mail, einem Angebot oder einer alten PDF-Rechnung. Sie programmieren nichts – Ihre KI liest die Werkzeugbeschreibung und weiß, welche Angaben eine E-Rechnung braucht.