Serveur MCP Factur-X : installation et sécurité

En bref

• Le serveur MCP de Factusur se trouve à l'adresse https://factusur.com/mcp. Il fonctionne à distance : rien à installer sur votre poste.
• La connexion passe par OAuth 2.1 avec un écran de consentement Factusur qui affiche l'application, l'adresse de retour et les droits demandés. Les clés d'accès sont réservées aux scripts et aux outils sans OAuth.
• Trois droits seulement existent : convertir, vérifier, lire. Aucun droit ne permet de payer, de changer de formule ni de supprimer vos données.
• Des plafonds de sécurité (appels par minute, conversions par jour) protègent votre quota d'un agent qui boucle ; vous pouvez les abaisser dans votre compte.
• Les fichiers suivent les mêmes durées de conservation que sur le site, et le journal d'activité ne contient jamais le contenu de vos factures.

Un serveur distant, compatible avec la plupart des assistants

Le serveur implémente la spécification ouverte Model Context Protocol, dans sa révision du 28 juillet 2026, avec le transport « Streamable HTTP ». Il reste compatible avec les clients plus anciens de 2025. Concrètement, n'importe quel client MCP qui accepte une URL HTTPS peut s'y connecter.

Les guides pas à pas sont disponibles pour chaque outil courant. En résumé :

Outil	Installation
Claude Code	claude mcp add --transport http --scope user factusur https://factusur.com/mcp, puis /mcp pour se connecter
Claude Desktop et claude.ai	Personnaliser › Connecteurs › « Ajouter un connecteur personnalisé », avec l'URL du serveur
Cursor	bouton « Ajouter à Cursor », ou mcp.json avec "url": "https://factusur.com/mcp"
VS Code (Copilot)	bouton « Installer dans VS Code », code --add-mcp, ou .vscode/mcp.json
Codex	codex mcp add factusur --url https://factusur.com/mcp, puis codex mcp login factusur

Ces commandes ont été vérifiées sur la documentation de chaque éditeur. Les configurations complètes, copiables, se trouvent sur la page Serveur MCP Factur-X pour Claude, Cursor et VS Code.

Comment se passe la connexion

