Convertir une facture en Factur-X depuis Claude Code ou Cursor

En bref

• Claude Code et Cursor savent utiliser des outils externes grâce au Model Context Protocol (MCP), une spécification ouverte. Factusur publie un serveur MCP à l'adresse https://factusur.com/mcp.
• L'installation tient en une commande dans Claude Code et en un clic (ou quelques lignes de mcp.json) dans Cursor. Vous vous connectez ensuite à votre compte Factusur dans le navigateur : aucune clé à copier.
• Vous demandez simplement « convertis cette facture en Factur-X » : l'assistant appelle l'outil de conversion, vous montre le rapport de contrôle et vous donne un lien de téléchargement valable quinze minutes.
• Chaque Factur-X conforme décompte une conversion de votre formule, exactement comme sur le site. L'agent ne peut jamais payer ni changer de formule à votre place.
• Factusur n'est pas une plateforme agréée : il crée le fichier Factur-X, il ne le transmet pas à votre client.

Pourquoi convertir ses factures depuis son éditeur ?

Beaucoup d'indépendants du numérique — développeurs, consultants, studios — passent leur journée dans un éditeur de code ou un terminal. Leurs factures, elles, sortent souvent d'un modèle maison : un PDF généré par un script, un export d'outil de gestion de projet, voire un document rédigé à la main. Avec la généralisation de la facture électronique, ces PDF doivent devenir des fichiers Factur-X : un PDF lisible par un humain qui embarque, dans le même fichier, les données structurées de la facture au format XML.

Ouvrir un site web, déposer le fichier, vérifier les champs puis télécharger le résultat reste la méthode la plus simple pour une facture de temps en temps. Mais quand la facture est déjà produite par un script, ou quand on en convertit une dizaine chaque mois, rester dans son environnement de travail fait gagner du temps : l'assistant lit le fichier sur votre disque, appelle l'outil, et range le Factur-X à côté de l'original. Si vous préférez l'interface web, la page Convertir une facture PDF en Factur-X fait exactement le même travail, avec le même quota.

Ce qu'est un serveur MCP, en deux phrases

Le Model Context Protocol est un standard ouvert qui décrit comment un assistant d'IA découvre et appelle des « outils » proposés par un service tiers. Un serveur MCP expose ces outils ; un client MCP (Claude Code, Cursor, VS Code, Codex…) les présente au modèle, qui décide de les utiliser selon votre demande.

Le serveur de Factusur est un serveur distant : il n'y a rien à installer sur votre machine, ni Node.js, ni Python, ni conteneur. Votre client se connecte en HTTPS à https://factusur.com/mcp (transport « Streamable HTTP » de la spécification) et s'authentifie avec votre compte. Le détail des outils disponibles est présenté sur la page Serveur MCP Factur-X pour Claude, Cursor et VS Code.

Installer Factusur dans Claude Code

Claude Code ajoute un serveur distant avec la commande claude mcp add. L'option --scope user rend le serveur disponible dans tous vos projets :

claude mcp add --transport http --scope user factusur https://factusur.com/mcp

Ouvrez ensuite Claude Code et tapez /mcp. Choisissez factusur, puis « Authenticate ». Votre navigateur s'ouvre sur une page de Factusur : connectez-vous (par lien e-mail, sans mot de passe), lisez ce que Claude Code pourra faire, puis cliquez sur « Autoriser ». De retour dans le terminal, le serveur apparaît comme connecté.

Pour partager la configuration avec une équipe, vous pouvez aussi déclarer le serveur dans un fichier .mcp.json à la racine du dépôt ; chaque membre se connecte alors avec son propre compte, et donc son propre quota. Toutes les variantes sont détaillées dans le guide Convertir des factures en Factur-X depuis Claude Code.

Installer Factusur dans Cursor

Dans Cursor, le plus rapide est le bouton « Ajouter à Cursor » de la page de documentation : il ouvre Cursor avec la configuration pré-remplie. Vous pouvez aussi écrire vous-même la configuration dans ~/.cursor/mcp.json (pour tous vos projets) ou .cursor/mcp.json (pour un seul projet) :

{
  "mcpServers": {
    "factusur": { "url": "https://factusur.com/mcp" }
  }
}

Dans les réglages MCP de Cursor, cliquez ensuite sur « Connect » à côté de factusur : la même page d'autorisation de Factusur s'ouvre. Le guide Convertir des factures en Factur-X depuis Cursor reprend ces étapes, avec la variante par clé d'accès pour les environnements sans navigateur.

Votre première conversion, pas à pas

