Serveur MCP LexOpti
Le serveur MCP LexOpti permet à un assistant IA d’agir dans une organisation LexOpti pour un membre, avec le rôle de ce membre. Il sert les professionnels qui utilisent LexOpti ; pour qu’un assistant lise cette documentation pendant qu’il écrit votre intégration, utilisez le serveur MCP de documentation. Pour connecter un assistant, suivez connecter un assistant à LexOpti.
| Propriété | Valeur |
|---|---|
| Point d’accès | https://app.lexopti.com/mcp |
| Transport | Model Context Protocol en Streamable HTTP |
| Autorisation | OAuth 2.1, Client ID Metadata Documents, pas d’enregistrement dynamique ouvert |
| Audit | chaque action figure dans le journal d’audit de l’organisation comme venant de l’assistant |
Autorisation
Section intitulée « Autorisation »- L’assistant appelle
https://app.lexopti.com/mcpsans jeton. LexOpti répond 401 avec l’adresse de ses métadonnées de ressource protégée (RFC 9728),https://app.lexopti.com/.well-known/oauth-protected-resource/mcp, qui désignent le serveur d’autorisation. - L’assistant s’identifie par l’URL de son document de métadonnées client (Client ID Metadata Documents, CIMD). LexOpti n’offre pas d’enregistrement dynamique ouvert : un assistant qui ne gère pas CIMD, comme Cursor ou Copilot Studio, utilise un client que LexOpti enregistre pour lui.
- LexOpti s’ouvre dans votre navigateur. Vous vous connectez, choisissez l’organisation pour laquelle l’assistant agit et approuvez les accès qu’il demande.
- L’assistant reçoit un jeton valable pour le seul serveur MCP : il ne peut pas appeler l’API publique, et un jeton de l’API publique ne peut pas appeler le serveur MCP.
| Portée | Ce que l’assistant peut faire |
|---|---|
lexopti:read |
Lire les clients, dossiers, classifications, alertes et analyses, et prévisualiser un lancement ou un dossier. |
lexopti:write |
Lancer des analyses, créer des dossiers et traiter des alertes. |
L’assistant ne voit que les outils que ses portées permettent. S’il appelle un outil d’écriture avec le seul lexopti:read, LexOpti répond 403 insufficient_scope et l’assistant vous demande d’autoriser de nouveau avec les deux portées. Un membre au rôle en lecture seule ne peut jamais écrire, quelles que soient les portées.
| Outil | Portée | Ce qu’il fait |
|---|---|---|
lexopti_search_clients |
lecture | Retrouve des clients de l’organisation par nom (nom complet dans un ordre ou l’autre), raison sociale ou SIREN, des plus récents aux plus anciens, 10 par défaut et 20 au plus. |
lexopti_get_client_status |
lecture | Lit le niveau de vigilance d’un client, l’état de ses analyses, ses alertes ouvertes et sa dernière évaluation des risques validée. |
lexopti_get_case_summary |
lecture | Lit un dossier : son type, son statut, ses clients avec vos références, ses autres parties et leurs rôles, son niveau de vigilance, le niveau de risque validé par un membre, l’état de sa classification et le nombre d’alertes en attente. |
lexopti_get_classification |
lecture | Lit la classification d’un client ou d’un dossier telle que vous l’avez enregistrée : son état, son score, son niveau, sa dernière validation et les questions encore sans réponse ; n’y répond et ne la valide jamais à votre place, et ne renvoie jamais l’axe du soupçon. |
lexopti_list_alerts |
lecture | Liste les alertes de l’organisation, des plus récentes aux plus anciennes, pour un client ou un statut, page par page. |
lexopti_get_check_run |
lecture | Lit où en est une analyse et le statut de chaque source qu’elle a interrogée. |
lexopti_preview_check |
lecture | Montre ce que lancer les analyses d’un client contrôlerait, le dossier facturé et ses crédits, sans rien lancer. |
lexopti_preview_case |
lecture | Montre ce que coûterait en crédits la création d’un dossier pour des clients existants, avec ses natures et ses parties, sans rien créer. |
lexopti_launch_check |
écriture | Lance les analyses d’un client après leur aperçu, facturées au dossier du client. |
lexopti_create_case |
écriture | Crée le dossier après son aperçu, une fois son coût confirmé dans le formulaire de LexOpti ; sans formulaire, ne fait que vous la proposer, à créer dans LexOpti. |
lexopti_acknowledge_alert |
écriture | Enregistre votre traitement d’une alerte (examinée, écartée ou confirmée) avec votre motif, ou vous le propose à valider dans LexOpti. |
Une alerte parvient à l’assistant sous forme de champs (source, éditeur, niveau, catégorie, date et lien), jamais avec le texte de la page qui l’a déclenchée. Le serveur répond en anglais ; l’assistant vous répond dans votre langue.
Confirmations
Section intitulée « Confirmations »L’assistant ne peut jamais confirmer un lancement, une création ou un traitement à votre place.
Lancer une analyse. L’assistant appelle d’abord lexopti_preview_check et vous montre qui sera contrôlé, le dossier facturé et les crédits qu’il coûte. L’aperçu renvoie un preview_token, signé par LexOpti, valable 5 minutes et lié à vous, à l’organisation, à l’assistant, au client et à ces chiffres. lexopti_launch_check refuse un jeton absent, expiré ou modifié, et le refuse quand les entités à contrôler ont changé depuis l’aperçu, ou ce qu’il coûte, ou quand les crédits ne couvrent plus le lancement. Ensuite :
- si votre assistant sait afficher un formulaire (elicitation MCP), LexOpti vous y demande de confirmer le lancement, et un refus ne lance rien ;
- sinon le lancement repose sur l’approbation de l’appel par votre assistant lui-même, qui ne prouve rien quand elle est réglée sur « toujours autoriser ».
LexOpti enregistre avec l’analyse comment vous l’avez confirmée : confirmed_via vaut elicitation ou not_elicited. Un même aperçu ne lance qu’une fois : un nouvel appel renvoie l’analyse déjà lancée. Un assistant lance au plus 20 analyses par heure pour vous ; au-delà, lancez-les dans LexOpti.
Créer un dossier. L’assistant appelle d’abord lexopti_preview_case avec les clients, les natures et les parties du dossier, et vous montre ce qu’il coûte : un crédit par tranche de cinq personnes ou sociétés, un au moins, comme l’écran « Nouveau dossier » de LexOpti le facture. L’aperçu renvoie un preview_token qui lui est propre (jamais valable pour une analyse), valable 5 minutes et lié à vous, à l’organisation, à l’assistant, à ces arguments exactement et à ce coût. lexopti_create_case refuse un jeton absent, expiré ou modifié, d’autres arguments que ceux de l’aperçu, un coût qui a changé, ou des crédits qui ne le couvrent plus. Ensuite :
- si votre assistant sait afficher un formulaire, LexOpti vous y demande de confirmer la création et son coût, et un refus ne crée rien ;
- sinon l’assistant ne fait que proposer le dossier : rien n’est créé ni facturé tant que vous, ou un autre membre, n’avez pas ouvert le lien qu’il vous donne,
https://app.lexopti.com/proposals/<id>. Il ouvre l’écran « Nouveau dossier » de LexOpti rempli depuis la proposition, son prix sur le bouton : vérifiez-la, modifiez-la au besoin et créez-la là. Une proposition est gardée 7 jours.
Un même aperçu ne crée, ou ne propose, qu’une fois : un nouvel appel renvoie le même dossier. Les créations comptent dans les mêmes 20 par heure que les lancements.
Traiter une alerte. Votre décision et votre motif sont les vôtres, jamais ceux de l’assistant :
- si votre assistant sait afficher un formulaire, vous y saisissez la décision et le motif, et le traitement s’applique aussitôt, à la place de tout traitement antérieur ;
- sinon l’assistant ne fait que proposer le traitement. Rien ne change sur l’alerte tant que vous, ou un autre membre, ne l’avez pas validé ou refusé dans LexOpti, dans « Propositions de l’assistant » sur la fiche du client. L’assistant vous en donne le lien,
https://app.lexopti.com/proposals/<id>.
| Limite | Valeur |
|---|---|
| Appels par membre et assistant | 120 par minute, puis 429 |
| Appels par adresse cliente | 300 par minute, puis 429 |
| Lancements d’analyses et créations de dossiers par membre et assistant | 20 par heure |
preview_token |
valable 5 minutes, ne lance ou ne crée qu’une fois |
| Corps de requête | 64 Kio, puis 413 |
| Lots JSON-RPC | refusés, 400 |
lexopti_search_clients |
10 résultats par défaut, 20 au plus |
lexopti_list_alerts |
pages de 20 par défaut, 50 au plus |
Un aperçu indique 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) quand rien ne peut être lancé.