Allumer le serveur MCP

Le serveur MCP d'Astrolabe permet à un assistant IA — Claude Code, VS Code — de lire votre catalogue logiciel. Chaque assistant lit avec les droits de la personne qui l'a branché, jamais plus, et ne fait que lire : il ne change rien dans Astrolabe.

Tu l'allumes une fois, en administrateur. Il est éteint sur une instance neuve.

🔌 Allumer le serveur

Dans la barre latérale, en bas, clique sur Administration.
Sous PLATEFORME, clique sur Plugins.
Sur la carte Serveur MCP, clique sur l'interrupteur Activer Serveur MCP. Un message le confirme en bas de l'écran.

✅ C'est fait ! Chaque utilisateur trouve maintenant une carte MCP dans Mon compte › Mes comptes : voir Brancher ton assistant IA.

👀 Voir et révoquer les assistants

Dans la barre latérale, en bas, clique sur Administration.
Sous INTELLIGENCE, clique sur Assistants IA. Chaque assistant autorisé montre sa personne, le jour où il a été autorisé et le jour où il a lu Astrolabe pour la dernière fois.
Pour en couper un, clique sur Révoquer sur sa ligne, puis sur Révoquer dans la fenêtre Révoquer cet assistant ?. Le message … ne peut plus lire Astrolabe apparaît. Son appel suivant est refusé ; sa personne peut l'autoriser de nouveau depuis l'assistant.

Le bouton Révoquer demande le droit de supprimer dans l'administration.

Pour voir ce qu'ont fait les assistants, clique sur l'onglet Appels : chaque appel des 30 derniers jours montre sa personne, l'outil, l'heure, et Réussi ou Échec avec sa cause. Ce qu'un assistant a demandé et ce qui lui a été répondu ne sont jamais gardés.

🧱 Derrière un pare-feu ou Cloudflare Access

Un assistant appelle Astrolabe depuis le poste de l'utilisateur, sans navigateur : un pare-feu, un reverse proxy ou Cloudflare Access qui demande de se connecter le bloque. Laisse passer ces adresses de ton instance, pour tout le monde :

Chemin	Ce que c'est
`/api/mcp-actions/`	Le serveur MCP. Astrolabe demande lui-même l'accès de l'utilisateur à chaque appel.
`/api/auth/v1/token`	Là où l'assistant échange son code à usage unique contre un accès.
`/.well-known/`	Là où l'assistant découvre comment se connecter. Rien de secret.
`/api/auth/.well-known/`	Pareil, pour le service de connexion. Rien de secret.

Garde tout le reste derrière ta protection : la page où l'utilisateur autorise un assistant s'ouvre dans son navigateur, où il est déjà connecté.

Avec Cloudflare Access :

Dans le tableau de bord Cloudflare Zero Trust, ouvre Access › Applications, puis clique sur Add an application › Self-hosted.
Donne-lui un nom, par exemple Astrolabe MCP.
Clique sur Add public hostname une fois par chemin du tableau : ton domaine Astrolabe (par exemple astrolabe.exemple.com) et le chemin sans sa première barre (api/mcp-actions, api/auth/v1/token, .well-known, api/auth/.well-known).
Ajoute une politique avec Action : Bypass et Include : Everyone, puis enregistre.

Le chemin le plus précis l'emporte : le reste d'Astrolabe reste derrière ton application Access habituelle.

❓ Questions fréquentes

Un assistant peut-il changer quelque chose dans Astrolabe ? Non. Le serveur MCP ne sert que des lectures du catalogue.

Un assistant voit-il plus que son utilisateur ? Non. Il lit avec les droits de la personne qui l'a autorisé : ce qu'elle ne voit pas dans le catalogue, son assistant ne le voit pas non plus.

Y a-t-il quelque chose à configurer ? Non. Aucun jeton à créer : chaque utilisateur autorise son assistant sur une page d'Astrolabe.

Comment couper tous les assistants d'un coup ? Éteins le serveur : même interrupteur. Les assistants sont refusés aussitôt, et aucun ne peut se rebrancher avant que tu le rallumes.

🛠️ Problèmes courants

L'assistant dit « Astrolabe's MCP server is turned off by your administrator. » Le serveur est éteint. Allume-le dans Administration › Plugins (étapes ci-dessus).

Il n'y a pas de carte MCP dans Mon compte › Mes comptes. Même cause : le serveur est éteint.

L'assistant n'arrive pas à se connecter et parle d'une page de connexion, d'un 302 ou d'un 403 inattendu. Un pare-feu ou Cloudflare Access se tient devant Astrolabe : laisse passer les chemins du tableau (ci-dessus).