Brancher ton assistant IA

Ton assistant IA lit le catalogue d'Astrolabe pour toi : un composant, son propriétaire, ce qui appartient à un système. Il lit avec tes droits, et ne fait que lire. Rien de secret à copier : la première fois, l'assistant ouvre une page d'Astrolabe où tu l'autorises.

Ton administrateur doit avoir allumé le serveur MCP : voir Allumer le serveur MCP.

🔌 Récupérer la configuration

1. En haut à droite, clique sur ton nom, puis sur Mon compte.

2. Clique sur l'onglet Mes comptes.

3. Sur la carte MCP, clique sur Connecter. La fenêtre Brancher mon assistant IA s'ouvre.

4. Sous le nom de ton assistant, clique sur Copier :

   • Claude Code : une commande, par exemple claude mcp add --transport http astrolabe https://astrolabe.exemple.com/api/mcp-actions/v1/astrolabe

   • VS Code (.vscode/mcp.json) : un bloc à coller dans le fichier .vscode/mcp.json de ton projet :

     {
       "servers": {
         "astrolabe": {
           "type": "http",
           "url": "https://astrolabe.exemple.com/api/mcp-actions/v1/astrolabe"
         }
       }
     }

5. Clique sur Fermer.

🤖 Autoriser ton assistant

1. Claude Code : lance la commande copiée dans un terminal, puis dans Claude Code tape /mcp, choisis astrolabe puis Authenticate. VS Code : enregistre .vscode/mcp.json, puis clique sur Start au-dessus de astrolabe.

2. Ton navigateur ouvre une page d'Astrolabe intitulée Authorization (elle est en anglais) : elle nomme l'assistant et l'adresse où il revient. Vérifie-les, puis clique sur Authorize.

3. De retour dans ton assistant, pose-lui une question sur ton catalogue, par exemple : « Qui est propriétaire du composant payment-service dans Astrolabe ? »

✅ C'est fait ! Dans Mon compte › Mes comptes, la carte MCP dit maintenant Connectée.

💬 Que demander à ton assistant

Demande avec tes mots ; ton assistant choisit quoi lire dans Astrolabe. Par exemple :

• « Qui est propriétaire du composant payment-service dans Astrolabe ? »
• « Quels composants appartiennent au système checkout dans Astrolabe ? »
• « Liste les API dont le groupe platform-team est propriétaire dans Astrolabe. »
• « Quels composants du catalogue sont encore expérimentaux ? »
• « Trouve dans Astrolabe un skill pour écrire des notes de version, et dis-moi comment l'installer. »
• « Ce catalog-info.yaml est-il valide pour Astrolabe ? » (colle le fichier, ou nomme-le dans ton projet)
• « Quels genres d'entités le catalogue d'Astrolabe connaît-il ? »
• « Quelles sont mes notifications non lues dans Astrolabe ? »
• « Quelle est la note Compass de payment-service, et quels contrôles échouent ? »
• « Quelle version de payment-service est déployée en production ? »

Ton assistant lit, il ne change jamais le catalogue : pour enregistrer un composant ou modifier une entité, passe par Astrolabe.

✂️ Révoquer un assistant

1. Dans Mon compte › Mes comptes, sur la carte MCP, clique sur Configurer.

2. Sous Assistants autorisés, chaque assistant montre le jour où tu l'as autorisé et le jour où il a lu Astrolabe pour la dernière fois. Sur celui à couper, clique sur Révoquer.

3. Dans la fenêtre Révoquer … ?, clique sur Révoquer. Le message … ne peut plus lire Astrolabe apparaît.

Son appel suivant est refusé. Pour t'en resservir, autorise-le de nouveau (étapes ci-dessus).

❓ Questions fréquentes

Que peut lire mon assistant ? Ce que tu peux lire dans le catalogue — avec les ressources IA, les notes Compass et les déploiements des composants que tu vois — et tes propres notifications. Il ne change rien : il ne marque même pas une notification comme lue.

Mon assistant peut-il se servir de son accès ailleurs ? Non. L'accès que tu lui donnes n'ouvre que le serveur MCP d'Astrolabe : tout autre appel est refusé.

Faut-il un jeton ? Non. Tu autorises l'assistant sur une page d'Astrolabe ; il ne voit jamais ton mot de passe.

Puis-je brancher plusieurs assistants ? Oui. Chacun apparaît sous Assistants autorisés, et tu les révoques un par un.

Quels assistants marchent ? Claude Code et VS Code.

🛠️ Problèmes courants

L'assistant dit « This access was revoked in My account. Sign in again from your assistant. » Toi (ou ton administrateur) l'as révoqué. Autorise-le de nouveau : dans Claude Code, /mcp › astrolabe › Authenticate.

L'assistant dit « Astrolabe's MCP server is turned off by your administrator. » Demande à ton administrateur de l'allumer.

Il n'y a pas de carte MCP dans Mes comptes. Le serveur est éteint sur ton instance : demande à ton administrateur.

La carte dit « Non vérifiée » et la fenêtre « Vos assistants n'ont pas pu être lus : Astrolabe n'a pas répondu. » Astrolabe n'a pas répondu un instant. Recharge la page dans une minute.

L'assistant n'arrive pas du tout à joindre Astrolabe. Astrolabe est peut-être derrière un pare-feu ou Cloudflare Access : ton administrateur laisse passer les chemins de Derrière un pare-feu.