Aller au contenu
Factusur
Déposer ma facture

Guide d’installation · Cursor

Convertir des factures en Factur-X depuis Cursor

Ajoutez le serveur MCP de Factusur à Cursor en un clic ou via mcp.json, puis convertissez et vérifiez vos factures Factur-X depuis l’agent.

Installer Factusur dans Cursor

Un clic sur « Ajouter à Cursor », ou quelques lignes dans mcp.json.

Ajouter à CursorOuvre Cursor et pré-remplit la configuration.
  1. Étape 1 : Cliquez sur « Ajouter à Cursor » (Cursor doit être installé), ou collez la configuration dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet).
  2. Étape 2 : Dans Cursor › Settings › MCP, cliquez sur « Connect » à côté de factusur : la page de Factusur s’ouvre pour l’autorisation.
  3. Étape 3 : Dans le chat (mode Agent), demandez : « Convertis cette facture en Factur-X avec Factusur ».
mcp.json
{
  "mcpServers": {
    "factusur": {
      "url": "https://factusur.com/mcp"
    }
  }
}

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é.

mcp.json avec une clé d’accès
{
  "mcpServers": {
    "factusur": {
      "url": "https://factusur.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FACTUSUR_API_KEY}"
      }
    }
  }
}

La clé est lue dans la variable d’environnement FACTUSUR_API_KEY : elle n’apparaît pas dans le fichier.

Connexion : OAuth (enregistrement automatique du client) ou clé d’accès dans un en-tête. Source : Documentation Cursor (MCP) (nouvel onglet), vérifiée le 26/10/2026.

Que demander à Cursor ?

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.