Aller au contenu principal
Documentation · Serveur MCP Lio

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.

Étape 0

Adresse du serveur et prérequis

Caractéristiques techniques du serveur MCP Lio
Adresse (URL)https://app.lio-app.com/api/mcp
TransportHTTP streamable (serveur distant, pas d’installation locale)
AuthentificationOAuth 2.1 : code d’autorisation avec PKCE (S256) et enregistrement dynamique du client
Alternative techniqueClé API Authorization: Bearer lio_sk_… pour les clients en ligne de commande, selon la documentation de l’API
Compte nécessaireUn compte Lio (voir les tarifs) et un assistant compatible MCP
Côté LioParamètres → Développeur : guides de connexion et connexions actives. Aucune connexion n’existe par défaut.
Connexion

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. 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. 2

    L’assistant s’enregistre auprès de Lio

    Il le fait automatiquement (enregistrement dynamique) : vous n’avez pas d’identifiant client à saisir.
  3. 3

    La page de connexion Lio s’ouvre

    Vous vous identifiez sur app.lio-app.com, comme d’habitude.
  4. 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. 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.
Points de terminaison OAuth du serveur MCP Lio
Métadonnées de la ressourcehttps://app.lio-app.com/.well-known/oauth-protected-resource
Métadonnées du serveur d’autorisationhttps://app.lio-app.com/.well-known/oauth-authorization-server
Autorisationhttps://app.lio-app.com/oauth/authorize
Jetonhttps://app.lio-app.com/api/oauth/token
Enregistrement dynamiquehttps://app.lio-app.com/api/oauth/register
Flux et PKCEauthorization_code et refresh_token ; code_challenge_method=S256
Autorisations

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.

Scopes OAuth du serveur MCP Lio
documents:readLire les documentsLister et consulter vos factures et devis (lignes, statut, montants) et récupérer le lien du PDF.Lecture
documents:writeCréer et modifier les documentsCréer des factures et des devis, mettre à jour leur statut (par exemple « payée »), leurs notes ou leur échéance.Écriture
documents:sendEnvoyer les documentsEnvoyer 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 clientsRechercher un client et consulter sa fiche (coordonnées, SIRET, type particulier ou professionnel).Lecture
clients:writeGérer les clientsCréer ou modifier une fiche client.Écriture
products:readLire le catalogueConsulter vos produits et prestations (prix HT, taux de TVA, unité).Lecture
products:writeGérer le catalogueAjouter ou modifier un produit ou une prestation.Écriture
payments:readLire les paiementsConsulter les liens de paiement et leur statut.Lecture
payments:writeCréer des liens de paiementGé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 webhooksCréer, modifier ou supprimer des abonnements webhook. Usage technique (intégrations), inutile pour facturer en conversation.Technique
Outils

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.

Outils du serveur MCP Lio
get_accountInformations du compte connectéLecture
list_clients / get_clientRechercher et lire les fiches clientsLecture
create_clientCréer un clientÉcriture
list_productsLire le catalogue produitsLecture
create_productAjouter un produit ou une prestationÉcriture
list_invoices / get_invoiceLister et lire les facturesLecture
create_invoice / update_invoiceCréer une facture, mettre à jour son statut ou ses notesÉcriture
list_quotes / get_quoteLister et lire les devisLecture
create_quote / update_quoteCréer un devis, mettre à jour son statut, ses notes ou sa validitéÉcriture
send_invoice / send_quoteEnvoyer une facture ou un devis par e-mailÉcriture
create_payment_linkGénérer un lien de paiement Stripe ou SumUpÉcriture
get_document_pdfObtenir le lien de téléchargement du PDFLecture
get_accounting_summarySynthèse comptable (chiffre d’affaires)Lecture
list_bank_transactionsTransactions bancaires (banque connectée dans Lio)Lecture
search / fetchRecherche 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.

Pas à pas

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, mobile

Offres : connecteurs personnalisés disponibles sur les offres Free (un seul connecteur personnalisé), Pro, Max, Team et Enterprise, selon l’aide Anthropic.

  1. Ouvrez Customize → Connectors.
  2. Cliquez sur + puis Add custom connector.
  3. Collez l’adresse https://app.lio-app.com/api/mcp et validez avec Add (les réglages OAuth avancés sont inutiles pour Lio).
  4. Lancez la connexion : identifiez-vous sur Lio et acceptez l’écran de consentement.
  5. 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.

Guide complet pour Claude

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.

  1. Activez le mode développeur : Settings → Security and login → Developer mode.
  2. Ouvrez Plugins (chatgpt.com/plugins) et cliquez sur +.
  3. Renseignez un nom (« Lio »), une description, l’adresse https://app.lio-app.com/api/mcp et l’authentification OAuth.
  4. Connectez-vous à Lio et acceptez l’écran de consentement.
  5. 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.

Guide complet pour ChatGPT

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.

  1. Dans le mode Vibe Work, ouvrez la page Connectors depuis la barre latérale et cliquez sur + Add Connector.
  2. Choisissez l’onglet Custom MCP Connector.
  3. Nom : lio (sans espace), adresse du serveur : https://app.lio-app.com/api/mcp, description facultative, puis Connect.
  4. La méthode d’authentification est détectée automatiquement (OAuth 2.1) : suivez la connexion Lio et le consentement.
  5. Dans une conversation, cliquez sur + ou tapez /, choisissez Tools et activez Lio.
Guide complet pour Mistral Vibe

Gemini

Selon l’édition et le pays

Application 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és

Claude Code : ajoutez le serveur en ligne de commande, puis tapez /mcp dans Claude Code pour lancer l’authentification.

Terminal
Shell
claude mcp add --transport http lio https://app.lio-app.com/api/mcp

Cursor : ajoutez le serveur dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet). Cursor propose ensuite la connexion OAuth.

mcp.json
JSON
{
  "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.

settings.json
JSON
{
  "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é.

mcp.json (clé API)
JSON
{
  "mcpServers": {
    "lio": {
      "url": "https://app.lio-app.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LIO_API_KEY}"
      }
    }
  }
}
Autre client compatible MCP

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.

Contrôle

Révoquer l’accès d’un assistant

  1. 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. 2

    Dans l’assistant

    Retirez aussi le connecteur de ses réglages (Connectors, Plugins, Connected Apps…) pour ne plus le voir proposé.
  3. 3

    Pour reconnecter

    Relancez la connexion depuis l’assistant : un nouvel écran de consentement s’affiche.
Bon réflexe

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.

Dépannage

Erreurs fréquentes et solutions

Dépannage de la connexion au serveur MCP Lio
401 Unauthorized en ouvrant l’adresse dans un navigateurAucun 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 fonctionnaitConnexion 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 pasFenê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éeL’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 actionL’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 factureLimite de factures de votre offre atteinte pour le mois.Consultez les tarifs ou attendez le mois suivant.
L’assistant ne voit pas les outils LioConnecteur 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 impossibleAucun compte Stripe ou SumUp connecté dans Lio.Connectez un moyen de paiement dans Lio, puis réessayez.
Envoi par e-mail impossibleLe 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.

Application Lio - Logiciel de devis et facture pour TPE et entreprises en France
Connecteur MCP · Lio ·

Prêt à connecter votre assistant ?

Créez votre compte Lio, copiez l’adresse du serveur MCP et suivez le parcours de votre assistant.

QR Code - Télécharger l'application Lio