Zum Inhalt springen
Factusur

Installationsanleitung · Codex (OpenAI)

Rechnungen aus Codex in Factur-X konvertieren

Fügen Sie Factusur mit codex mcp add zu Codex hinzu, verbinden Sie Ihr Konto und konvertieren Sie Ihre PDF-Rechnungen im Terminal in Factur-X.

Factusur in Codex (OpenAI) installieren

Zwei Befehle: Server hinzufügen und bei Ihrem Konto anmelden.

  1. Schritt 1: Fügen Sie den Server mit codex mcp add hinzu.
  2. Schritt 2: Führen Sie codex mcp login factusur aus: Ihr Browser öffnet Factusur zur Autorisierung.
  3. Schritt 3: Fragen Sie in Codex: „Konvertiere invoice.pdf mit Factusur in Factur-X“.
Terminal
codex mcp add factusur --url https://factusur.com/mcp
codex mcp login factusur

~/.codex/config.toml
[mcp_servers.factusur]
url = "https://factusur.com/mcp"

Zugriffsschlüssel statt OAuth verwenden

Für ein Skript, eine CI-Pipeline oder ein Tool ohne OAuth-Anmeldung. Erstellen Sie einen Schlüssel unter Konto › MCP-Verbindungen: Er wird nur einmal angezeigt. Fügen Sie ihn nie in eine versionierte Datei ein.

config.toml mit einem Zugriffsschlüssel
[mcp_servers.factusur]
url = "https://factusur.com/mcp"
bearer_token_env_var = "FACTUSUR_API_KEY"

Codex liest den Schlüssel aus der Umgebungsvariablen FACTUSUR_API_KEY.

Anmeldung: OAuth oder ein aus einer Umgebungsvariablen gelesener Zugriffsschlüssel. Quelle: Dokumentation von Codex (MCP) (öffnet in einem neuen Tab), geprüft am 26. Oktober 2026.

Was Sie Codex (OpenAI) fragen können

convert_to_facturxKonvertierenzählt eine Konvertierung

Rechnung konvertieren

PDF, Foto oder strukturierte Daten → Factur-X EN 16931, mit Prüfbericht und Download-Link. Fehlt eine Pflichtangabe, fragt der Agent Sie danach.

  • „Konvertiere invoice-042.pdf mit Factusur in Factur-X.“
  • „Erstelle eine Factur-X-Datei für diese Rechnung: 3 Tage Beratung zu 450 € netto, Kunde Exemple SAS.“
validate_facturxValidierenzählt nichts

Factur-X prüfen

Prüft PDF/A-3, XML, XSD, das EN-16931-Schematron und die französischen Pflichtangaben einer erhaltenen Factur-X-Datei. Zählt keine Konvertierung.

  • „Prüfe die Factur-X-Datei meines Lieferanten und sag mir, was nicht stimmt.“
get_usageLesenzählt nichts

Kontingent und Tarif

Verbrauchte und verbleibende Konvertierungen, Verlängerungsdatum, Sicherheitsgrenzen.

  • „Wie viele Konvertierungen habe ich diesen Monat noch?“
Alle Tools des MCP-Servers

Fehlerbehebung

„401“ oder „authentication required“

Melden Sie sich in Ihrem Tool erneut an (/mcp in Claude Code, „Connect“ in Cursor, codex mcp login). Ein widerrufener oder abgelaufener Schlüssel muss ersetzt werden.

„quota_exceeded“

Ihr Monatskontingent ist aufgebraucht: Öffnen Sie den Link, den der Agent anzeigt, um den Tarif zu wechseln oder ein Paket hinzuzufügen, und bitten Sie den Agenten dann, die Konvertierung fortzusetzen (es wird nichts erneut ausgelesen).

„needs_input“: fehlende Angaben

Der Rechnung fehlen Pflichtangaben (SIREN des Kunden, Datum …). Geben Sie sie dem Agenten: Er ergänzt sie mit update_conversion und startet die Konvertierung erneut.

„rate_limited“

Eine Sicherheitsgrenze ist erreicht (Aufrufe pro Minute, Konvertierungen pro Tag). Warten Sie einen Moment oder passen Sie Ihre Grenzen unter Konto › MCP-Verbindungen an.

Datei zu groß

Über 3 MB muss der Agent create_upload_url verwenden (direkter Upload, höchstens 10 MB). Ein PDF mit mehr als 10 Seiten wird abgelehnt: Laden Sie nur die Rechnung hoch.

Mein Tool findet den Server nicht

Prüfen Sie die genaue URL https://factusur.com/mcp und den Transport „http“ (Streamable HTTP). Ältere Clients, die nur den SSE-Transport beherrschen, werden nicht unterstützt.

Zugriff, Daten und Zahlung: Sicherheit des MCP-Servers.

Factusur ist keine zugelassene Plattform (plateforme agréée, PA) und übermittelt Ihre Rechnungen nicht. Wir erstellen eine Datei im Factur-X-Format aus den Angaben, die Sie bestätigen.