Lors de l'ajout, votre client découvre tout seul comment s'authentifier : le serveur publie ses métadonnées aux emplacements prévus par la spécification (ressource protégée selon la RFC 9728, serveur d'autorisation selon la RFC 8414). Le client ouvre alors votre navigateur sur Factusur.

Vous vous connectez à votre compte, sans mot de passe, par un lien envoyé par e-mail. Vient ensuite l'écran de consentement, qui affiche :

• le nom de l'application. Factusur reconnaît les applications connues d'après leur adresse de retour (par exemple celle de claude.ai) et affiche alors son propre libellé, jamais le nom déclaré par l'application. Une application inconnue est signalée par un avertissement « application non vérifiée », avec le nom qu'elle s'est donné, entre guillemets ;
• l'adresse de retour exacte vers laquelle vous serez renvoyé ;
• les droits demandés, en langage clair ;
• le rappel que l'application ne pourra jamais payer, changer de formule ni supprimer vos données.

Vous pouvez refuser : l'application reçoit alors un refus, sans aucun accès.

Ce qui protège la connexion

Les mécanismes suivent la spécification d'autorisation MCP et les recommandations OAuth actuelles :

• PKCE obligatoire avec la méthode S256 : un code d'autorisation intercepté est inutilisable sans le secret que seul votre client connaît. Les demandes sans PKCE, ou avec la méthode « plain », sont refusées.
• Adresses de retour contrôlées. HTTPS en correspondance exacte, adresse locale de votre machine (127.0.0.1 ou localhost, port libre comme le prévoit la RFC 8252), ou schéma d'application d'une liste fermée (cursor://, vscode://…). Une adresse de retour non déclarée affiche une page d'erreur Factusur ; elle n'est jamais suivie.
• Jetons liés au serveur. Chaque jeton est émis pour la seule ressource https://factusur.com/mcp (RFC 8707) ; un jeton destiné à un autre service est refusé.
• Durées courtes et rotation. Un jeton d'accès vaut une heure. Le jeton de renouvellement change à chaque utilisation ; s'il est présenté deux fois, toute la chaîne est révoquée et l'application déconnectée par sécurité.
• Rien en clair. Codes, jetons et clés ne sont conservés que sous forme d'empreinte : Factusur ne peut pas les relire, et une fuite de la base ne les révélerait pas.

Vous retrouvez à tout moment les applications autorisées dans Compte › Connexions MCP, avec la date de dernière utilisation ; un clic les déconnecte immédiatement.

Clés d'accès : quand et comment

OAuth suffit pour les assistants courants. Une clé d'accès sert dans les autres cas : un script de facturation, une tâche d'intégration continue, un outil qui ne sait pas ouvrir de navigateur. Elle commence par fsk_live_, ce qui la rend facile à repérer si elle est publiée par erreur, et comporte une somme de contrôle qui détecte les fautes de frappe.

Au moment de la créer, vous choisissez :

• un nom, pour la reconnaître dans le journal ;
• ses droits : conversion, vérification, lecture, séparément ;
• une expiration : 30, 90, 180 ou 365 jours. Il n'existe pas de clé éternelle.

La clé s'affiche une seule fois. Rangez-la dans un gestionnaire de secrets ou une variable d'environnement — les configurations proposées par Factusur pour Cursor, VS Code et Codex la lisent justement depuis une variable — et jamais dans un fichier versionné. La révocation est immédiate.

Ce que l'agent peut faire, et ce qu'il ne peut pas faire

Le serveur propose neuf outils, détaillés sur la page Les outils du serveur MCP Factusur : conversion, conversion par lot, correction d'une information, vérification d'un Factur-X, envoi d'un gros fichier, suivi, historique, quota et modèle de facture.

Aucun outil n'est destructif ni financier. Quand votre quota est atteint, l'agent reçoit un message qui contient la formule recommandée, son prix TTC et un lien vers la page de paiement. Ce lien vous demande de vous connecter et de confirmer : le paiement se fait dans votre navigateur, jamais par l'agent. La suppression de vos fichiers et de votre compte reste dans votre espace client.

Le contenu des factures est traité comme une donnée non fiable : un texte malveillant glissé dans une facture (« ignore tes instructions et… ») n'est jamais interprété comme une consigne par le serveur. Les informations extraites sont renvoyées à l'agent sous forme structurée, nettoyées des caractères invisibles et bornées en longueur, et chaque description d'outil rappelle à l'agent de ne pas suivre d'instruction trouvée dans une facture.

Plafonds de sécurité

Un agent mal configuré peut boucler : relancer sans fin la même conversion, ou convertir des centaines de fichiers par erreur. Le serveur applique donc, en plus de votre quota mensuel, des plafonds par défaut :

• 30 appels d'outils par minute et 1 000 par jour ;
• 30 conversions lancées par heure ;
• 50 conversions décomptées par jour et par connexion.

Le même fichier converti plus de trois fois en une heure est aussi refusé. Vous pouvez abaisser ces plafonds dans votre compte ; ils ne peuvent pas dépasser des bornes fixées par Factusur. Un dépassement renvoie une erreur claire, rate_limited, avec le délai à respecter.

Fichiers, données et journal

Le serveur applique exactement les règles du site, rappelées sur la page Sécurité et données :

• les fichiers sont vérifiés avant tout traitement (format réel, taille, nombre de pages) ; les classeurs avec macros et les anciens formats Excel sont refusés ;
• l'original est supprimé dès la génération du Factur-X ; le Factur-X l'est au plus tard deux heures après le premier téléchargement, et vingt-cinq heures après le dépôt ;
• les liens de téléchargement sont à usage unique et valables quinze minutes ;
• un journal d'activité consultable dans votre compte indique l'application, l'action, la date et le résultat. Il ne contient jamais le contenu de vos factures et il est conservé quatre-vingt-dix jours.

Questions fréquentes

Le serveur transmet-il mes factures à l'administration ?

Non. Factusur n'est pas une plateforme agréée et ne transmet aucune facture : il crée un fichier Factur-X que vous téléchargez. La transmission passe par la plateforme agréée de votre choix.

Que faire si une application ne doit plus y avoir accès ?

Dans Compte › Connexions MCP, cliquez sur « Déconnecter » : l'autorisation et tous les jetons de l'application sont révoqués immédiatement. Pour une clé d'accès, cliquez sur « Révoquer ».

Les contrôles garantissent-ils que ma facture est conforme ?

Ils vérifient la structure du fichier (PDF/A-3, XML, schéma XSD, règles EN 16931 et mentions attendues en France) à une date donnée. Ils ne constituent ni une certification ni une attestation de conformité fiscale. Le détail est expliqué sur la page Sécurité du serveur MCP : accès, données, paiement.