MCP-Server

Stellt Rechnungsextraktion, Duplikatpruefung und Kreditoren-Analysen fuer MCP-kompatible Assistenten bereit. Aus dem Quellcode gebaut, nicht auf npm veroeffentlicht.

Das Repository enthaelt einen MCP-Server unter mcp-server. Er verbindet einen lokalen MCP-Client ueber Ihren API-Schluessel mit der Parsurai-API.

Dieser Server ist nicht auf npm veroeffentlicht. npm install -g @invoiceextract/mcp-server und npx @invoiceextract/mcp-server schlagen fehl. Ein Build aus einem Checkout des Repositorys, wie unten gezeigt, dient nur der lokalen Erprobung und ist vor dem oeffentlichen Start kein unterstuetzter Integrationsweg.

Seine Standard-Basis-URL ist https://api.invoiceextract.com. Dieser Hostname ist veraltet, wird nicht von Parsurai betrieben und darf nicht verwendet werden — setzen Sie INVOICEEXTRACT_BASE_URL immer explizit. Das Beispiel unten verwendet https://api.parsurai.com, den Produktions-API-Host.

Aus dem Quellcode bauen

Aus einem Checkout des Repositorys:

cd mcp-server
npm install
npm run build

Das erzeugt mcp-server/dist/index.js — die Datei, die Ihr MCP-Client startet.

Claude Desktop Setup

Verweisen Sie den Client mit absolutem Pfad auf die gebaute Datei:

{
  "mcpServers": {
    "parsurai": {
      "command": "node",
      "args": ["/pfad/zu/invoice-extractor/mcp-server/dist/index.js"],
      "env": {
        "INVOICEEXTRACT_API_KEY": "sk_live_your_key_here",
        "INVOICEEXTRACT_BASE_URL": "https://api.parsurai.com"
      }
    }
  }
}

Verfuegbare MCP-Tools

Der Server registriert zehn Tools: drei fuer Extraktion und Auswertung sowie sieben fuer den festen Kreditoren-Dokument-Workflow.

Tool	Beschreibung	Eingabe
`extract_invoice`	Extrahiert strukturierte Daten aus einer Rechnung. Uebergeben Sie den Rechnungsinhalt als Text, Bild-URL oder base64-kodiertes PDF	`text`, `image_url`, `pdf_base64`, `locale`
`check_duplicate`	Prueft, ob eine extrahierte Rechnung ein Duplikat einer bereits vorhandenen ist	`invoice_id`
`get_vendor_analytics`	Ruft aggregierte Kreditoren-Analysen ab, optional nach Zeitraum gefiltert	`start_date`, `end_date`, `limit`
`start_ap_workflow`	Startet den festen Kreditoren-Dokument-Workflow aus einem zuvor hochgeladenen Quell-Artefakt	`source_artifact_id`, dazu optional `workflow_version`, `preprocessing_policy`, `review_policy`, `candidate_ap_types`, `persist_after_approval`, `client_correlation_id`, `idempotency_key`
`get_ap_workflow_status`	Fragt Status und Stufen-Metadaten eines festen Kreditoren-Workflow-Laufs ab	`workflow_run_id`
`approve_ap_workflow`	Genehmigt einen festen Kreditoren-Workflow-Lauf, der auf Pruefung wartet	`workflow_run_id`, `workflow_run_version`, dazu optional `persist_after_approval`, `idempotency_key`, `reason`
`correct_ap_workflow`	Sendet Korrekturen fuer einen festen Kreditoren-Workflow-Lauf, der auf Pruefung wartet	`workflow_run_id`, `workflow_run_version`, `current_result`, `corrections`, dazu optional `idempotency_key`, `reason`
`reject_ap_workflow`	Lehnt einen festen Kreditoren-Workflow-Lauf ab, der auf Pruefung wartet	`workflow_run_id`, `workflow_run_version`, dazu optional `idempotency_key`, `reason`
`retry_ap_workflow`	Wiederholt einen fehlgeschlagenen festen Kreditoren-Workflow-Lauf	`workflow_run_id`, `workflow_run_version`, dazu optional `idempotency_key`, `reason`
`resume_ap_workflow`	Setzt einen festen Kreditoren-Workflow-Lauf fort, der auf Pruefung wartet	`workflow_run_id`, `workflow_run_version`, dazu optional `idempotency_key`, `reason`

Umgebungsvariablen

Variable	Pflicht	Beschreibung
`INVOICEEXTRACT_API_KEY`	Ja	API-Schluessel im Header `X-API-Key`
`INVOICEEXTRACT_BASE_URL`	In der Praxis ja	API-Basis-URL. Standard ist das veraltete `https://api.invoiceextract.com`, setzen Sie sie daher immer auf Ihre konfigurierte Parsurai-API-Basis-URL

Beide Variablen behalten das alte Praefix INVOICEEXTRACT_, bis der Server auf die Marke Parsurai umbenannt wird.

Der MCP-Server laeuft lokal und nutzt Ihren API-Schluessel fuer API-Aufrufe. Speichern Sie den Schluessel in der Umgebungskonfiguration, nicht in Prompts.