MCP-Server Dokumentation
E-Rechnungen aus Claude, ChatGPT und anderen MCP-Clients prüfen, erzeugen, umwandeln und auslesen
Der Remote-MCP-Server verbindet einen KI-Assistenten mit der Electronic Invoice API. Sie melden sich einmal mit Ihrem eigenen API-Schlüssel an; danach kann der Assistent XRechnungen und ZUGFeRD-Rechnungen prüfen, aus Ihren Daten erzeugen, umwandeln und exportieren. Diese Seite behandelt Einrichtung, Werkzeuge, unterstützte Formate und Fehlerbehebung.
Server
| URL | https://mcp.electronic-invoice.app/mcp (Streamable HTTP) |
|---|---|
| MCP Registry | Im offiziellen MCP Registry gelistet als app.electronic-invoice/mcp |
| Anmeldung | OAuth 2.1, oder Authorization: Bearer mit Ihrem API-Schlüssel bei direkten Clients |
| Ohne Anmeldung | Werkzeuge für Betriebsstatus und Limits |
| Für | Nur Unternehmen (B2B) |
Anmeldung und API-Schlüssel
Der MCP-Server hat keine eigenen Konten. Sie erstellen einen API-Schlüssel in der Konsole. Wenn der Assistent zum ersten Mal ein geschütztes Werkzeug nutzt, öffnet er eine Anmeldeseite auf mcp.electronic-invoice.app, auf der Sie diesen Schlüssel eingeben. Für die Dauer der Verbindung wird der Schlüssel nur AES-GCM-verschlüsselt gespeichert. Er wird gelöscht, wenn Sie die Verbindung widerrufen oder sie abläuft.
Clients ohne OAuth-Unterstützung können den Schlüssel direkt als Authorization: Bearer eia_live_... senden. Die Werkzeuge für Betriebsstatus und Limits funktionieren ganz ohne Anmeldung.
Einrichten
Menünamen ändern sich zwischen Versionen; weicht eine Bezeichnung ab, suchen Sie den entsprechenden Eintrag.
Claude
- Einstellungen oder Anpassen öffnen, dann Konnektoren.
- Benutzerdefinierten Konnektor hinzufügen wählen und
https://mcp.electronic-invoice.app/mcpeintragen. - Im Chat etwas verlangen, das ein Rechnungswerkzeug braucht. Beim ersten Einsatz eines geschützten Werkzeugs fordert Claude zum Verbinden auf; melden Sie sich mit Ihrem API-Schlüssel an.
ChatGPT
Derzeit geht das über den Entwicklermodus: unter Einstellungen, Apps eine App mit der Server-URL anlegen und OAuth als Authentifizierung wählen. Die genauen Schritte hängen von Ihrem Tarif und den Einstellungen Ihres Workspace ab.
Andere Clients
Jeder Client, der Remote-MCP-Server über Streamable HTTP unterstützt, kann die URL nutzen. Wählen Sie OAuth, wenn angeboten, oder setzen Sie den Bearer-Header mit Ihrem API-Schlüssel.
Werkzeuge
| Werkzeug | Aufgabe |
|---|---|
validate_invoice | Prüft eine E-Rechnung (XML oder PDF) und liefert Urteil und Befunde mit Regel-ID |
generate_invoice | Erzeugt aus Rechnungsdaten als JSON eine XRechnung (UBL oder CII) oder ein ZUGFeRD/Factur-X-PDF |
convert_invoice | Wandelt UBL in CII, CII in UBL oder XML in PDF um |
extract_invoice | Liest Rechnungsdaten als JSON, CSV oder DATEV-Export aus |
open_invoice_check | Öffnet ein Upload-Feld im Chat, für Clients, die Dateien nicht an das Werkzeug übergeben können (zum Beispiel Claude) |
get_service_status | Betriebsstatus und Regelwerksfassungen, ohne Anmeldung |
get_usage_limits | Technische Limits (Rate, Größe, abrechenbare Statuscodes), ohne Anmeldung |
Unterstützte Formate bei der Prüfung
Der MCP-Server prüft dieselben Formate wie die API: XRechnung, EN 16931, Peppol BIS, NLCIUS, CIUS-RO, französische CIUS-Regeln, ZUGFeRD/Factur-X sowie Italien und Polen nur gegen das Schema. Die Tabelle mit dem Prüfumfang je Format steht auf der API-Seite. Das Erzeugen von Rechnungen beschränkt sich auf XRechnung und ZUGFeRD/Factur-X. Der Server versendet keine Rechnungen und bietet keinen Peppol-Zugang.
Beispiel-Prompts
- „Ist diese E-Rechnung gültig?“ mit angehängter PDF- oder XML-Datei. In Claude öffnet der Assistent das Upload-Feld.
- „Erstelle eine XRechnung (CII) für die Muster GmbH, 3 Stunden Beratung zu 120 Euro, 19 Prozent Umsatzsteuer, Käuferreferenz 04011000-12345-34.“ Prüfen Sie die vom Assistenten aufgelisteten Daten, bevor Sie die Datei verwenden.
- „Wandle diese UBL-Rechnung in CII um.“
- „Exportiere diese Rechnung als DATEV-Buchungsstapel.“
- „Welche Regel ist hier verletzt, und was muss ich im XML ändern?“
- „Läuft der Rechnungsdienst, und welche Raten- und Größenlimits gelten?“
Kontingent und Kosten
Jeder kostenpflichtige Aufruf zählt auf das Kontingent Ihres Tarifs, genau wie ein direkter API-Aufruf. Tarife und Limits stehen auf der API-Seite. Das Öffnen des Upload-Felds ist kostenlos; eine Prüfung zählt, sobald Sie sie starten.
Fehlerbehebung
- Anmelde-Schleife: Der Schlüssel wurde abgelehnt oder ist widerrufen. Erstellen Sie in der Konsole einen neuen Schlüssel, entfernen Sie den Konnektor im Client und fügen Sie ihn neu hinzu. Geben Sie den Schlüssel nur auf der Anmeldeseite ein, nicht in den Konnektor-Einstellungen.
- Fehler 401: Der Schlüssel fehlt, ist falsch oder widerrufen. Verbinden Sie mit einem aktiven Schlüssel neu; prüfen Sie bei einem Bearer-Header den Wert des Headers.
- 429 Kontingent überschritten: Das Monatskontingent Ihres Tarifs ist aufgebraucht. Warten Sie die nächste Periode ab oder wechseln Sie den Tarif. Bei einem 429 mit Wartezeit (Ratenlimit) versuchen Sie es nach den genannten Sekunden erneut.
- Datei nicht übergeben: Der Client kann die Datei nicht an das Werkzeug reichen. Bitten Sie den Assistenten, die Rechnungsprüfung zu öffnen; sie zeigt ein Upload-Feld im Chat.
- Ergebnis wirkt falsch: Lassen Sie sich die Befunde mit Regel-IDs nennen und vergleichen Sie sie mit der Rechnung. Befunde sind das Ergebnis der offiziellen Regeln, keine Aussage zu Ihrem Vertrag oder Ihrer steuerlichen Lage.
Weiter nicht gelöst? Schreiben Sie uns über die Kontaktseite.
Datenschutz und Bedingungen
Welche Daten wo und wie lange verarbeitet werden, steht in der Datenschutzerklärung, Abschnitt zum MCP-Server. Es gelten die API-Bedingungen. Wenn Sie eine Rechnung in einen Chat geben, sieht sie auch der Anbieter des Assistenten; dafür gelten dessen Bedingungen.
Hinweis: Prüfungen und Ergebnisse sind technische Hilfen, keine Rechts- oder Steuerberatung.