Aller au contenu
Factusur
Déposer ma facture

Guide d’installation · Claude Code

Convertir une facture en Factur-X depuis Claude Code

Ajoutez Factusur à Claude Code en une commande, connectez votre compte, puis convertissez vos factures PDF en Factur-X depuis le terminal.

Installer Factusur dans Claude Code

Une commande dans le terminal, puis une connexion à votre compte depuis le navigateur.

  1. Étape 1 : Dans un terminal, ajoutez le serveur avec la commande ci-dessous (option --scope user : disponible dans tous vos projets).
  2. Étape 2 : Ouvrez Claude Code, tapez /mcp, choisissez factusur puis « Authenticate » : votre navigateur s’ouvre sur Factusur.
  3. Étape 3 : Connectez-vous et vérifiez ce que Claude pourra faire, puis cliquez sur « Autoriser ».
  4. Étape 4 : Demandez par exemple : « Convertis facture-042.pdf en Factur-X avec Factusur ».
Terminal
claude mcp add --transport http --scope user factusur https://factusur.com/mcp

.mcp.json (projet partagé)
{
  "mcpServers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp"
    }
  }
}

À la racine d’un dépôt, pour toute l’équipe. Chacun se connecte avec son propre compte.

Utiliser une clé d’accès plutôt qu’OAuth

Pour un script, l’intégration continue ou un outil sans connexion OAuth. Créez une clé dans Compte › Connexions MCP : elle s’affiche une seule fois. Ne la collez jamais dans un fichier versionné.

Avec une clé d’accès
claude mcp add --transport http --scope user factusur https://factusur.com/mcp \
  --header "Authorization: Bearer fsk_live_VOTRE_CLE"

Connexion : OAuth (connexion dans le navigateur) ou clé d’accès dans un en-tête. Source : Documentation Claude Code (MCP) (nouvel onglet), vérifiée le 26/10/2026.

Que demander à Claude Code ?

convert_to_facturxConversiondécompte une conversion

Convertir une facture

PDF, photo ou données structurées → Factur-X EN 16931, avec rapport de contrôle et lien de téléchargement. Si une information obligatoire manque, l’agent vous la demande.

  • « Convertis facture-042.pdf en Factur-X avec Factusur. »
  • « Crée un Factur-X pour cette facture : 3 jours de conseil à 450 € HT, client Exemple SAS. »
validate_facturxVérificationne décompte rien

Vérifier un Factur-X

Contrôle PDF/A-3, XML, XSD, schématron EN 16931 et mentions françaises d’un Factur-X reçu. Ne décompte aucune conversion.

  • « Vérifie le Factur-X que m’a envoyé mon fournisseur et dis-moi ce qui ne va pas. »
get_usageLecturene décompte rien

Quota et formule

Conversions utilisées et restantes, date de remise à zéro, plafonds de sécurité.

  • « Combien de conversions me reste-t-il ce mois-ci ? »
Tous les outils du serveur MCP

Dépannage

« 401 » ou « authentification requise »

Relancez la connexion depuis votre outil (/mcp dans Claude Code, « Connect » dans Cursor, codex mcp login). Une clé révoquée ou expirée doit être remplacée.

« quota_exceeded »

Votre quota du mois est atteint : ouvrez le lien affiché par l’agent pour changer de formule ou ajouter un pack, puis demandez à l’agent de reprendre la conversion (rien n’est relu).

« needs_input » : informations manquantes

La facture ne contient pas toutes les mentions obligatoires (SIREN du client, date…). Donnez-les à l’agent : il les corrige avec update_conversion puis relance.

« rate_limited »

Un plafond de sécurité est atteint (appels par minute, conversions par jour). Patientez, ou ajustez vos plafonds dans Compte › Connexions MCP.

Fichier trop lourd

Au-delà de 3 Mo, l’agent doit passer par create_upload_url (dépôt direct, 10 Mo au plus). Un PDF de plus de 10 pages est refusé : déposez uniquement la facture.

Mon outil ne trouve pas le serveur

Vérifiez l’URL exacte https://factusur.com/mcp et le transport « http » (Streamable HTTP). Les anciens clients limités au transport SSE ne sont pas pris en charge.

Accès, données et paiement : la sécurité du serveur MCP.

Factusur n'est pas une plateforme agréée (PA) et ne transmet pas vos factures. Nous créons un fichier au format Factur-X à partir des informations que vous validez.