E-Rechnungen im Gespräch

Der MCP-Server verbindet diese API mit KI-Assistenten. Statt Code zu schreiben, beschreiben Sie die Rechnung — der Assistent erzeugt sie, prüft sie gegen die echten Regelwerke und nennt Ihnen jeden Befund mit Regel und Behebungshinweis.

Nutzer: „Erstell eine XRechnung an die Beispiel AG in Hamburg über 8 Stunden Beratung à 120 €, und prüf ob sie gültig ist.“

Der Assistent ruft create_invoice auf und antwortet mit Urteil, Beträgen und XML. Fehlt ein Pflichtfeld — etwa die Telefonnummer des Verkäufers (BT-42) — nennt die Prüfung die Regel samt Hinweis, und der Assistent kann es selbst ergänzen und erneut erzeugen.

Fünf Werkzeuge

Werkzeug	Was es tut	Endpunkt
create_invoice	Aus strukturierten Angaben ein Dokument erzeugen und prüfen	generate
validate_document	Eine vorhandene Datei gegen die offiziellen Regelwerke prüfen	validate
convert_document	In ein anderes Format überführen — XML, JSON, HTML oder PDF	convert
analyze_document	Format erkennen und den Inhalt auslesen	detect + parse
list_formats	Unterstützte Standards und ihre Fähigkeiten abfragen	formats

Verbinden

Ein Befehl, dann eine Anmeldung im Browser. Kein Schlüssel, der in einer Konfigurationsdatei liegt: Sie erlauben den Zugriff einmal, und können ihn im Dashboard jederzeit wieder trennen.

Claude Code

Terminal

claude mcp add --transport http invoapi https://api.invoapi.de/mcp

Beim ersten Aufruf meldet Claude Code „needs authentication“. Mit /mcp starten Sie die Anmeldung — es öffnet sich Ihr Browser, Sie bestätigen den Zugriff, und das Fenster schließt sich wieder.

Claude Desktop und Cursor

In die MCP-Konfiguration eintragen — bei Claude Desktop unter Einstellungen → Connectors, bei Cursor in ~/.cursor/mcp.json. Die Anmeldung im Browser läuft danach genauso.

mcp.json

{
  "mcpServers": {
    "invoapi": {
      "type": "http",
      "url": "https://api.invoapi.de/mcp"
    }
  }
}

Ohne Browser: der lokale Server

Auf einem Rechner ohne Browser — einem Build-Server etwa — geht die Anmeldung oben nicht. Dafür gibt es denselben Werkzeugsatz als lokales Paket, das sich mit einem API-Schlüssel authentifiziert.

Terminal

claude mcp add invoapi \
  -e INVOAPI_API_KEY=inv_live_IHR_SCHLUESSEL \
  -- npx -y --package=https://invoapi.de/downloads/invoapi-mcp-1.0.0.tgz invoapi-mcp

mcp.json

{
  "mcpServers": {
    "invoapi": {
      "command": "npx",
      "args": [
        "-y",
        "--package=https://invoapi.de/downloads/invoapi-mcp-1.0.0.tgz",
        "invoapi-mcp"
      ],
      "env": {
        "INVOAPI_API_KEY": "inv_live_IHR_SCHLUESSEL"
      }
    }
  }
}

Einstellungen

Variable	Zweck	Standard
INVOAPI_API_KEY	Ihr API-Schlüssel	Pflichtangabe
INVOAPI_BASE_URL	Basis-URL der API	https://api.invoapi.de
INVOAPI_OUT_DIR	Ablage für erzeugte PDFs	temporäres Verzeichnis

Diese Variablen gelten für den lokalen Server. Der gehostete braucht keine — er kennt Ihre Organisation aus der Anmeldung. Aktuelle Version des Pakets: 1.0.0; die Adresse des gehosteten Servers ist https://api.invoapi.de/mcp.

Die Endpunkte hinter den Werkzeugen sind in den Rezepten und der Dokumentation beschrieben.