MCP-Server

NormAPI für KI-Agenten: E-Rechnungen prüfen, erzeugen und auslesen aus Claude, ChatGPT, Cursor oder VS Code — dieselbe API, als Werkzeuge, die ein Modell selbst aufruft.

Zuletzt aktualisiert: 31. Oktober 2026 · Regelwerk v2026-08-31

Adresse und Paket

Der Server läuft gehostet unter dieser Adresse (Streamable HTTP) und als npm-Paket für Clients, die Server als lokalen Prozess starten (stdio). Beide bieten dieselben Werkzeuge.

Gehostet
https://normapi.com/mcp
Lokal (stdio)
npx -y @normapi/mcp

Verbinden

In Clients mit Konnektoren genügt die Adresse; beim ersten Erzeugen einer Rechnung meldet der Client Sie über OAuth bei NormAPI an. Clients mit Konfigurationsdatei nehmen alternativ Ihren API-Schlüssel als Header.

  • Claude (claude.ai und Desktop): Customize → Connectors → Add → Add custom connector, Adresse einfügen. Schritt für Schritt, mit Bildern.
  • ChatGPT: Plugins → nach NormAPI suchen → „NormAPI – XRechnung & ZUGFeRD“ → Install plugin, ohne Adresse. Im Entwicklermodus geht auch Plugins → Add → Add custom MCP server, mit dieser Adresse und „OAuth or no authentication“. Schritt für Schritt, mit Bildern.
Claude Code
claude mcp add --transport http normapi https://normapi.com/mcp

# or with your key instead of OAuth:
claude mcp add --transport http normapi https://normapi.com/mcp \
  --header "Authorization: Bearer nk_live_…"
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "normapi": {
      "url": "https://normapi.com/mcp",
      "headers": { "Authorization": "Bearer nk_live_…" }
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "normapi": { "type": "http", "url": "https://normapi.com/mcp" }
  }
}
Jeder Client mit stdio (z. B. claude_desktop_config.json)
{
  "mcpServers": {
    "normapi": {
      "command": "npx",
      "args": ["-y", "@normapi/mcp"],
      "env": { "NORMAPI_API_KEY": "nk_live_…" }
    }
  }
}

Werkzeuge

Vier Werkzeuge, jedes mit strukturiertem Ergebnis und einer Textfassung für Modelle, die nur Text lesen.

WerkzeugWas es tutKonto
validate_invoicePrüft eine XRechnung (UBL oder CII, als Text) oder ein ZUGFeRD-/Factur-X-PDF (base64) gegen das offizielle KoSIT-Regelwerk. Liefert das Urteil, die Regelwerksversion und jeden Befund; jeder Geschäftsregel-Befund mit Erklärung: was die Regel verlangt, warum sie typischerweise auslöst, wie man es behebt.nein
parse_invoiceLiest eine eingegangene E-Rechnung — XML als Text oder ein ZUGFeRD-/Factur-X-PDF (base64) — in strukturierte Daten aus: die Rechnung in genau der Form, die generate_invoice annimmt, die Beträge so, wie das Dokument sie ausweist, und jeden Wert, der nicht übernommen wurde, mit seinem Pfad. Mit validate: true kommt das Prüfergebnis dazu.nein
generate_invoiceErzeugt aus Rechnungsdaten eine XRechnung (UBL oder CII) oder ein ZUGFeRD-PDF; mit profile=en16931 für ein Unternehmen nach EN 16931, ohne Leitweg-ID, Ansprechpartner und elektronische Adressen. Ein ZUGFeRD-PDF wird automatisch auf den Briefkopf Ihres Kontos gedruckt, wenn Ihr Konto einen hat (hochgeladen unter normapi.com/konto/briefkopf); mit letterhead=none erhalten Sie NormAPIs Standardlayout. Summen werden serverseitig dezimal berechnet, das Dokument wird vor der Rückgabe validiert. Daten, die das Regelwerk nicht zulässt, werden mit den verletzten Regeln und ihrer Behebung abgelehnt — ohne Anrechnung.ja, zählt gegen das Kontingent
explain_ruleErklärt eine Regel per Code (BR-DE-15, BR-CO-10, PEPPOL-EN16931-R010 …), mit Link zur ausführlichen Seite.nein

Anmeldung und Schlüssel

Drei Wege, je nach Client:

  • OAuth 2.1 (Claude, ChatGPT und andere Konnektoren): Sie melden sich bei NormAPI an und erlauben die Verbindung. Sie erhält einen eigenen API-Schlüssel, benannt nach der App (mcp-claude-…). Trennen Sie sie in der Kontoübersicht unter „Verbundene Apps“ oder widerrufen Sie den Schlüssel unter API-Schlüssel, und die App hat sofort keinen Zugriff mehr.
  • API-Schlüssel als Header (Claude Code, Cursor, VS Code): Authorization: Bearer nk_live_… — derselbe Schlüssel wie für die REST-API.
  • stdio: der Schlüssel als Umgebungsvariable NORMAPI_API_KEY.

API-Schlüssel anlegen

Grenzen und Datenschutz

Dieselben Regeln wie für die REST-API:

  • Dokumente bis 5 MB. Anfragen ohne Schlüssel unterliegen den anonymen Grenzen der API, mit Schlüssel denen Ihres Schlüssels.
  • Jede erzeugte Rechnung zählt gegen das Monatskontingent (50 frei); Prüfen und Auslesen nie.
  • Rechnungen werden im Speicher verarbeitet und nicht gespeichert — auch nicht vom MCP-Server.
  • Technische Prüfung, keine Steuer- oder Rechtsberatung.

Zur API-Dokumentation