Documentation du serveur MCP
Validez, créez, convertissez et extrayez des factures électroniques depuis Claude, ChatGPT et d'autres clients MCP
Le serveur MCP distant connecte un assistant IA à l'API Electronic Invoice. Vous vous connectez une fois avec votre propre clé API ; ensuite, l'assistant peut valider des factures XRechnung et ZUGFeRD, les créer à partir de vos données, les convertir et les exporter. Cette page présente la configuration, les outils, les formats pris en charge et le dépannage.
Serveur
| URL | https://mcp.electronic-invoice.app/mcp (Streamable HTTP) |
|---|---|
| MCP Registry | Répertorié dans le MCP Registry officiel sous app.electronic-invoice/mcp |
| Connexion | OAuth 2.1, ou Authorization: Bearer avec votre clé API pour les clients directs |
| Sans connexion | Outils d'état du service et de limites |
| Pour | Entreprises uniquement (B2B) |
Connexion et clé API
Le serveur MCP n'a pas de comptes propres. Vous créez une clé API dans la console. Lorsque l'assistant utilise pour la première fois un outil protégé, il ouvre une page de connexion sur mcp.electronic-invoice.app, où vous saisissez cette clé. Pendant toute la durée de la connexion, la clé est stockée uniquement sous forme chiffrée AES-GCM. Elle est supprimée lorsque vous révoquez la connexion ou lorsqu'elle expire.
Les clients qui ne prennent pas en charge OAuth peuvent envoyer la clé directement via Authorization: Bearer eia_live_.... Les outils d'état du service et de limites fonctionnent sans aucune connexion.
Configuration
Les noms de menus changent selon les versions ; si un libellé diffère, recherchez l'entrée équivalente.
Claude
- Ouvrez Paramètres ou Personnaliser, puis Connecteurs.
- Choisissez Ajouter un connecteur personnalisé et saisissez
https://mcp.electronic-invoice.app/mcp. - Dans une conversation, demandez une action qui nécessite un outil de facture. Lors de la première utilisation d'un outil protégé, Claude vous demande de vous connecter ; connectez-vous avec votre clé API.
ChatGPT
Pour l'instant, cela fonctionne via le mode développeur : dans Paramètres, Applications, créez une application avec l'URL du serveur et choisissez OAuth comme méthode d'authentification. Les étapes exactes dépendent de votre offre et des paramètres de votre espace de travail.
Autres clients
Tout client qui prend en charge les serveurs MCP distants via Streamable HTTP peut utiliser l'URL. Choisissez OAuth si l'option est proposée, ou définissez l'en-tête bearer avec votre clé API.
Outils
| Outil | Ce qu'il fait |
|---|---|
validate_invoice | Vérifie une facture électronique (XML ou PDF) et renvoie le verdict et les constatations avec l'identifiant de règle |
generate_invoice | Crée une XRechnung (UBL ou CII) ou un PDF ZUGFeRD/Factur-X à partir de données de facture au format JSON |
convert_invoice | Convertit UBL en CII, CII en UBL ou XML en PDF |
extract_invoice | Lit les données de facture au format JSON, CSV ou un export DATEV |
open_invoice_check | Ouvre un champ de téléversement dans la conversation, pour les clients qui ne peuvent pas transmettre de fichiers à l'outil (par exemple Claude) |
get_service_status | État du service et versions des jeux de règles, aucune connexion requise |
get_usage_limits | Limites techniques (débit, taille, codes de statut facturables), aucune connexion requise |
Formats pris en charge pour la validation
Le serveur MCP vérifie les mêmes formats que l'API : XRechnung, EN 16931, Peppol BIS, NLCIUS, CIUS-RO, les règles CIUS françaises, ZUGFeRD/Factur-X, et, pour l'Italie et la Pologne, uniquement par rapport au schéma. Le tableau indiquant l'étendue du contrôle par format se trouve sur la page API. La création de factures est limitée à XRechnung et ZUGFeRD/Factur-X. Le serveur n'envoie pas de factures et n'a aucun accès à Peppol.
Exemples de prompts
- "Cette facture électronique est-elle valide ?" avec un fichier PDF ou XML joint. Dans Claude, l'assistant ouvre le champ de téléversement.
- "Créez une XRechnung (CII) pour Muster GmbH, 3 heures de conseil à EUR 120, TVA de 19 %, référence de l'acheteur 04011000-12345-34." Vérifiez ensuite les données que l'assistant énumère avant d'utiliser le fichier.
- "Convertissez cette facture UBL en CII."
- "Exportez cette facture sous forme de lot d'écritures DATEV."
- "Quelle règle est enfreinte ici, et que dois-je modifier dans le XML ?"
- "Le service de facturation est-il disponible, et quelles sont les limites de débit et de taille ?"
Quota et coûts
Chaque appel facturable est décompté du quota de votre offre, exactement comme un appel API direct. Les offres et les limites sont indiquées sur la page API. L'ouverture du champ de téléversement est gratuite ; un contrôle est décompté dès que vous le lancez.
Dépannage
- Boucle de connexion : la clé a été rejetée ou est révoquée. Créez une nouvelle clé dans la console, supprimez le connecteur dans le client et ajoutez-le à nouveau. Saisissez la clé uniquement sur la page de connexion, pas dans les paramètres du connecteur.
- Erreur 401 : la clé est absente, incorrecte ou révoquée. Reconnectez-vous avec une clé active ; avec un en-tête bearer, vérifiez la valeur de l'en-tête.
- 429 quota dépassé : le quota mensuel de votre offre est épuisé. Attendez la période suivante ou changez d'offre. Pour un 429 accompagné d'un temps d'attente (limite de débit), réessayez après le nombre de secondes indiqué.
- Fichier non transmis : le client ne peut pas transmettre le fichier à l'outil. Demandez à l'assistant d'ouvrir le contrôle de facture ; il affiche un champ de téléversement dans la conversation.
- Le résultat semble erroné : demandez les constatations avec leurs identifiants de règle et comparez-les avec la facture. Les constatations sont le résultat des règles officielles, et non une déclaration sur votre contrat ou votre situation fiscale.
Vous êtes toujours bloqué ? Écrivez-nous via la page de contact.
Confidentialité et conditions
Les données traitées, leur lieu de traitement et leur durée de conservation sont décrits dans la politique de confidentialité, section relative au serveur MCP. Les conditions de l'API s'appliquent. Si vous placez une facture dans une conversation, le fournisseur de l'assistant la voit également ; ses conditions s'appliquent à cet égard.
Remarque : les contrôles et les résultats sont des aides techniques et ne constituent pas un conseil juridique ou fiscal.
Les textes juridiques sont disponibles en allemand et en anglais : politique de confidentialité, conditions de l'API et mentions légales. Seule la version allemande fait foi.