Aller au contenu
Factusur
Déposer ma facture

Guide d’installation · VS Code (Copilot)

Convertir des factures en Factur-X depuis VS Code

Installez le serveur MCP de Factusur dans VS Code en un clic ou via .vscode/mcp.json, puis convertissez vos factures avec Copilot en mode Agent.

Installer Factusur dans VS Code (Copilot)

Un clic sur « Installer dans VS Code », une commande, ou un fichier de configuration.

Installer dans VS CodeOuvre VS Code (Copilot) et pré-remplit la configuration.
  1. Étape 1 : Cliquez sur « Installer dans VS Code », ou lancez la commande code --add-mcp ci-dessous.
  2. Étape 2 : Démarrez le serveur factusur (vue MCP ou fichier de configuration) : VS Code propose de vous connecter, la page de Factusur s’ouvre.
  3. Étape 3 : Dans le chat Copilot en mode Agent, demandez : « Convertis facture.pdf en Factur-X avec Factusur ».
Terminal
code --add-mcp '{"name":"factusur","type":"http","url":"https://factusur.com/mcp"}'

.vscode/mcp.json
{
  "servers": {
    "factusur": {
      "type": "http",
      "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é.

.vscode/mcp.json avec une clé d’accès
{
  "inputs": [
    {
      "type": "promptString",
      "id": "factusur-key",
      "description": "Clé d’accès Factusur",
      "password": true
    }
  ],
  "servers": {
    "factusur": {
      "type": "http",
      "url": "https://factusur.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:factusur-key}"
      }
    }
  }
}

VS Code demande la clé au premier lancement et la garde dans son coffre : elle n’est pas écrite dans le fichier.

Connexion : OAuth (enregistrement automatique du client) ou clé d’accès saisie dans VS Code. Source : Documentation VS Code (configuration MCP) (nouvel onglet), vérifiée le 26/10/2026.

Que demander à VS Code (Copilot) ?

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.