VosFactures prend en charge le protocole MCP (Model Context Protocol), un standard qui permet aux assistants IA (comme Claude, ChatGPT ou encore Codex) d’accéder de manière sécurisée aux données de votre compte et de répondre à vos questions sur vos factures et vos clients, sans avoir à copier manuellement vos données ni à renseigner de jetons API.
Qu’est-ce que le protocole MCP ?
Le MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA de se connecter à des outils et à des sources de données externes. VosFactures propose un serveur MCP : votre assistant IA peut lire les données de votre compte et répondre à vos questions en langage courant, sans passer par l’interface ni faire d’export vers un tableur.
Que peut faire l’assistant IA ?
Une fois connecté, votre assistant peut :
-
rechercher vos documents de vente et d’achat - par numéro, nom de l’acheteur, contact,
statut (émise, envoyée, payée, partiellement payée, rejetée), type de document (facture, proforma, avoir, facture d’acompte, facture de solde) et plage de dates ; -
consulter les données d’un client / fournisseur - coordonnées, adresse, n° d’identification fiscale,
numéro de compte bancaire, nombre de documents liés (recherche par identifiant du contact) ; -
vérifier les règlements d’un client / fournisseur - montants facturés, payés et restant à payer,
ventilés par devise et par plage de dates.
Exemples de questions :
- Quelles sont mes factures impayées les plus anciennes ?
- Combien la société Dupont me doit-elle encore ?
- Donne-moi le n° de TVA et l’adresse du contact dont l’identifiant est 123.
- Quel client paie systématiquement en retard ?
Les conditions d’utilisation du service MCP sont définies dans le Règlement du service MCP.
Que faut-il pour utiliser le MCP ?
- Un compte VosFactures, avec le rôle de propriétaire du compte.
-
Un client IA compatible avec les serveurs MCP distants en HTTP et l’autorisation
OAuth 2.1 avec PKCE (Claude, ChatGPT, Codex et autres). - L’adresse URL de votre compte - c’est l’adresse que vous utilisez pour vous connecter à votre compte depuis votre navigateur, par exemple https://mon-compte.vosfactures.fr. Vous la trouverez dans la barre d’adresse, tout en haut de votre navigateur, une fois connecté au compte. Elle servira à créer l’adresse du serveur MCP.
Votre adresse MCP
L’adresse du serveur MCP, c’est l’adresse URL de votre compte VosFactures suivie de /mcp :
https://<votre-prefixe>.vosfactures.fr/mcp
Si vous accédez à https://mon-entreprise.vosfactures.fr, votre adresse MCP est :
https://mon-entreprise.vosfactures.fr/mcp
Connecter ChatGPT à VosFactures via MCP
- Dans ChatGPT, ouvrez Paramètres → Plugins et activez le mode développeur.
- Ensuite cliquez sur Parcourir les plugins → Ajouter un plugin et remplissez :
- Nom : VosFactures
-
URL du serveur :
https://nom-du-compte.vosfactures.fr/mcp - Authentification : OAuth
ChatGPT affiche un avertissement indiquant que les serveurs MCP personnalisés ne sont pas vérifiés par OpenAI. Cochez la case de confirmation, puis sur Créer.
- Une fenêtre s’ouvre et vous demande si vous souhaitez vous connecter à votre compte VosFactures. Connectez-vous si nécessaire, puis cliquez sur Autoriser.
-
Et c’est fini ! - L’assistant AI ChatGTP a désormais accès à votre compte VosFactures en mode lecture seule.
Exemple de requête et de réponse générée directement dans ChatGPT :
Connecter Claude à VosFactures via MCP
-
Ouvrez Paramètres → Personnaliser → Connecteurs → Ajouter :
- Remplissez :
Nom du connecteur : VosFactures
Remote MCP server URL :https://mon-entreprise.vosfactures.fr/mc
- Cliquez sur Continuer, ensuite sur Ajouter et enfin sur Connecter - une fenêtre du navigateur va s’ouvrir avec votre compte VosFactures.
- Connectez-vous si nécessaire, puis autorisez l’accès sur l’écran de consentement.
- C’est prêt ! - L’assistant AI Claude a désormais accès à votre compte VosFactures en mode lecture seule.
Exemple de requête et de réponse générée directement dans Claude :
Connecter Claude Code
- Ajoutez le serveur :
claude mcp add VosFactures --transport http https://mon-entreprise.vosfactures.fr/mcp
Pour le rendre disponible dans tous vos projets, ajoutez --scope user.
- Connectez-vous (autorisation OAuth). Dans Claude Code, lancez :
/mcp
Sélectionnez VosFactures et confirmez. Le navigateur s’ouvre sur VosFactures.
Autre méthode — ajoutez une entrée à .mcp.json dans le dossier du projet :
{
"mcpServers": {
"VosFactures": {
"type": "http",
"url": "https://mon-entreprise.vosfactures.fr/mcp"
}
}
}
Connecter Codex
codex mcp add --url https://mon-entreprise.vosfactures.fr/mcp VosFactures
codex mcp login VosFactures
L’entrée est enregistrée dans ~/.codex/config.toml. Le navigateur s’ouvre sur VosFactures ; connectez-vous et validez l’accès.
Un autre client
Le serveur MCP de VosFactures fonctionne avec tout client prenant en charge les serveurs MCP distants en Streamable HTTP et OAuth 2.0. Il suffit d’indiquer l’adresse du serveur :
Vous n’avez aucune application à créer, ni client_id ni secret à recopier : le client s’enregistre automatiquement (Dynamic Client Registration) et l’accès s’obtient par la connexion OAuth dans le navigateur.
Vous avez plusieurs comptes ?
L’accès est lié à un compte précis (son sous-domaine). Pour plusieurs comptes, ajoutez une
entrée distincte par compte :
{
"mcpServers": {
"VosFactures - Société A": {
"type": "http",
"url": "https://societe-a.vosfactures.fr/mcp"
},
"VosFactures - Société B": {
"type": "http",
"url": "https://societe-b.vosfactures.fr/mcp"
}
}
}
Chaque entrée demande sa propre autorisation. Le jeton d’un compte ne donne pas accès à l’autre.
Comment révoquer l’accès d’une application IA
- Dans VosFactures, allez dans Paramètres → Paramètres du compte → onglet Intégration.
Dans la section Intelligence Artificielle, cliquez sur Gérer l’accès des Apps IA.
- La liste des autorisations actives s’affiche, avec le nom de l’application et la date d’autorisation. Chacune dispose d’une option Révoquer l’accès.
Vous pouvez également révoquer l’accès depuis les réglages de votre client IA.
Sécurité et confidentialité
- Lecture seule. Le serveur MCP n’exécute que des requêtes de lecture, sur une connexion dédiée et avec une limite de durée d’exécution : l’assistant ne peut ni modifier vos données, ni surcharger le système.
- Aucun mot de passe ni jeton à coller. L’accès passe par une connexion OAuth 2.1 standard avec PKCE, dans votre navigateur. Le client IA ne voit jamais votre mot de passe.
- Accès limité à un seul compte. Un jeton émis pour un compte ne fonctionne pas sur un autre.
- Révocable et visible à tout moment. Vous pouvez vérifier qui a accès et le retirer quand vous le souhaitez.
- Vos données dans la conversation avec l’IA. Lorsque l’assistant lit vos données pour répondre, le résultat est transmis au fournisseur du modèle (par ex. Anthropic, OpenAI) selon les conditions de votre client IA - comme pour tout autre usage de cet assistant. Selon le fournisseur et votre formule, ces données peuvent être traitées en dehors de l’EEE ou utilisées pour améliorer des modèles. Ne connectez le MCP qu’à un client auquel vous faites confiance.
Le détail figure dans les Conditions du service MCP .
Problèmes fréquents
Le navigateur ne s’ouvre pas, ou la connexion ne se termine pas.
Relancez l’autorisation. Vérifiez que vous êtes connecté au bon compte VosFactures dans le même navigateur.
« Accès au compte refusé » ou erreur après validation.
L’utilisateur connecté doit avoir accès au compte de l’adresse indiquée, avec le rôle de propriétaire. Vérifiez que le préfixe de l’adresse correspond bien à la bonne société.
L’assistant ne voit pas les outils, ou le serveur est « failed ».
Vérifiez l’adresse du serveur (elle doit se terminer par /mcp) et votre connexion.
La réponse est vide ou « introuvable ».
Précisez votre question (plage de dates, statut, devise). Les résultats sont limités au compte connecté et aux données lisibles par les trois outils disponibles.
La première réponse est longue à venir.
Au premier appel, le client IA découvre les outils disponibles. Les réponses suivantes sont plus rapides.