[Aide en ligne - VosFactures ](https://aide.vosfactures.fr/index.md) / [API](https://aide.vosfactures.fr/int-grations-api.md)
# [Intégration MCP : Connectez VosFactures à ChatGPT, Claude et autres assistants IA](https://aide.vosfactures.fr/integration-assistants-ia-mcp-claude-chatgpt.md)
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 ? *
Attention ! L'intégration fonctionne en lecture seule - l'assistant IA ne peut ni émettre, ni modifier, ni supprimer des factures, des clients ou toute autre donnée sur le compte.
Les conditions d’utilisation du service MCP sont définies dans le [**Règlement du service MCP**](https://vosfactures.fr/conditions-utilisation#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.
Seuls les utilisateurs ayant le rôle de propriétaire du compte peuvent établir une connexion MCP.
## Votre adresse MCP
L'adresse du serveur MCP, c'est l'adresse URL de votre compte VosFactures suivie de `/mcp` :
```
https://.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
1. Dans ChatGPT, ouvrez **Paramètres → Plugins** et activez le **mode développeur**.
2. 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**.
3. 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**.
5. 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 :
À savoir : ChatGPT peut vous demander une autorisation supplémentaire avant certains appels, lorsqu'il s'apprête à transmettre au connecteur une information issue de votre conversation. Cette demande vient de ChatGPT, pas de VosFactures, et s'affiche au cas par cas. Vous pouvez répondre « Autoriser cette fois » ou « Toujours autoriser ».
## Connecter Claude à VosFactures via MCP
1. Ouvrez **Paramètres → Personnaliser → Connecteurs → Ajouter *:***
2. Remplissez :
**Nom du connecteur :** VosFactures
**Remote MCP server URL :** `https://mon-entreprise.vosfactures.fr/mc`
3. Cliquez sur **Continuer**, ensuite sur **Ajouter** et enfin sur **Connecter** - une fenêtre du navigateur va s'ouvrir avec votre compte VosFactures.
4. Connectez-vous si nécessaire, puis autorisez l'accès sur l'écran de consentement.
5. 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
1. Ajoutez le serveur :
```bash
claude mcp add VosFactures --transport http https://mon-entreprise.vosfactures.fr/mcp
```
Pour le rendre disponible dans tous vos projets, ajoutez `--scope user`.
2. 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 :
```json
{
"mcpServers": {
"VosFactures": {
"type": "http",
"url": "https://mon-entreprise.vosfactures.fr/mcp"
}
}
}
```
---
## Connecter Codex
```bash
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** :
```json
{
"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
1. 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**.
2. 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***](https://vosfactures.fr/conditions-utilisation#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.
### Liens Associés
* [Codes API du compte](/332396-codes-api-du-compte)
* [Connexion automatique à votre compte via API](/1161592-connexion-automatique-a-votre-compte-via-api)
* [Webhooks : intégration automatique](/16514912-webhooks-integration-automatique)