Zum Inhalt springen

MCP-Server für KI-Assistenten

E-Rechnungen mit Ihrem KI-Assistenten prüfen und erstellen

Mit dem MCP-Server prüfen und erstellen KI-Assistenten wie Claude E-Rechnungen für Sie: Sie beschreiben die Rechnung oder hängen eine Datei im Chat an, und der Assistent ruft die unten genannten Werkzeuge auf. Der Server nutzt das Model Context Protocol (MCP, Transport „Streamable HTTP“). Sie binden ihn über seine URL in Ihren Assistenten ein und melden sich dann mit Ihrem Konto an und erlauben den Zugriff, oder Sie nutzen einen API-Key.

Werkzeuge

  • validate_e_invoice: prüft eine E-Rechnung (XML oder PDF mit eingebettetem XML) und liefert die Fehler und Warnungen mit Regel-ID und einem Link zur Erklärung der Regel. Welche Prüfungen laufen, hängt vom Format ab: KoSIT und Mustang, das EN-16931-Schematron nur für ZUGFeRD / Factur-X. Dateien werden Base64-kodiert in einer Anfrage von höchstens 16 MB übergeben, PDF-Dateien können daher bis etwa 12 MB groß sein. Zählt als Validierung Ihres Plans; auch mit API-Zugang „nur Prüfen“ nutzbar.
  • explain_validation_rule: erklärt eine Prüfregel anhand ihrer Regel-ID mit den veröffentlichten Inhalten unserer Prüfregel-Seiten: Bedeutung, typische Ursachen, Behebung und, soweit vorhanden, Beispiele für fehlerhaftes und richtiges XML. validate_e_invoice liefert diese Erklärungen zu den gemeldeten Regeln mit, soweit veröffentlicht, sodass Ihr Assistent die Fehler in einfacher Sprache erklären und Korrekturen vorschlagen kann; ob eine korrigierte Rechnung besteht, zeigt eine erneute Prüfung. Zählt nicht als Validierung Ihres Plans; auch mit API-Zugang „nur Prüfen“ nutzbar.
  • create_e_invoice: erstellt aus Rechnungsdaten mit denselben Feldern wie POST /api/v1/invoices/ ein ZUGFeRD-PDF/A-3 oder, mit dem Profil XRECHNUNG, eine XRechnung-XML. Bevor die Datei entsteht, wird die Rechnung gegen die KoSIT-Prüfregeln geprüft; besteht sie nicht, erhält der Assistent die Meldungen des Validators, und die Rechnung wird nicht gespeichert. Erstellte Rechnungen werden in Ihrem Konto gespeichert. Erfordert einen Plan mit vollem API-Zugang.

Für wen ist das?

  • Selbstständige und Unternehmen, die bereits mit einem KI-Assistenten wie Claude arbeiten und E-Rechnungen im Chat prüfen oder erstellen möchten – ohne Programmierung.
  • Entwickler, die ihrem KI-Assistenten Werkzeuge für E-Rechnungen geben möchten. Für eigene Anwendungen steht die REST-API mit einem API-Schlüssel bereit. API für Entwickler

Einrichtung Schritt für Schritt

  • Server-URL: https://www.e-rechnungsfreund.de/api/v1/mcp/
  • Anmeldung: mit Ihrem Konto (OAuth 2.1) oder mit dem HTTP-Header Authorization: Api-Key <key>
  1. Server im Assistenten eintragen

    Claude (claude.ai, Claude Desktop)

    Fügen Sie den Server in Claude als benutzerdefinierten Konnektor hinzu (in Claude: Customize → Connectors → Add → Add custom connector), tragen Sie die Server-URL ein und bestätigen Sie. Claude öffnet dann unsere Anmeldeseite; melden Sie sich an und erlauben Sie den Zugriff. Sie brauchen dafür keinen API-Key und keine zusätzliche Software.

    Verbundene KI-Assistenten sehen Sie in Ihrem Konto unter „API-Keys“; dort können Sie jeden Zugriff einzeln widerrufen. Verbundene KI-Assistenten

    Claude Code und andere Clients

    Clients, die bei Remote-MCP-Servern eigene Header unterstützen, können statt der Anmeldung auch einen API-Key nutzen, zum Beispiel Claude Code:

    claude mcp add --transport http e-invoice https://www.e-rechnungsfreund.de/api/v1/mcp/ --header "Authorization: Api-Key YOUR_API_KEY"

    Der Key wird in der Konfiguration Ihres Assistenten gespeichert. Legen Sie dafür einen eigenen Key an, damit Sie ihn einzeln widerrufen können. API-Keys

  2. Assistenten fragen
    Zum Beispiel: „Prüfe die angehängte E-Rechnung“ oder „Erstelle eine E-Rechnung für …“ mit den Rechnungsdaten. Der Assistent ruft dann das passende Werkzeug des MCP-Servers auf.

