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
Activer le point d'accès
Dans Liberty Next → Administrer → App → Assistant IA :
| Champ | Défaut | Description |
|---|---|---|
| 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) | 366 | La 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 :
- 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.
- Créer un jeton.
- 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églage | Valeur |
|---|---|
| URL | L'URL du connecteur de l'onglet — https://<serveur>/mcp. |
| En-tête de requête | Authorization: Bearer <jeton> |
| Réponse | Signification |
|---|---|
404 | Le point d'accès est désactivé. |
401 | Pas 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:useaux rôles qui utilisent déjà l'assistant dans l'application ; les réponses dépendent des mêmes permissionssql:etexplorer:. - Servir le point d'accès en HTTPS uniquement : le jeton circule dans un en-tête de requête.