Serveur MCP Lio : installation dans Claude, ChatGPT, Mistral Vibe, Gemini, Cursor et tout client MCP
Tout ce qu’il faut pour connecter un assistant IA à votre compte Lio : l’adresse du serveur, le fonctionnement de la connexion OAuth, les autorisations, la marche à suivre pour chaque assistant et les solutions aux erreurs courantes.
https://app.lio-app.com/api/mcpAdresse du serveur et prérequis
| Élément | Valeur |
|---|---|
| Adresse (URL) | https://app.lio-app.com/api/mcp |
| Transport | HTTP streamable (serveur distant, pas d’installation locale) |
| Authentification | OAuth 2.1 : code d’autorisation avec PKCE (S256) et enregistrement dynamique du client |
| Alternative technique | Clé API Authorization: Bearer lio_sk_… pour les clients en ligne de commande, selon la documentation de l’API |
| Compte nécessaire | Un compte Lio (voir les tarifs) et un assistant compatible MCP |
| Côté Lio | Paramètres → Développeur : guides de connexion et connexions actives. Aucune connexion n’existe par défaut. |
Comment se passe la connexion OAuth
Vous n’avez ni mot de passe ni clé à copier dans l’assistant. Voici ce que vous voyez, dans l’ordre.
- 1
Vous ajoutez l’adresse du serveur
Dans les réglages de connecteurs de votre assistant, vous créez un connecteur personnalisé avec l’adresse Lio. - 2
L’assistant s’enregistre auprès de Lio
Il le fait automatiquement (enregistrement dynamique) : vous n’avez pas d’identifiant client à saisir. - 3
La page de connexion Lio s’ouvre
Vous vous identifiez sur app.lio-app.com, comme d’habitude. - 4
Vous validez l’écran de consentement
Lio affiche l’application qui demande l’accès et les autorisations demandées. Vous acceptez ou refusez. - 5
L’assistant reçoit un jeton d’accès
Il peut alors utiliser les outils Lio autorisés. Le jeton est renouvelé automatiquement jusqu’à ce que vous révoquiez la connexion.
| Pour les développeurs | Valeur |
|---|---|
| Métadonnées de la ressource | https://app.lio-app.com/.well-known/oauth-protected-resource |
| Métadonnées du serveur d’autorisation | https://app.lio-app.com/.well-known/oauth-authorization-server |
| Autorisation | https://app.lio-app.com/oauth/authorize |
| Jeton | https://app.lio-app.com/api/oauth/token |
| Enregistrement dynamique | https://app.lio-app.com/api/oauth/register |
| Flux et PKCE | authorization_code et refresh_token ; code_challenge_method=S256 |
Les 11 scopes : ce que l’IA peut faire avec chacun
Un scope est une autorisation précise. L’écran de consentement Lio indique ceux demandés par l’assistant. Accordez uniquement ce dont vous avez besoin.
| Scope | Ce que l’IA peut faire | Type |
|---|---|---|
documents:readLire les documents | Lister et consulter vos factures et devis (lignes, statut, montants) et récupérer le lien du PDF. | Lecture |
documents:writeCréer et modifier les documents | Créer des factures et des devis, mettre à jour leur statut (par exemple « payée »), leurs notes ou leur échéance. | Écriture |
documents:sendEnvoyer les documents | Envoyer une facture ou un devis par e-mail à votre client, avec le PDF et, si demandé, un lien de paiement ou de signature. | Écriture |
clients:readLire les clients | Rechercher un client et consulter sa fiche (coordonnées, SIRET, type particulier ou professionnel). | Lecture |
clients:writeGérer les clients | Créer ou modifier une fiche client. | Écriture |
products:readLire le catalogue | Consulter vos produits et prestations (prix HT, taux de TVA, unité). | Lecture |
products:writeGérer le catalogue | Ajouter ou modifier un produit ou une prestation. | Écriture |
payments:readLire les paiements | Consulter les liens de paiement et leur statut. | Lecture |
payments:writeCréer des liens de paiement | Générer un lien de paiement Stripe ou SumUp (si le compte est connecté dans Lio), rattaché ou non à une facture ou un devis. | Écriture |
accounting:readLire la comptabilité | Obtenir la synthèse comptable (chiffre d’affaires par mois, trimestre ou année) et lire les transactions bancaires si une banque est connectée. | Lecture |
webhooks:manageGérer les webhooks | Créer, modifier ou supprimer des abonnements webhook. Usage technique (intégrations), inutile pour facturer en conversation. | Technique |
Les outils exposés par le serveur MCP Lio
L’assistant choisit lui-même l’outil à appeler selon votre demande. Liste publiée dans la documentation de l’API Lio, susceptible d’évoluer.
| Outil | Rôle | Type |
|---|---|---|
get_account | Informations du compte connecté | Lecture |
list_clients / get_client | Rechercher et lire les fiches clients | Lecture |
create_client | Créer un client | Écriture |
list_products | Lire le catalogue produits | Lecture |
create_product | Ajouter un produit ou une prestation | Écriture |
list_invoices / get_invoice | Lister et lire les factures | Lecture |
create_invoice / update_invoice | Créer une facture, mettre à jour son statut ou ses notes | Écriture |
list_quotes / get_quote | Lister et lire les devis | Lecture |
create_quote / update_quote | Créer un devis, mettre à jour son statut, ses notes ou sa validité | Écriture |
send_invoice / send_quote | Envoyer une facture ou un devis par e-mail | Écriture |
create_payment_link | Générer un lien de paiement Stripe ou SumUp | Écriture |
get_document_pdf | Obtenir le lien de téléchargement du PDF | Lecture |
get_accounting_summary | Synthèse comptable (chiffre d’affaires) | Lecture |
list_bank_transactions | Transactions bancaires (banque connectée dans Lio) | Lecture |
search / fetch | Recherche et lecture génériques (utilisées par certains assistants) | Lecture |
Limites documentées : les avoirs se créent depuis l’application Lio, un devis signé est verrouillé et ne peut plus être modifié, un lien de paiement nécessite un compte Stripe ou SumUp connecté dans Lio.
Installer Lio dans votre assistant
Parcours vérifiés dans la documentation officielle de chaque éditeur en septembre 2026. Les libellés sont indiqués tels qu’ils apparaissent dans ces documentations (souvent en anglais) : ils peuvent être traduits ou déplacés dans votre interface.
Claude
claude.ai, Claude Desktop, mobileOffres : connecteurs personnalisés disponibles sur les offres Free (un seul connecteur personnalisé), Pro, Max, Team et Enterprise, selon l’aide Anthropic.
- Ouvrez Customize → Connectors.
- Cliquez sur + puis Add custom connector.
- Collez l’adresse
https://app.lio-app.com/api/mcpet validez avec Add (les réglages OAuth avancés sont inutiles pour Lio). - Lancez la connexion : identifiez-vous sur Lio et acceptez l’écran de consentement.
- Dans une conversation, ouvrez le menu + puis Connectors et activez Lio.
Offres Team et Enterprise : un propriétaire ajoute d’abord le connecteur dans Organization settings → Connectors, puis chaque membre s’y connecte.
ChatGPT
Mode développeur (bêta)Offres : non disponible sur l’offre gratuite. Le mode développeur est proposé sur des offres payantes ; OpenAI réserve à ce jour la prise en charge complète des actions d’écriture à certaines offres (Business, Enterprise, Edu). Vérifiez l’état actuel dans l’aide OpenAI.
- Activez le mode développeur : Settings → Security and login → Developer mode.
- Ouvrez Plugins (chatgpt.com/plugins) et cliquez sur +.
- Renseignez un nom (« Lio »), une description, l’adresse
https://app.lio-app.com/api/mcpet l’authentification OAuth. - Connectez-vous à Lio et acceptez l’écran de consentement.
- Ouvrez une nouvelle conversation et ajoutez Lio depuis le menu des outils.
Espaces Business et Enterprise : le mode développeur doit être autorisé par un administrateur de l’espace de travail.
Mistral Vibe (anciennement Le Chat)
Vibe Work · Connecteur MCP personnaliséOffres : l’ajout d’un connecteur personnalisé est réservé aux administrateurs ; sur les offres Free, Pro et Student, le titulaire du compte est administrateur par défaut.
- Dans le mode Vibe Work, ouvrez la page Connectors depuis la barre latérale et cliquez sur + Add Connector.
- Choisissez l’onglet Custom MCP Connector.
- Nom :
lio(sans espace), adresse du serveur :https://app.lio-app.com/api/mcp, description facultative, puis Connect. - La méthode d’authentification est détectée automatiquement (OAuth 2.1) : suivez la connexion Lio et le consentement.
- Dans une conversation, cliquez sur + ou tapez
/, choisissez Tools et activez Lio.
Gemini
Selon l’édition et le paysApplication Gemini (gemini.google.com) : l’aide Google décrit l’ajout d’une application personnalisée via Settings → Connected Apps → Add a custom app, en collant l’adresse du serveur MCP. En septembre 2026, Google réserve cette option aux comptes personnels de personnes majeures situées aux États-Unis, avec l’interface en anglais : elle n’est donc pas accessible depuis la France pour l’instant.
Gemini Enterprise : dans l’édition Business, un administrateur peut ajouter un serveur MCP personnalisé depuis la gestion des applications connectées de l’équipe, avec authentification OAuth.
Gemini CLI : voir la configuration JSON ci-dessous.
Cursor, Claude Code, Gemini CLI
Clients avancésClaude Code : ajoutez le serveur en ligne de commande, puis tapez /mcp dans Claude Code pour lancer l’authentification.
claude mcp add --transport http lio https://app.lio-app.com/api/mcpCursor : ajoutez le serveur dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet). Cursor propose ensuite la connexion OAuth.
{
"mcpServers": {
"lio": {
"url": "https://app.lio-app.com/api/mcp"
}
}
}Gemini CLI : ajoutez le serveur dans ~/.gemini/settings.json, puis utilisez /mcp auth lio si l’authentification ne démarre pas d’elle-même.
{
"mcpServers": {
"lio": {
"httpUrl": "https://app.lio-app.com/api/mcp"
}
}
}Avec une clé API : la documentation de l’API Lio permet aussi d’envoyer une clé lio_sk_… créée dans Paramètres → Développeur. Stockez-la dans une variable d’environnement, jamais en clair dans un dépôt partagé.
{
"mcpServers": {
"lio": {
"url": "https://app.lio-app.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:LIO_API_KEY}"
}
}
}
}Tout client capable de se connecter à un serveur MCP distant en HTTP streamable avec OAuth 2.1 (PKCE et enregistrement dynamique) peut utiliser Lio : renseignez l’adresse https://app.lio-app.com/api/mcp et suivez la connexion.
Révoquer l’accès d’un assistant
- 1
Dans Lio
Ouvrez Paramètres → Développeur et révoquez la connexion de l’assistant concerné. L’accès est coupé immédiatement : ses prochaines requêtes sont refusées. - 2
Dans l’assistant
Retirez aussi le connecteur de ses réglages (Connectors, Plugins, Connected Apps…) pour ne plus le voir proposé. - 3
Pour reconnecter
Relancez la connexion depuis l’assistant : un nouvel écran de consentement s’affiche.
Révoquez les connexions que vous n’utilisez plus et relisez les demandes d’autorisation de l’assistant avant chaque action d’écriture. Les conditions applicables sont détaillées dans les conditions d’utilisation de l’IA.
Erreurs fréquentes et solutions
| Symptôme | Cause probable | Solution |
|---|---|---|
| 401 Unauthorized en ouvrant l’adresse dans un navigateur | Aucun jeton : le serveur exige une connexion OAuth. | Normal. Ajoutez l’adresse dans un client MCP, qui gère la connexion. |
| 401 alors que la connexion fonctionnait | Connexion révoquée dans Lio ou jeton expiré non renouvelé. | Déconnectez puis reconnectez le connecteur depuis l’assistant. |
| L’écran de consentement ne s’affiche pas | Fenêtre bloquée par le navigateur ou session interrompue. | Autorisez les fenêtres pop-up, connectez-vous d’abord sur app.lio-app.com, puis relancez la connexion. |
| Consentement refusé ou fenêtre fermée | L’assistant n’a pas reçu de jeton. | Relancez la connexion depuis l’assistant et acceptez l’écran de consentement. |
| 403 ou « scope manquant » sur une action | L’autorisation nécessaire (par exemple documents:send) n’a pas été accordée. | Reconnectez le connecteur et acceptez les scopes utiles (voir le tableau des scopes). |
| 403 quota_exceeded à la création d’une facture | Limite de factures de votre offre atteinte pour le mois. | Consultez les tarifs ou attendez le mois suivant. |
| L’assistant ne voit pas les outils Lio | Connecteur non activé dans la conversation ou liste d’outils en cache. | Activez Lio dans le menu des outils, ouvrez une nouvelle conversation ; dans ChatGPT, cliquez sur Refresh. |
| Lien de paiement impossible | Aucun compte Stripe ou SumUp connecté dans Lio. | Connectez un moyen de paiement dans Lio, puis réessayez. |
| Envoi par e-mail impossible | Le client n’a pas d’adresse e-mail enregistrée. | Ajoutez l’e-mail à la fiche client ou précisez le destinataire dans votre demande. |
FAQ
Serveur MCP Lio : questions fréquentes
Adresse, authentification, scopes et révocation.
Quelle est l’adresse du serveur MCP de Lio ?+
https://app.lio-app.com/api/mcp. Le serveur utilise le transport HTTP streamable et l’authentification OAuth 2.1. Ouverte directement dans un navigateur, cette adresse répond 401 : c’est normal, elle doit être ajoutée dans un client MCP.
Faut-il une clé API pour connecter Claude ou ChatGPT ?+
Non. Claude, ChatGPT, Mistral Vibe et la plupart des assistants gèrent OAuth : vous vous connectez à Lio et validez l’écran de consentement, sans copier de clé. La documentation de l’API Lio mentionne aussi une connexion par clé API (Authorization: Bearer lio_sk_…) pour des clients techniques comme Claude Code ou Gemini CLI.
Où voir et révoquer les assistants connectés à mon compte Lio ?+
Dans Lio, ouvrez Paramètres → Développeur, rubrique des assistants IA (MCP). Vous y retrouvez les guides de connexion et pouvez révoquer une connexion : l’accès est coupé immédiatement.
Quels scopes accorder à mon assistant ?+
Seulement ceux dont vous avez besoin. Pour consulter vos documents : documents:read et clients:read. Pour créer des devis et factures : documents:write en plus. Pour les envoyer par e-mail : documents:send. Le scope webhooks:manage est inutile pour un usage en conversation.
Pourquoi mon assistant ne trouve-t-il pas les outils Lio ?+
Le plus souvent, le connecteur n’est pas activé dans la conversation en cours. Activez-le depuis le menu des outils ou des connecteurs, ouvrez une nouvelle conversation, et dans ChatGPT utilisez « Refresh » sur l’application si la liste d’outils a changé.
Les données de mon compte Lio sont-elles envoyées à l’éditeur de l’IA ?+
Oui, pour les informations que l’assistant lit ou écrit pendant la conversation (clients, montants, documents) : elles sont traitées par l’éditeur de l’assistant (OpenAI, Anthropic, Google, Mistral AI…) selon ses propres conditions. Lio ne transmet rien tant que vous n’avez pas créé la connexion.

