Connecter un assistant à LexOpti
Le serveur MCP LexOpti permet à un assistant IA de travailler dans votre organisation LexOpti en votre nom : retrouver un client, lire où en est sa vigilance, lister les alertes à traiter, suivre une analyse, en lancer une et traiter une alerte. L’assistant agit avec votre rôle dans une organisation, et le journal d’audit enregistre chacune de ses actions comme venant de l’assistant.
https://app.lexopti.com/mcpLe serveur parle le Model Context Protocol en Streamable HTTP et vous connecte par OAuth : vous ne donnez à votre assistant que cette URL.
Ce serveur s’adresse aux membres de LexOpti. Pour qu’un assistant cherche dans cette documentation pendant que vous écrivez une intégration, connectez plutôt le serveur MCP de documentation : le serveur MCP LexOpti n’a aucun outil de documentation.
Avant de commencer
Section intitulée « Avant de commencer »- Il vous faut un compte LexOpti membre de l’organisation dans laquelle l’assistant travaillera.
- Un propriétaire ou un administrateur connecte d’abord un assistant. Claude, Claude Code, VS Code et ChatGPT s’identifient par un document de métadonnées client. Tant qu’un propriétaire ou un administrateur de votre organisation n’a pas autorisé un tel assistant, les autres membres ne le peuvent pas : leur page de consentement les renvoie vers un propriétaire ou un administrateur. Le consentement du propriétaire ou de l’administrateur l’approuve pour toute l’organisation.
- Gardez l’approbation des outils d’écriture sur « demander à chaque fois » dans votre assistant, jamais sur « toujours autoriser » : quand votre assistant ne sait pas afficher le formulaire de confirmation de LexOpti, son approbation de l’appel est tout ce qui précède un lancement. Voir les confirmations.
Ce que l’assistant peut faire
Section intitulée « Ce que l’assistant peut faire »Avec lexopti:read, l’assistant retrouve des clients et lit leur vigilance, leurs dossiers, leurs alertes et leurs analyses ; avec lexopti:write, il lance aussi des analyses, crée des dossiers et traite des alertes. Il ne confirme jamais à votre place : avant un lancement, il appelle lexopti_preview_check et vous montre qui sera contrôlé et les crédits qu’il coûte, avant un dossier, il appelle lexopti_preview_case et vous montre son coût (sans le formulaire de LexOpti, le dossier n’est qu’une proposition que vous créez dans LexOpti), et le traitement d’une alerte est votre décision et votre motif, ou une proposition que vous validez dans LexOpti. La référence du serveur MCP LexOpti liste les outils, les confirmations et les limites.
Connecter votre assistant
Section intitulée « Connecter votre assistant »Sur claude.ai et Claude Desktop (offres Free, Pro et Max ; un seul connecteur personnalisé avec Free) :
- Ouvrez Customize > Connectors, choisissez +, puis Add custom connector.
- Nommez-le
LexOpti, collezhttps://app.lexopti.com/mcpet choisissez Continue. - Sous OAuth client, gardez Use Claude’s published identity (Recommended) : Claude s’identifie alors par son document de métadonnées client. Ne choisissez pas Register automatically, que LexOpti n’offre pas.
- Choisissez Add, puis Connect, et connectez-vous à LexOpti.
Avec une offre Team ou Enterprise, un propriétaire ajoute le connecteur dans Organization settings > Connectors (Add > Custom) ; chaque membre choisit ensuite Connect dans Customize > Connectors. Dans une conversation, activez le connecteur depuis + > Connectors.
Claude revient sur https://claude.ai/api/mcp/auth_callback une fois que vous êtes connecté.
Claude Code
Section intitulée « Claude Code »claude mcp add --transport http lexopti https://app.lexopti.com/mcpLancez ensuite /mcp dans une session, choisissez lexopti et authentifiez-vous dans le navigateur (ou lancez claude mcp login lexopti). Ajoutez --scope user pour utiliser LexOpti dans tous vos projets. Claude Code s’identifie par son document de métadonnées client.
VS Code 1.106 ou plus récent s’identifie par son document de métadonnées client. Ajoutez le serveur à .vscode/mcp.json dans votre espace de travail, ou à votre configuration utilisateur (MCP: Open User Configuration) :
{ "servers": { "lexopti": { "type": "http", "url": "https://app.lexopti.com/mcp" } }}Démarrez le serveur depuis le fichier ou depuis MCP: List Servers, puis connectez-vous à LexOpti quand VS Code le demande.
Sur ChatGPT, dans le navigateur :
- Ouvrez Plugins, choisissez +, puis Add custom MCP server.
- Nommez-le
LexOptiet saisissezhttps://app.lexopti.com/mcpcomme Server URL. - Choisissez l’authentification OAuth.
- Cochez I understand and want to continue, choisissez Create as a plugin, installez le plugin et connectez-vous à LexOpti.
ChatGPT s’identifie par son document de métadonnées client. Avec une offre Business, seuls les administrateurs et propriétaires de l’espace de travail peuvent ajouter un serveur ; avec Enterprise et Edu, les administrateurs peuvent le permettre à des membres. ChatGPT Pro n’accepte que les outils de lecture : l’assistant lit alors LexOpti, mais ne peut ni lancer une analyse, ni créer un dossier, ni traiter une alerte.
Cursor ne gère pas les documents de métadonnées client : il utilise un client public que LexOpti a enregistré pour Cursor. Ajoutez le serveur à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet :
{ "mcpServers": { "lexopti": { "url": "https://app.lexopti.com/mcp", "auth": { "CLIENT_ID": "<client id LexOpti pour Cursor>", "scopes": ["offline_access", "lexopti:read", "lexopti:write"] } } }}Cursor ouvre alors LexOpti pour la connexion, puis revient sur http://localhost:8787/callback.
Microsoft Copilot Studio
Section intitulée « Microsoft Copilot Studio »Copilot Studio utilise un client confidentiel que LexOpti enregistre pour votre organisation : écrivez à contact@lexopti.com pour obtenir son identifiant et son secret. Ensuite, dans votre agent :
-
Ouvrez Tools, choisissez Add a tool, New tool, puis Model Context Protocol.
-
Saisissez
https://app.lexopti.com/mcpcomme Server URL, choisissez OAuth 2.0, puis Manual, et remplissez :Champ Valeur Client ID et Client secret fournis par LexOpti Authorization URL https://app.lexopti.com/api/auth/oauth2/authorizeToken URL template et Refresh URL https://app.lexopti.com/api/auth/oauth2/tokenScopes openid email offline_access lexopti:read lexopti:write -
Choisissez Create, puis envoyez l’URL de rappel que Copilot Studio affiche à contact@lexopti.com : LexOpti l’ajoute à votre client.
MCP Inspector
Section intitulée « MCP Inspector »MCP Inspector permet à un développeur d’appeler les outils à la main :
npx @modelcontextprotocol/inspectorDans l’interface web, ajoutez le serveur avec le transport Streamable HTTP (http) et l’URL ci-dessus. L’Inspector n’a pas de document de métadonnées client à lui : donnez-lui l’URL d’un document que vous publiez en HTTPS (Client Settings > Client ID Metadata Document), dont l’URI de redirection est http://localhost:6274/oauth/callback ; un propriétaire ou un administrateur de votre organisation l’autorise d’abord. Pour l’appeler depuis un terminal, ajoutez --cli https://app.lexopti.com/mcp --method tools/list --client-metadata-url <URL de votre document>.
Sur une session de développement LexOpti, bun run mcp:inspector-client enregistre le client de l’Inspector et affiche les étapes.
Essayer dans un bac à sable
Section intitulée « Essayer dans un bac à sable »Une organisation bac à sable fonctionne comme les autres : connectez-y l’assistant en choisissant l’organisation. Ses analyses n’interrogent aucune source, renvoient des résultats déterministes et ne facturent rien (voir Bac à sable).
En cas de problème
Section intitulée « En cas de problème »| Ce que vous voyez | Ce que cela signifie |
|---|---|
| 401, « connect LexOpti again » | Le jeton est absent, expiré ou n’est plus valable : vous avez quitté l’organisation, votre consentement a été révoqué ou l’organisation a bloqué l’assistant. Connectez-vous de nouveau. |
403 insufficient_scope |
Un outil d’écriture demande lexopti:write : autorisez de nouveau avec les deux portées. |
| 429, « retry in a minute » | Plus de 120 appels par minute pour vous et cet assistant. |
| Une erreur d’outil qui dit quoi faire | Par exemple un rôle en lecture seule, un aperçu expiré, une alerte qui n’est plus disponible ou la limite horaire de lancements. L’assistant lit le message et agit en conséquence. |
Un aperçu peut aussi indiquer incomplete_identity (des champs d’identité à compléter d’abord dans LexOpti) ou insufficient_credits (le dossier du client demande plus de crédits que l’organisation n’en a) : rien n’est lancé alors.
Déconnecter ou bloquer un assistant
Section intitulée « Déconnecter ou bloquer un assistant »- Le déconnecter pour vous : retirez le connecteur dans l’assistant.
- Révoquer son accès à l’organisation : un propriétaire ou un administrateur le demande à LexOpti par le formulaire de contact (l’onglet Applications connectées de la page de l’organisation liste l’assistant, en lecture seule). LexOpti supprime aussitôt les autorisations des membres et ses jetons dans l’organisation ; un membre peut l’autoriser de nouveau.
- Le bloquer : sur la même demande, LexOpti lui retire aussitôt tout accès à l’organisation, et aucun membre ne peut plus l’autoriser tant qu’il n’est pas débloqué.
Confidentialité, support et conservation
Section intitulée « Confidentialité, support et conservation »- Politique de confidentialité : lexopti.com/fr/confidentialite. LexOpti fonctionne dans l’Union européenne et vos données y restent.
- Ce que LexOpti conserve : ce que l’assistant fait en votre nom (une analyse lancée, le traitement d’une alerte) est conservé comme ce que vous faites dans LexOpti, avec l’entrée du journal d’audit qui nomme l’assistant : cinq ans après la fin de la relation d’affaires (CMF L561-12), puis effacé ou anonymisé. LexOpti ne conserve rien de votre conversation.
- Ce que voit l’assistant : les résultats qu’il lit partent chez son éditeur (Anthropic, OpenAI, Microsoft, Anysphere) selon les conditions de celui-ci. Choisissez un assistant que votre structure a validé pour les données de vos clients.
- Support : contact@lexopti.com.