Rechte und Limits

  • Pro und Business: E-Rechnungen erstellen und prüfen, Prüfregeln erklären (alle Werkzeuge).
  • Free und Starter: E-Rechnungen prüfen und Prüfregeln erklären (validate_e_invoice, explain_validation_rule).

Mit Anmeldung wie mit API-Key nutzt der MCP-Server dieselben Rechte Ihres Plans und dieselben Rate-Limits wie die REST-API: Jede Nachricht an den Server zählt als Anfrage; Prüfen und Erstellen von Dateien zählen zusätzlich zum Limit für ressourcenintensive Anfragen und zu den monatlichen Validierungen bzw. Rechnungen Ihres Plans.

Pläne mit API-Zugang ansehen · Rate-Limits

Datenschutz

Wenn Sie den MCP-Server nutzen, geben Sie Rechnungsdaten an Ihren KI-Assistenten weiter; dessen Anbieter verarbeitet sie nach seinen eigenen Datenschutzbestimmungen, und Sie entscheiden, welche Daten Sie dort teilen. Die Prüfung und Erstellung der E-Rechnung läuft wie bei der API auf unserem Server; wir geben Rechnungsdaten nicht an KI-Dienste weiter.

Datenschutzerklärung · Sicherheit und Datenschutz

Häufige Fragen

Was ist ein MCP-Server?

MCP (Model Context Protocol) ist ein Protokoll, mit dem KI-Assistenten Werkzeuge anderer Dienste aufrufen. Der MCP-Server von E-Rechnungsfreund stellt drei Werkzeuge bereit: E-Rechnungen prüfen, Prüfregeln erklären und ZUGFeRD- oder XRechnung-Dateien erstellen.

Welche KI-Assistenten kann ich nutzen?

Diese Seite beschreibt die Einrichtung für Claude (claude.ai, Claude Desktop) und Claude Code. Andere Clients, die entfernte MCP-Server und die Anmeldung per OAuth oder eigene HTTP-Kopfzeilen unterstützen, funktionieren möglicherweise ebenfalls.

Welchen Plan brauche ich?

Prüfen mit validate_e_invoice ist auch mit API-Zugang nur zum Prüfen möglich (Free und Starter); Erstellen mit create_e_invoice setzt einen Plan mit vollem API-Zugang voraus (Pro und Business). Den Umfang je Plan zeigt die Preisseite.

Muss ich dafür programmieren?

Nein. Sie tragen die Server-URL in Ihren Assistenten ein und melden sich mit Ihrem Konto an, oder Sie tragen Ihren API-Schlüssel in seine Konfiguration ein – ohne Programmierung.

Zählt die Nutzung des MCP-Servers zu meinem Plan?

Ja. Mit Anmeldung wie mit API-Schlüssel nutzt der MCP-Server dieselben Planrechte und Rate-Limits wie die REST-API; Prüfen und Erstellen zählen zu den monatlichen Validierungen bzw. Rechnungen Ihres Plans.

Werden meine Rechnungsdaten an KI-Dienste weitergegeben?

Wir geben Rechnungsdaten nicht an KI-Dienste weiter; Prüfen und Erstellen laufen auf unserem Server. Was Sie in Ihren KI-Assistenten eingeben, verarbeitet dessen Anbieter nach seinen eigenen Datenschutzbestimmungen.

Pläne mit API-Zugang ansehen