MCP-Server

Geben Sie Claude, Cursor oder jedem MCP-fähigen KI-Agenten direkten Zugriff auf E-Invoicing — validieren, reparieren, erzeugen und konvertieren Sie EU-Rechnungen direkt aus einem Gespräch heraus, ohne separate Integration.

Worum es geht

CrateAPI stellt einen Model-Context-Protocol-(MCP-)Server für die E-Invoicing-API bereit. Richten Sie einen MCP-fähigen Agenten — Claude Desktop, Claude Code, Cursor oder Ihre eigene Agenten-Schleife — darauf aus, und er erhält vier Werkzeuge, die er direkt aufrufen kann: eine Rechnung validieren, reparieren, aus strukturierten Daten erzeugen oder zwischen UBL- und CII-Syntax konvertieren. Der Agent liest die Werkzeugbeschreibungen und entscheidet selbst, wann er sie einsetzt; die eigentliche Rechnungslogik läuft auf derselben deterministischen API wie der Rest von CrateAPI.

Verfügbare Werkzeuge

Vier Werkzeuge, ein Prozess. Jedes leitet an genau dieselbe öffentliche API weiter, die Sie auch per HTTP aufrufen können — gleiche Regeln, gleiche Limits, gleiche Antworten.

validate_invoicekostenlos

Prüft eine Rechnungs-XML (UBL oder CII) gegen die offiziellen Regeln von EN 16931, Peppol BIS, XRechnung, RO_CIUS und BR-FR. Liefert einen strukturierten Bericht — gültig oder nicht, Anzahl der Fehler/Warnungen, Befunde. Kein API-Schlüssel nötig.

repair_invoiceAPI-Schlüssel erforderlich

Automatische Reparatur nach bestem Aufwand: korrigiert nicht-ISO-Datumsformate und Summen, die nicht aufgehen, neu berechnet aus den Positionszeilen. Erfindet niemals fehlende Geschäftsdaten — meldet, was repariert werden konnte und was nicht.

generate_invoiceAPI-Schlüssel erforderlich

Erstellt eine konforme Rechnungs-XML (UBL oder CII) aus einem strukturierten JSON-Rechnungsmodell — Verkäufer, Käufer, Positionen, Summen.

convert_invoiceAPI-Schlüssel erforderlich

Konvertiert eine Rechnung zwischen UBL- und CII-Syntax, verlustfrei oder abgelehnt: Lässt sich etwas nicht sauber konvertieren, schlägt der Vorgang mit einer klaren Begründung fehl, statt Daten still zu verlieren.

So betreiben Sie ihn

Selbst gehostet, funktioniert schon heute mit Ihrem eigenen API-Schlüssel. Fügen Sie dies zur Konfiguration Ihres MCP-Clients hinzu — Claude Desktop, Claude Code, Cursor oder jeder andere MCP-fähige Agent:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice benötigt überhaupt keinen Schlüssel. Die anderen drei lesen EINVOICE_API_KEY aus der Umgebung — holen Sie sich einen auf der Preisseite. EINVOICE_API_BASE kann die Ziel-API überschreiben, nützlich für eine lokale oder Staging-Instanz.

Heute selbst gehostet. Es gibt noch keinen gehosteten mcp.crateapi.com-Endpunkt — Sie betreiben den Server selbst, ein einzelner Python-Prozess (python -m einvoicing.mcp_server), der dieselbe Produktions-API mit Ihrem eigenen Schlüssel aufruft. Falls genug Bedarf für eine gehostete Version entsteht, bauen wir sie; bis dahin ist dies der ehrliche Stand der Dinge.

Warum das wichtig ist

KI-Agenten entwerfen, prüfen und reichen zunehmend Geschäftsdokumente ein. Wenn Ihrer diese Werkzeuge direkt aufrufen kann, kann er eine Rechnung validieren, bevor sie verschickt wird, oder auf Anfrage eine konforme erzeugen — statt das Format falsch zu treffen und es erst Tage später durch eine Ablehnung zu erfahren. Die Engine hinter den Werkzeugen ist dieselbe wie im Rest von CrateAPI — deterministisch, kein LLM zur Laufzeit (siehe Trust & Security) — der Agent entscheidet, wann er ein Werkzeug aufruft, die Rechnungsregeln selbst bleiben regelbasiert, niemals geraten.

Selbst nachprüfen?

Jedes Werkzeug oben ruft dieselbe API auf, die Sie schon heute aufrufen können — lesen Sie die vollständige Referenz, oder testen Sie den kostenlosen Validator mit Ihrer eigenen Rechnung.

Kostenlosen Validator testen Zur Dokumentation