Serveur MCP

Donnez à Claude, Cursor ou tout agent IA compatible MCP un accès direct à la facturation électronique — validez, réparez, générez et convertissez des factures européennes depuis une conversation, sans intégration séparée à écrire.

Ce que c'est

CrateAPI propose un serveur Model Context Protocol (MCP) pour l'API de facturation électronique. Pointez un agent compatible MCP — Claude Desktop, Claude Code, Cursor, ou votre propre boucle d'agent — vers lui, et il obtient quatre outils qu'il peut appeler directement : valider une facture, en réparer une, en générer une à partir de données structurées, ou convertir entre les syntaxes UBL et CII. L'agent lit les descriptions des outils et décide quand les utiliser ; la logique de facturation elle-même tourne sur la même API déterministe que le reste de CrateAPI.

Outils disponibles

Quatre outils, un seul processus. Chacun est un proxy vers exactement la même API publique que vous pouvez appeler en HTTP — mêmes règles, mêmes limites, mêmes réponses.

validate_invoicegratuit

Vérifie une facture XML (UBL ou CII) au regard des règles officielles EN 16931, Peppol BIS, XRechnung, RO_CIUS et BR-FR. Renvoie un rapport structuré — valide ou non, décompte des erreurs/avertissements, constats. Aucune clé API nécessaire.

repair_invoiceclé API requise

Réparation automatique au mieux : corrige les formats de date non-ISO et les totaux incohérents, recalculés à partir des lignes. N'invente jamais de donnée métier manquante — indique ce qu'il a pu corriger et ce qu'il n'a pas pu.

generate_invoiceclé API requise

Construit une facture XML conforme (UBL ou CII) à partir d'un modèle de facture JSON structuré — vendeur, acheteur, lignes, totaux.

convert_invoiceclé API requise

Convertit une facture entre les syntaxes UBL et CII, sans perte ou rejetée : si quelque chose ne peut pas se convertir proprement, l'opération échoue avec une raison claire plutôt que de perdre silencieusement des données.

Comment le faire tourner

Auto-hébergé, fonctionne dès aujourd'hui avec votre propre clé API. Ajoutez ceci à la configuration de votre client MCP — Claude Desktop, Claude Code, Cursor, ou tout autre agent compatible MCP :

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice ne nécessite aucune clé. Les trois autres lisent EINVOICE_API_KEY depuis l'environnement — obtenez-en une sur la page tarifs. EINVOICE_API_BASE peut remplacer l'API cible, utile pour pointer vers une instance locale ou de test.

Auto-hébergé, pour l'instant. Il n'existe pas encore de point d'accès hébergé mcp.crateapi.com — vous faites tourner le serveur vous-même, un simple processus Python (python -m einvoicing.mcp_server), qui appelle la même API de production avec votre propre clé. Si suffisamment de personnes en ont besoin, nous en construirons une version hébergée ; pour l'instant, voici l'état honnête des choses.

Pourquoi c'est important

Les agents IA rédigent, vérifient et déposent de plus en plus de documents professionnels. Si le vôtre peut appeler ces outils directement, il peut valider une facture avant qu'elle ne soit envoyée, ou en générer une conforme à la demande, au lieu de se tromper de format et de le découvrir des jours plus tard via un rejet. Le moteur derrière ces outils est le même que celui du reste de CrateAPI — déterministe, zéro LLM à l'exécution (voir Trust & Security) — l'agent décide quand appeler un outil, les règles de facturation elles-mêmes restent basées sur des règles, jamais devinées.

Envie de le vérifier par vous-même ?

Chaque outil ci-dessus appelle la même API que vous pouvez appeler dès aujourd'hui — consultez la référence complète, ou essayez le validateur gratuit avec votre propre facture.

Essayer le validateur gratuit Consulter la documentation