Aller au contenu
Factusur
Déposer ma facture

Guide d’installation · Codex (OpenAI)

Convertir des factures en Factur-X depuis Codex

Ajoutez Factusur à Codex avec codex mcp add, connectez votre compte, puis convertissez vos factures PDF en Factur-X depuis le terminal.

Installer Factusur dans Codex (OpenAI)

Deux commandes : ajout du serveur, puis connexion à votre compte.

  1. Étape 1 : Ajoutez le serveur avec codex mcp add.
  2. Étape 2 : Lancez codex mcp login factusur : votre navigateur s’ouvre sur Factusur pour l’autorisation.
  3. Étape 3 : Dans Codex, demandez : « Convertis facture.pdf en Factur-X avec Factusur ».
Terminal
codex mcp add factusur --url https://factusur.com/mcp
codex mcp login factusur

~/.codex/config.toml
[mcp_servers.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é.

config.toml avec une clé d’accès
[mcp_servers.factusur]
url = "https://factusur.com/mcp"
bearer_token_env_var = "FACTUSUR_API_KEY"

Codex lit la clé dans la variable d’environnement FACTUSUR_API_KEY.

Connexion : OAuth ou clé d’accès lue dans une variable d’environnement. Source : Documentation Codex (MCP) (nouvel onglet), vérifiée le 26/10/2026.

Que demander à Codex (OpenAI) ?

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.