Zum Inhalt springen
Factusur

Installationsanleitung · VS Code (Copilot)

Rechnungen aus VS Code in Factur-X konvertieren

Installieren Sie den Factusur-MCP-Server mit einem Klick oder über .vscode/mcp.json in VS Code und konvertieren Sie Ihre Rechnungen mit Copilot im Agent-Modus.

Factusur in VS Code (Copilot) installieren

Ein Klick auf „Install in VS Code“, ein Befehl oder eine Konfigurationsdatei.

In VS Code installierenÖffnet VS Code (Copilot) mit bereits ausgefüllter Konfiguration.
  1. Schritt 1: Klicken Sie auf „Install in VS Code“ oder führen Sie den folgenden Befehl code --add-mcp aus.
  2. Schritt 2: Starten Sie den Server factusur (MCP-Ansicht oder Konfigurationsdatei): VS Code bietet die Anmeldung an und öffnet die Factusur-Seite.
  3. Schritt 3: Fragen Sie im Copilot-Chat im Agent-Modus: „Konvertiere invoice.pdf mit Factusur in Factur-X“.
Terminal
code --add-mcp '{"name":"factusur","type":"http","url":"https://factusur.com/mcp"}'

.vscode/mcp.json
{
  "servers": {
    "factusur": {
      "type": "http",
      "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.

.vscode/mcp.json mit einem Zugriffsschlüssel
{
  "inputs": [
    {
      "type": "promptString",
      "id": "factusur-key",
      "description": "Factusur-Zugriffsschlüssel",
      "password": true
    }
  ],
  "servers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:factusur-key}"
      }
    }
  }
}

VS Code fragt beim ersten Start nach dem Schlüssel und speichert ihn in seinem Geheimnisspeicher: Er wird nicht in die Datei geschrieben.

Anmeldung: OAuth (automatische Client-Registrierung) oder ein in VS Code eingegebener Zugriffsschlüssel. Quelle: Dokumentation von VS Code (MCP-Konfiguration) (öffnet in einem neuen Tab), geprüft am 26. Oktober 2026.

Was Sie VS Code (Copilot) 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.