Aller au contenu principal

Connecter Claude (MCP)

Les outils de l'assistant IA peuvent répondre à un client externe — Claude Desktop, claude.ai, Claude Code — par le point d'accès MCP du serveur, /mcp. Le client agit au nom d'un utilisateur de Liberty Next : il reçoit les outils proposés à cet utilisateur dans le panneau de l'assistant, chaque appel passe par les mêmes contrôles de permission et le même périmètre de données, et chaque appel est enregistré.

Trois conditions : le point d'accès activé, la permission mcp:use, et un jeton d'accès personnel que l'utilisateur crée dans son profil.


Vue d'ensemble​

ProfilProfilSécuritéJetons d'accèsUn jeton d'accès personnel permet à un client externe — Claude, par un connecteur personnalisé —d'utiliser les outils de l'assistant en votre nom : avec vos permissions et votre périmètre de données.URL DU CONNECTEURhttps://liberty.example.com/mcpVALABLE (JOURS)90VOTRE JETON — L'EN-TÊTE DE REQUÊTE DU CONNECTEUR : AUTHORIZATION: BEARER <JETON>7Qd2mVx4…x9LkCopierCopiez-le maintenant : il n'est affiché qu'une fois et n'est pas conservé. Il expire le 16/02/2027.Un jeton prend aussi fin quand votre compte est désactivé ou perd la permission,et quand vous changez de mot de passe — faites-le si un jeton a fuité.Créer un jetonOnglet Jetons d'accèsavec la permission mcp:useURL du connecteurà coller dans ClaudeAffiché une seule foisjamais conservé par le serveurDurée de validité90 jours, plafonnée par le serveurL'en-tête de requêteAuthorization: Bearer …Un jeton par clicni liste, ni révocation

Activer le point d'accès​

Dans Liberty Next → Administrer → App → Assistant IA :

ChampDéfautDescription
Point d'accès MCP (/mcp)DésactivéLe serveur répond sur /mcp. Appliqué à l'enregistrement, sans redémarrage.
Jeton d'accès personnel : durée maximale (jours)366La plus longue validité qu'un utilisateur peut demander.

Le point d'accès demande le complément mcp du paquet (pip install "liberty-next[mcp]") ; liberty-next[all] et l'image Docker le contiennent.


Accorder la permission​

Dans Liberty Next → Administrer → Accès, donner au rôle la règle Assistant IA → Outils IA depuis un client externe (MCP) — créer un jeton d'accès personnel (mcp:use), dans Au-delà des menus. L'utilisateur voit alors l'onglet Jetons d'accès de son profil ; un superutilisateur le voit toujours.

mcp:use ne fait qu'ouvrir le point d'accès : ce que le client atteint dépend toujours des autres permissions de l'utilisateur — voir Qui peut l'utiliser, et sur quoi.


Créer un jeton​

L'utilisateur ouvre son profil — son nom dans la barre du haut — puis Jetons d'accès :

  1. Valable (jours) : 90 par défaut. Une durée supérieure au maximum du serveur est ramenée à ce maximum ; la date d'expiration affichée avec le jeton est celle qui s'applique.
  2. Créer un jeton.
  3. Copier le jeton (Copier) : il n'est affiché qu'une fois et n'est pas conservé.

L'onglet donne aussi l'URL du connecteur, l'adresse du serveur suivie de /mcp.


Déclarer le connecteur dans Claude​

Dans le client, ajouter un connecteur personnalisé avec :

RéglageValeur
URLL'URL du connecteur de l'onglet — https://<serveur>/mcp.
En-tête de requêteAuthorization: Bearer <jeton>
RéponseSignification
404Le point d'accès est désactivé.
401Pas de jeton, ou un jeton invalide ou arrivé à son terme.

Ce que le client peut faire​

  • Le client reçoit les outils proposés à l'utilisateur dans le panneau de l'assistant, avec les mêmes descriptions ; un outil que l'utilisateur ne peut pas utiliser n'est pas listé.
  • Chaque appel vérifie les permissions de l'utilisateur et applique son périmètre de données, comme dans le panneau.
  • Les outils dont le résultat est une carte du panneau ne sont pas proposés : les propositions de construction et les notes.
  • Un outil qui enregistre quelque chose — une analyse ou un tableau de bord de l'explorateur de données — le signale au client, qui peut alors demander une confirmation.
  • Un jeton d'accès personnel n'ouvre que le point d'accès MCP : le reste de l'API le refuse.

Fin de validité d'un jeton​

Le compte est relu à chaque appel : un jeton porte les droits de l'utilisateur à cet instant, jamais davantage. Il prend fin :

  • à sa date d'expiration ;
  • quand le compte est désactivé, ou perd mcp:use ;
  • quand le mot de passe du compte change.

Il n'y a ni liste des jetons ni bouton de révocation : changer le mot de passe met fin à tous les jetons du compte. C'est la marche à suivre quand un jeton a fuité.


Ce qui est enregistré​

Chaque appel figure dans l'enregistrement d'usage, avec le modèle mcp : l'utilisateur, l'outil, ce sur quoi il a été appelé, son échec éventuel, sa taille et sa durée — jamais une ligne renvoyée. Voir Surveillance → Usage de l'IA.


Conseils​

  • Choisir une validité courte pour un premier essai, et créer un nouveau jeton plutôt que d'en partager un : un jeton est l'accès personnel de l'utilisateur.
  • Accorder mcp:use aux rôles qui utilisent déjà l'assistant dans l'application ; les réponses dépendent des mêmes permissions sql: et explorer:.
  • Servir le point d'accès en HTTPS uniquement : le jeton circule dans un en-tête de requête.