MCP-Server
E-Rechnungen prüfen und erstellen – direkt aus Claude und ChatGPT
Der Rechnungslotse spricht das Model Context Protocol: Verbinde deinen KI-Assistenten einmal, und er kann XRechnungen gegen EN 16931 prüfen, ZUGFeRD lesbar machen, die E-Rechnungspflicht klären – und mit Zugangsschlüssel echte Rechnungen in deinem Betrieb erstellen. Kein eigener Server, kein OAuth-Antrag, keine Wartezeit.
https://rechnungslotse.de/api/mcpStreamable HTTP · zustandslos · ohne Schlüssel = nur Prüf-WerkzeugeSieben Werkzeuge, zwei Stufen
Ohne Anmeldung bekommt der Assistent die vier Prüf-Werkzeuge – Dateien werden dabei nicht gespeichert. Mit einem Zugangsschlüssel aus dem Portal kommen die Konto-Werkzeuge dazu; sie laufen über dieselbe dokumentierte Schnittstelle wie die Shop-Plugins, mit demselben Kontingent und derselben Idempotenz.
Stufe 1 · ohne Konto
rechnung_pruefen
E-Rechnung gegen EN 16931 prüfen
rechnung_lesen
E-Rechnung im Klartext lesen
pflicht_pruefen
E-Rechnungspflicht klären
leitweg_pruefen
Leitweg-ID prüfen
Stufe 2 · mit Zugangsschlüssel
rechnung_erstellen
E-Rechnung erstellen (Konto nötig)
rechnung_datei
Rechnungsdatei abholen (Konto nötig)
betrieb_lesen
Betriebs-Stammdaten lesen (Konto nötig)
Der Schlüssel gehört in den Authorization-Kopf der Verbindung – nie in die Adresse, nie in den Chat.
Verbinden in zwei Minuten
Claude (Web und Desktop)
- Einstellungen → Connectors → „Custom Connector hinzufügen“
- URL eintragen: https://rechnungslotse.de/api/mcp
- Fertig – Claude sieht die vier Prüf-Werkzeuge sofort. Die OAuth-Felder bleiben LEER, und den Knopf „Anmelden“ brauchst du nicht: Dieser Server hat bewusst kein OAuth.
Stufe 2 geht nur in Claude Desktop — nicht im Browser.
Der Web-Connector kann keine eigenen Kopfzeilen mitschicken; dort bleibt es bei den vier Prüf-Werkzeugen. Für das Erstellen von Rechnungen trägst du den Schlüssel in die Konfigurationsdatei von Claude Desktop ein (Einstellungen → Entwickler → Konfiguration bearbeiten). Die OAuth-Felder im Web-Dialog bleiben immer leer — dort gehört der Schlüssel nie hinein.
Konfiguration für Claude Desktop:
{
"mcpServers": {
"rechnungslotse": {
"type": "http",
"url": "https://rechnungslotse.de/api/mcp",
"headers": {
"Authorization": "Bearer rl_live_DEIN_SCHLUESSEL"
}
}
}
}ChatGPT (Developer Mode)
- Settings → Apps & Connectors → Advanced → Developer Mode aktivieren
- „Create connector“ → URL https://rechnungslotse.de/api/mcp → Auth: None
- Im Chat den Connector aktivieren – die Prüf-Werkzeuge stehen bereit.
ChatGPT bietet für eigene Connectors keine Kopfzeilen an – dort bleibt es bei Stufe 1. Zum Erstellen von Rechnungen aus einem Shop heraus ist ohnehin die Shop-Anbindung der richtige Weg.
Ein einmal geteilter Schlüssel lässt sich im Portal jederzeit einzeln zurückziehen. Beim Prüfen und Lesen wird keine Datei gespeichert – dieselbe Zusage wie beim Validator auf der Website. Und wenn eine Prüfung fehlschlägt, erklärt die Fehlerdatenbank jede Regel-ID im Klartext – der Assistent verlinkt sie direkt.
Häufige Fragen
Was ist ein MCP-Server?
MCP (Model Context Protocol) ist der offene Standard, über den KI-Assistenten wie Claude oder ChatGPT externe Werkzeuge benutzen. Ein MCP-Server stellt solche Werkzeuge bereit – dieser hier kann E-Rechnungen prüfen, lesen und erstellen. Einmal verbunden, benutzt der Assistent sie von selbst, wenn die Aufgabe passt.
Was kostet das?
Die vier öffentlichen Werkzeuge (prüfen, lesen, Pflicht-Check, Leitweg-ID) sind kostenlos und brauchen kein Konto. Die Konto-Werkzeuge zum Erstellen von Rechnungen laufen über einen Zugangsschlüssel aus dem Portal und zählen gegen dasselbe Monatskontingent wie Rechnungen im Portal – drei im Monat sind im kostenlosen Konto frei.
Wird meine Rechnungsdatei gespeichert, wenn die KI sie prüft?
Nein. Die Prüf- und Lese-Werkzeuge behandeln die Datei genauso wie der Validator auf der Website: Sie existiert nur für die Dauer der Prüfung und wird danach verworfen. Es gibt in diesem Code schlicht keinen Speicheraufruf.
Warum sehe ich nur vier Werkzeuge statt sieben?
Die Konto-Werkzeuge erscheinen erst, wenn die Verbindung einen Zugangsschlüssel mitschickt (Authorization-Kopf). Ohne Schlüssel zeigt der Server nur die öffentliche Stufe – so kann eine Verbindung ohne Anmeldedaten auch nichts anrichten.
Wie schalte ich Stufe 2 frei — im Browser sehe ich nur OAuth-Felder?
Gar nicht im Browser: Der Web-Connector kann keine eigenen Kopfzeilen mitschicken, deshalb bleibt es dort bei den vier Prüf-Werkzeugen. Stufe 2 läuft über Claude Desktop, wo der Schlüssel in der Konfigurationsdatei steht (Einstellungen → Entwickler → Konfiguration bearbeiten). Die beiden OAuth-Felder im Web-Dialog bleiben leer — dieser Server hat kein OAuth, und ein API-Schlüssel gehört dort nie hinein.
Muss ich mich beim Connector anmelden?
Nein. Klickst du nach dem Hinzufügen auf „Anmelden“, sucht Claude nach einem OAuth-Login, den es hier nicht gibt — du landest auf einer Hinweisseite, die genau das erklärt. Die Werkzeuge sind schon aktiv, der Schritt ist unnötig.
Funktioniert das auch mit anderen KI-Clients als Claude und ChatGPT?
Ja. Der Server spricht Standard-MCP über Streamable HTTP und ist zustandslos – jeder Client, der entfernte MCP-Server unterstützt (etwa Cursor, VS Code oder eigene Agenten), kann ihn mit derselben URL einbinden.