E-Rechnungen per KI-Assistent: der RechnungsAPI MCP-Server und das SDK
Die E-Rechnungspflicht in Deutschland wird schrittweise eingeführt, und XRechnung und ZUGFeRD werden zum Standard. Neu ist: Sie müssen dafür keinen Code mehr schreiben. Ihr KI-Assistent prüft, erstellt und liest E-Rechnungen direkt im Gespräch.
Möglich machen das zwei neue Bausteine: der MCP-Server für KI-Assistenten wie Claude und das SDK für Entwickler, die E-Rechnungen in eigener Software verarbeiten. In diesem Beitrag erfahren Sie, was beides kann, wie Sie es in wenigen Minuten einrichten und wann Sie welches Werkzeug nehmen.
Was ist MCP und was bringt es bei E-Rechnungen?
Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten externe Werkzeuge aufrufen. Statt eine Rechnung aus dem Assistenten herauszukopieren, in ein Tool einzufügen und das Ergebnis zurückzukopieren, ruft der Assistent das Werkzeug selbst auf und arbeitet mit dem Ergebnis weiter.
Bei E-Rechnungen ist das besonders praktisch, denn die Prüfmeldungen einer XRechnung sind für Menschen oft schwer lesbar. Der Assistent validiert die Datei, erklärt, welche Pflichtfelder fehlen, und macht direkt einen Korrekturvorschlag.
In normaler Sprache arbeiten
Sie müssen keine Endpunkte kennen. Das passiert, wenn Sie Ihrem Assistenten Folgendes sagen:
„Prüfe diese XRechnung und erkläre mir, was falsch ist.“
validate_xrechnung_xml – Der Assistent validiert gegen Schema und Geschäftsregeln und übersetzt die Prüfmeldungen in verständliche Hinweise.
„Erstelle eine XRechnung für diesen Auftrag: Kunde, drei Positionen, 19 % USt.“
create_xrechnung – Aus Ihrer Beschreibung baut der Assistent die Rechnungsdaten und erzeugt das XML.
„Lies diese Rechnung als PDF aus und gib mir die Daten als JSON.“
analyze_pdf_invoice – Die Felder werden aus PDF, Scan oder Foto extrahiert.
„Mach aus dieser PDF-Rechnung eine ZUGFeRD-Rechnung.“
create_zugferd_from_pdf – Das PDF geht hinein, ein validiertes ZUGFeRD-PDF kommt heraus, in einem Schritt.
In einer Minute verbunden
Sie brauchen nur Ihren RechnungsAPI-Token. Registrieren Sie sich kostenlos, öffnen Sie im Dashboard das Profil und kopieren Sie den Token. Danach haben Sie zwei Möglichkeiten.
Variante 1: gehostet, nichts zu installieren
Tragen Sie den von uns betriebenen Server in Ihren MCP-Client ein, zum Beispiel als .mcp.json in Ihrem Projekt für Claude Code:
{
"mcpServers": {
"rechnungsapi": {
"type": "http",
"url": "https://mcp.rechnungsapi.de/mcp",
"headers": { "Authorization": "Bearer IHR-API-TOKEN" }
}
}
}Variante 2: lokal mit npx
Wenn Sie den Server lieber selbst starten, genügt Node.js 20 oder neuer. Derselbe Eintrag funktioniert für Claude Code und Claude Desktop:
{
"mcpServers": {
"rechnungsapi": {
"command": "npx",
"args": ["-y", "rechnungsapi-mcp"],
"env": {
"RECHNUNGSAPI_TOKEN": "IHR-API-TOKEN"
}
}
}
}Der Server funktioniert mit Claude Code, Claude Desktop und Open WebUI sowie mit jedem MCP-Client, der Streamable HTTP mit eigenem Header oder stdio spricht.
Zehn Werkzeuge für den E-Rechnungs-Alltag
Jedes Werkzeug entspricht einem Endpunkt der RechnungsAPI. Anfrage und Antwort sind in der API-Dokumentation beschrieben.
| Werkzeug | Aufgabe |
|---|---|
create_xrechnung | Erzeugt eine XRechnung (XML) aus strukturierten Rechnungsdaten |
create_zugferd_invoice | Erzeugt ein ZUGFeRD-PDF/A-3 aus Rechnungsdaten und einem PDF-Layout |
create_zugferd_pdf | Bettet eine vorhandene XRechnung in ein sichtbares PDF ein |
create_zugferd_from_pdf | Macht aus einem PDF oder Scan in einem Schritt ein validiertes ZUGFeRD-PDF |
validate_xrechnung_xml | Prüft eine XRechnung gegen Schema und Geschäftsregeln |
validate_zugferd_pdf | Prüft das eingebettete XML eines ZUGFeRD-PDFs |
extract_xrechnung_from_zugferd | Liest das eingebettete XML aus einem ZUGFeRD-PDF als JSON aus |
analyze_pdf_invoice | Extrahiert strukturierte Rechnungsdaten aus PDF, Scan oder Foto |
analyze_pdf_invoice_async_submit / _status | Asynchrone Analyse für große Dateien: einreichen und Status abfragen |
Dateien werden als Base64-Text übertragen. Das passt gut für einzelne Rechnungen. Für große Mengen nutzen Sie das SDK oder die REST-API direkt. Wie die REST-API in No-Code-Werkzeugen läuft, zeigt unser Tutorial zu n8n, Make und Zapier; alle Endpunkte lassen sich außerdem im Playground ausprobieren.
Datenschutz und Sicherheit
Ihr Token, Ihre Daten. Jede Anfrage trägt den Token des jeweiligen Aufrufers. Zwischen Kunden wird nichts geteilt, und es gibt keine gemeinsame Zugangskennung auf dem Server.
Keine Rechnungen auf dem Server. Der gehostete MCP-Server speichert nichts. Seine Logs enthalten nur Metadaten wie Pfad, Status und Dauer, nie Rechnungsinhalte, Tool-Argumente oder Token.
Verschlüsselt und in Deutschland. Der Endpunkt ist per HTTPS erreichbar, die Verarbeitung der RechnungsAPI erfolgt auf deutschen Servern, ausgelegt für EN 16931, GoBD und DSGVO.
Selbst betreiben möglich. Wer keine Rechnungsdaten über einen fremden Server leiten will, startet den Server lokal oder betreibt ihn selbst, etwa als Docker-Container im eigenen Netz.
Das SDK: E-Rechnungen in wenigen Zeilen Code
Der MCP-Server ist für das Gespräch gedacht. Wenn Ihre eigene Software E-Rechnungen verarbeitet, ist rechnungsapi-sdk die bessere Wahl: ein typisiertes TypeScript/JavaScript-Paket ohne Laufzeit-Abhängigkeiten. Der MCP-Server selbst baut auf diesem SDK auf.
npm install rechnungsapi-sdk
import { RechnungsApiClient } from "rechnungsapi-sdk"
const client = new RechnungsApiClient({ apiToken: process.env.RECHNUNGSAPI_TOKEN! })
// 1. XRechnung vor dem Versand validieren
const validation = await client.validateXRechnungXml(xmlString)
if (!validation.isValid) {
console.log(validation.messages)
}
// 2. Scan oder PDF-Rechnung in strukturierte Daten verwandeln
const extracted = await client.analyzePdfInvoiceV2(pdfBase64, true)
// 3. PDF direkt in eine ZUGFeRD-Rechnung umwandeln
const zugferd = await client.createZugferdFromPdf(pdfBase64)Erstellen und versenden in einem Aufruf
Mit der Option transport wird die erzeugte Rechnung im selben Aufruf per E-Mail verschickt, DKIM-signiert und ohne eigene Mail-Infrastruktur. Der E-Mail-Versand wird pro Konto freigeschaltet, und Ihre Absender-Domain muss einmal authentifiziert werden. Details stehen im Abschnitt „E-Mail-Transport“ der API-Dokumentation.
await client.createXRechnungFromJson(
{ invoiceNumber: "RE-2026-002", /* ... */ },
{
transport: {
type: "email",
useTransport: true,
sender: "rechnung@ihre-domain.de",
senderName: "Ihre Firma",
receiver: "buchhaltung@kunde.de",
subject: "Rechnung {invoicenumber} vom {invoicedate}",
message: "<p>Guten Tag, anbei Rechnung {invoicenumber}.</p>",
},
},
)Fehler werden als RechnungsApiError geworfen, fehlende Pflichtfelder (HTTP 412) als ValidationFailedError. Die Rechnungsobjekte folgen EN 16931.
MCP-Server, SDK oder REST-API: was passt wann?
| MCP-Server | SDK | REST-API | |
|---|---|---|---|
| Für wen | Anwender im Gespräch mit einem KI-Assistenten | Entwickler mit TypeScript oder JavaScript | Jede Sprache und jedes System |
| Typischer Einsatz | Einzelne Rechnungen prüfen, erstellen, auslesen | ERP-Anbindung, Backends, Batch-Läufe | Eigene Integration, No-Code mit n8n, Make, Zapier |
| Einrichtung | Eintrag in der Client-Konfiguration | npm install | HTTP-Request mit Bearer-Token |
Häufige Fragen
Brauche ich den MCP-Server oder das SDK?
Wenn ein Mensch im Gespräch mit einem KI-Assistenten einzelne Rechnungen prüfen, erstellen oder auslesen will, ist der MCP-Server richtig. Wenn Ihre Software E-Rechnungen automatisiert verarbeitet, etwa im ERP oder in einem Batch-Lauf, nehmen Sie das SDK oder direkt die REST-API.
Was kostet die Nutzung?
MCP-Server und SDK sind kostenlos und stehen unter MIT-Lizenz. Es fallen die normalen Kosten Ihres RechnungsAPI-Tarifs an. Der Einstieg ist ohne Kreditkarte kostenlos möglich, Details unter rechnungsapi.de/pricing.
Wie groß dürfen die Dateien sein?
Dateien werden als Base64-Text übertragen, das passt gut für einzelne Rechnungen. Bei großen Scans nutzen Sie die asynchrone Analyse. Für Massenverarbeitung empfehlen wir SDK oder REST-API.
Jetzt Ihren Assistenten verbinden
Kostenlos registrieren, Token kopieren, Eintrag in die Client-Konfiguration: in wenigen Minuten prüft und erstellt Ihr Assistent E-Rechnungen. Keine Kreditkarte erforderlich.
Quellen
Model Context Protocol (modelcontextprotocol.io); npm-Pakete rechnungsapi-mcp und rechnungsapi-sdk (MIT-Lizenz); RechnungsAPI-Dokumentation unter rechnungsapi.de/api-docs; EN 16931.