Une fois le serveur connecté, la conversion se demande en langage naturel. Par exemple, dans un dossier qui contient facture-042.pdf :

Convertis facture-042.pdf en Factur-X avec Factusur et range le résultat dans le dossier factures/.

L'assistant envoie le fichier à l'outil convert_to_facturx. Côté Factusur, la suite est la même que sur le site :

1. Contrôle du fichier. Le format réel est vérifié (un fichier renommé en .pdf est refusé), ainsi que la taille et le nombre de pages. Aucune adresse web distante n'est acceptée : le fichier vient de votre machine, pas d'une URL.
2. Lecture des informations. Le vendeur, le client, les lignes, les totaux et la TVA sont lus automatiquement. Une facture déjà structurée (données JSON) peut aussi être envoyée directement, sans lecture automatique.
3. Contrôle des mentions obligatoires. S'il manque une information indispensable — le SIREN du client, une date, une mention de TVA —, la conversion s'arrête au statut « informations manquantes ». L'assistant vous pose la question, corrige le champ avec l'outil update_conversion, puis relance.
4. Génération et contrôles. Le Factur-X est produit au profil EN 16931 de Factur-X 1.09.2, puis contrôlé : PDF/A-3, XML embarqué, schéma XSD et règles de la norme européenne.
5. Téléchargement. Si le fichier est conforme, une conversion est décomptée et l'assistant reçoit un lien de téléchargement à usage unique, valable quinze minutes.

Le compte rendu de l'assistant indique le résultat des contrôles, le nombre de conversions restantes et le lien du fichier. Rien n'est envoyé à votre client : c'est vous qui transmettez ensuite le Factur-X, ou qui l'importez dans votre plateforme.

Plusieurs factures d'un coup

Pour un mois complet, l'outil batch_convert traite jusqu'à vingt factures dans un même lot et renvoie une archive ZIP en plus des liens individuels. Le décompte est « tout ou rien » : si vos conversions restantes ne suffisent pas pour tout le lot, rien n'est décompté et l'assistant vous l'explique. Une demande comme « convertis toutes les factures PDF du dossier octobre/ en Factur-X » suffit. L'accès au lot suit les mêmes règles que sur le site.

Et si le quota est atteint ?

Chaque formule comprend un nombre de conversions par mois, partagé entre le site et vos assistants. Quand il est atteint, la conversion s'arrête avant toute lecture et l'assistant reçoit un message prêt à vous montrer : votre consommation, la formule recommandée, son prix TTC et un lien vers la page de paiement. Ce lien, seul vous pouvez l'ouvrir : la page demande votre connexion et votre confirmation, puis le paiement se fait dans votre navigateur. Aucun outil du serveur ne peut payer, changer de formule ou acheter un pack. Une fois la formule changée, demandez à l'assistant de reprendre : la facture déjà lue n'est pas relue.

Les formules et leurs prix sont présentés sur la page Tarifs.

Les bonnes pratiques

• Relisez le rapport. L'assistant vous résume les contrôles ; en cas d'avertissement, lisez-le avant d'envoyer la facture. Le rapport ne constitue pas une attestation de conformité fiscale.
• Gardez la main sur les corrections. Quand une information manque, l'assistant doit vous la demander plutôt que l'inventer. Les prompts fournis par le serveur le rappellent explicitement.
• Une clé seulement si nécessaire. OAuth suffit pour Claude Code et Cursor. Une clé d'accès (préfixe fsk_live_) sert aux scripts et à l'intégration continue ; elle s'affiche une seule fois, expire et se révoque d'un clic dans votre compte.
• Vérifiez aussi ce que vous recevez. L'outil validate_facturx contrôle un Factur-X reçu d'un fournisseur, sans décompter de conversion — l'équivalent du validateur Factur-X gratuit.

Questions fréquentes

Faut-il payer pour essayer ?

Non. Un compte gratuit comprend cinq conversions par mois, utilisables depuis le site comme depuis un assistant. La vérification d'un Factur-X ne décompte rien.

Mes factures servent-elles à entraîner un modèle ?

Non. Les factures ne servent qu'à votre conversion. Les fichiers suivent les mêmes règles que sur le site : l'original est supprimé après la génération, le Factur-X au plus tard deux heures après le premier téléchargement et vingt-cinq heures après le dépôt.

Est-ce un outil officiel d'Anthropic ou de Cursor ?

Non. Le serveur est édité par Factusur et suit la spécification ouverte MCP ; il n'est affilié ni à Anthropic ni à Cursor. Il fonctionne avec tout client compatible avec le transport HTTP de la spécification.