Zum Inhalt springen
Factusur

Installationsanleitung · Claude Code

Rechnungen aus Claude Code in Factur-X konvertieren

Fügen Sie Factusur mit einem Befehl zu Claude Code hinzu, verbinden Sie Ihr Konto und konvertieren Sie Ihre PDF-Rechnungen im Terminal in Factur-X.

Factusur in Claude Code installieren

Ein Befehl im Terminal, danach melden Sie sich im Browser bei Ihrem Konto an.

  1. Schritt 1: Fügen Sie den Server in einem Terminal mit dem folgenden Befehl hinzu (--scope user macht ihn in all Ihren Projekten verfügbar).
  2. Schritt 2: Öffnen Sie Claude Code, geben Sie /mcp ein, wählen Sie factusur und dann „Authenticate“: Ihr Browser öffnet Factusur.
  3. Schritt 3: Melden Sie sich an, prüfen Sie, was Claude tun darf, und klicken Sie auf „Autorisieren“.
  4. Schritt 4: Fragen Sie dann zum Beispiel: „Konvertiere invoice-042.pdf mit Factusur in Factur-X“.
Terminal
claude mcp add --transport http --scope user factusur https://factusur.com/mcp

.mcp.json (gemeinsames Projekt)
{
  "mcpServers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp"
    }
  }
}

Im Stammverzeichnis eines Repositorys, für das ganze Team. Jede Person meldet sich mit ihrem eigenen Konto an.

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.

Mit einem Zugriffsschlüssel
claude mcp add --transport http --scope user factusur https://factusur.com/mcp \
  --header "Authorization: Bearer fsk_live_IHR_SCHLUESSEL"

Anmeldung: OAuth (Anmeldung im Browser) oder ein Zugriffsschlüssel in einem Header. Quelle: Dokumentation von Claude Code (MCP) (öffnet in einem neuen Tab), geprüft am 26. Oktober 2026.

Was Sie Claude Code 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.