Aller au contenu

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
  1. L’assistant appelle https://app.lexopti.com/mcp sans 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.
  2. 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.
  3. 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.
  4. 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.

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