Serveur MCP

Expose extraction de factures, detection de doublons et analyses fournisseurs aux assistants compatibles MCP. Construit depuis les sources, non publie sur npm.

Le depot inclut un serveur MCP sous mcp-server. Il connecte un client MCP local a l'API Parsurai avec votre cle API.

Ce serveur n'est pas publie sur npm. npm install -g @invoiceextract/mcp-server et npx @invoiceextract/mcp-server echouent. Le construire depuis un checkout du depot, comme indique ci-dessous, sert uniquement a l'evaluation locale et n'est pas un chemin d'integration supporte avant le lancement public.

Son URL de base par defaut est https://api.invoiceextract.com. Ce nom d'hote est obsolete, n'est pas exploite par Parsurai et ne doit jamais etre utilise — definissez toujours INVOICEEXTRACT_BASE_URL explicitement. L'exemple ci-dessous utilise https://api.parsurai.com, l'hote API de production.

Construire depuis les sources

Depuis un checkout du depot:

cd mcp-server
npm install
npm run build

Cela produit mcp-server/dist/index.js, le fichier que votre client MCP execute.

Configuration Claude Desktop

Pointez le client vers le fichier construit par chemin absolu:

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

Outils MCP disponibles

Le serveur enregistre dix outils: trois pour l'extraction et l'analyse, et sept pour le workflow fixe de documents fournisseurs.

Outil	Description	Entree
`extract_invoice`	Extrait des donnees structurees d'une facture. Fournissez le contenu en texte, URL image ou PDF encode en base64	`text`, `image_url`, `pdf_base64`, `locale`
`check_duplicate`	Verifie si une facture extraite est un doublon d'une facture deja presente	`invoice_id`
`get_vendor_analytics`	Recupere les analyses fournisseurs agregees, filtrables par plage de dates	`start_date`, `end_date`, `limit`
`start_ap_workflow`	Demarre le workflow fixe de documents fournisseurs depuis un artefact source deja televerse	`source_artifact_id`, plus en option `workflow_version`, `preprocessing_policy`, `review_policy`, `candidate_ap_types`, `persist_after_approval`, `client_correlation_id`, `idempotency_key`
`get_ap_workflow_status`	Interroge le statut et les metadonnees d'etape d'une execution du workflow fixe	`workflow_run_id`
`approve_ap_workflow`	Approuve une execution du workflow fixe en attente de revue	`workflow_run_id`, `workflow_run_version`, plus en option `persist_after_approval`, `idempotency_key`, `reason`
`correct_ap_workflow`	Soumet des corrections pour une execution du workflow fixe en attente de revue	`workflow_run_id`, `workflow_run_version`, `current_result`, `corrections`, plus en option `idempotency_key`, `reason`
`reject_ap_workflow`	Rejette une execution du workflow fixe en attente de revue	`workflow_run_id`, `workflow_run_version`, plus en option `idempotency_key`, `reason`
`retry_ap_workflow`	Relance une execution du workflow fixe en echec	`workflow_run_id`, `workflow_run_version`, plus en option `idempotency_key`, `reason`
`resume_ap_workflow`	Reprend une execution du workflow fixe en attente de revue	`workflow_run_id`, `workflow_run_version`, plus en option `idempotency_key`, `reason`

Variables d'environnement

Variable	Obligatoire	Description
`INVOICEEXTRACT_API_KEY`	Oui	Cle API envoyee dans `X-API-Key`
`INVOICEEXTRACT_BASE_URL`	Oui en pratique	URL de base API. La valeur par defaut est l'obsolete `https://api.invoiceextract.com`, definissez-la donc toujours sur votre URL de base d'API Parsurai configuree

Les deux variables conservent l'ancien prefixe INVOICEEXTRACT_ jusqu'au renommage du serveur vers la marque Parsurai.

Le serveur MCP tourne localement et utilise votre cle API pour appeler l'API. Gardez la cle dans la configuration d'environnement, pas dans les prompts.