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 — von uns gehostet, oder selbst betrieben. 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.

So betreiben Sie ihn

Zwei Wege, sich zu verbinden — in beiden Fällen dieselben vier Werkzeuge.

Gehosteter Endpunkt

Fügen Sie die URL direkt zur Konfiguration Ihres MCP-Clients hinzu. Nichts zu installieren, nichts, das laufen muss. validate_invoice funktioniert ganz ohne Schlüssel; die anderen drei lesen den X-API-Key-Header.

{"mcpServers": {"crateapi-einvoicing": {
    "type": "http", "url": "https://api.crateapi.com/mcp",
    "headers": {"X-API-Key": "your-key-here"}}}}

Die genauen Feldnamen für type/url/headers unterscheiden sich je nach MCP-Client etwas (Claude Desktop, Claude Code, Cursor …) — passen Sie sie an Ihren Client an. Das Validieren über den gehosteten Endpunkt ohne Schlüssel ist per IP fair-use-limitiert, genau wie der kostenlose Validator dieser Seite (10/Min · 50/Tag · 200/Monat); ein gültiger API-Schlüssel hebt dieses Limit auf und unterliegt stattdessen dem Kontingent Ihres Plans.

Selbst gehostet

Betreiben Sie ihn lieber selbst — aus Datenschutzgründen, für eine abgeschottete (air-gapped) Umgebung oder zur lokalen Entwicklung? Es bleibt ein einzelner Python-Prozess, der dieselbe Produktions-API mit Ihrem eigenen Schlüssel aufruft:

{"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.

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.