Connecter votre client IA

Cette page explique comment ajouter Klastro à votre assistant IA. Tous les clients utilisent la même adresse et la même connexion.

Avant de commencer

• Un compte Klastro membre d’au moins une organisation. Sans organisation, l’écran de consentement affiche Aucune organisation et vous demande d’en rejoindre ou d’en créer une.

• Un client MCP qui prend en charge les serveurs distants en HTTP avec connexion OAuth.

• L’adresse du serveur :

  https://mcp.klastro.io/mcp

Pour comprendre ce que l’assistant peut faire et ce que vous approuvez, lisez d’abord Klastro et les assistants IA.

Ajouter Klastro à votre client

Claude Code

1. Dans un terminal, exécutez :

   claude mcp add --transport http klastro https://mcp.klastro.io/mcp

   Par défaut, le serveur n’est disponible que dans le projet courant. Ajoutez --scope user pour le rendre disponible dans tous vos projets.

2. Lancez Claude Code et exécutez la commande /mcp.

3. Sélectionnez klastro et choisissez de vous authentifier. Votre navigateur s’ouvre sur la page de connexion de Klastro.

4. Connectez-vous, puis approuvez la connexion sur l’écran de consentement (voir Approuver la connexion ci-dessous).

Claude Desktop et claude.ai

Les connecteurs personnalisés se configurent depuis votre compte Claude et fonctionnent à la fois dans claude.ai et dans Claude Desktop.

1. Ouvrez Customize > Connectors.

2. Sélectionnez + Add, puis Add custom connector.

3. Saisissez un nom, par exemple Klastro, et l’URL https://mcp.klastro.io/mcp, puis sélectionnez Continue.

4. Conservez les paramètres de connexion détectés et terminez avec Add.

5. Connectez le connecteur. Votre navigateur s’ouvre sur la page de connexion de Klastro : connectez-vous et approuvez la connexion.

6. Dans une conversation, sélectionnez + en bas à gauche, puis Connectors, et vérifiez que Klastro est activé.

Note

Sur les forfaits Claude Team et Enterprise, un propriétaire de votre organisation Claude ajoute le connecteur dans les paramètres de l’organisation Claude. Les membres le retrouvent ensuite sous Customize > Connectors et sélectionnent Connect. Ces menus appartiennent à Claude et peuvent changer : consultez le centre d’aide d’Anthropic s’ils diffèrent. Les libellés sont cités ici dans la version anglaise de Claude.

Cursor

1. Ouvrez ~/.cursor/mcp.json pour rendre Klastro disponible dans tous vos projets, ou créez .cursor/mcp.json à la racine d’un projet.

2. Ajoutez Klastro sous mcpServers :

   {
     "mcpServers": {
       "klastro": {
         "url": "https://mcp.klastro.io/mcp"
       }
     }
   }

3. Enregistrez le fichier. Quand Cursor se connecte au serveur, il vous demande de vous authentifier : votre navigateur s’ouvre sur la page de connexion de Klastro.

4. Connectez-vous et approuvez la connexion.

VS Code

1. Créez .vscode/mcp.json dans votre espace de travail, ou exécutez la commande MCP: Open User Configuration pour rendre Klastro disponible partout.

2. Ajoutez Klastro sous servers :

   {
     "servers": {
       "klastro": {
         "type": "http",
         "url": "https://mcp.klastro.io/mcp"
       }
     }
   }

   Vous pouvez aussi exécuter la commande MCP: Add Server, choisir HTTP et saisir l’URL.

3. Démarrez le serveur. VS Code vous demande l’autorisation de vous connecter ; votre navigateur s’ouvre sur la page de connexion de Klastro.

4. Connectez-vous et approuvez la connexion. Les outils Klastro apparaissent ensuite dans le mode agent de Copilot Chat.

Codex

1. Ajoutez Klastro à ~/.codex/config.toml :

   [mcp_servers.klastro]
   url = "https://mcp.klastro.io/mcp"

2. Exécutez :

   codex mcp login klastro

3. Connectez-vous dans la fenêtre de navigateur qui s’ouvre et approuvez la connexion.

Tout client MCP

Tout client qui implémente le transport MCP Streamable HTTP et sa connexion OAuth peut se connecter :

Paramètre	Valeur
Transport	Streamable HTTP (souvent appelé « HTTP » ou « remote »)
URL	https://mcp.klastro.io/mcp
Authentification	OAuth 2.1. Le client découvre le serveur de connexion et s’enregistre automatiquement : aucun identifiant client ni clé d’API n’est nécessaire.

Indiquez l’URL au client et démarrez-le. Il doit ouvrir votre navigateur sur la page de connexion de Klastro ; connectez-vous et approuvez la connexion. Si votre client affiche plutôt un code et vous demande d’ouvrir un lien, ouvrez-le, saisissez le code sur la page Connecter un appareil et sélectionnez Continuer. Lorsque Appareil connecté s’affiche, revenez à votre client.

Approuver la connexion

Après la connexion, Klastro affiche un écran de consentement intitulé d’après le nom de l’application, par exemple « Claude Code demande l’accès à votre compte Klastro ».

1. Sous Organisation, choisissez l’organisation dans laquelle l’assistant travaillera. Il agit uniquement dans celle-ci.

2. Sous Autorisations, cochez ce que vous autorisez :

   • Lecture pour consulter les scénarios, sessions, évaluations et rapports ;
   • Écriture pour lancer et arrêter des labs, modifier des brouillons Studio et soumettre des tentatives ;
   • Administration uniquement si vous administrez l’organisation et en avez besoin. Elle n’est jamais cochée par défaut.

3. Sélectionnez Autoriser.

La page affiche Retour vers l’application… et vous renvoie vers votre assistant. Demandez-lui quelque chose de simple, comme « Liste les scénarios Klastro que je peux lancer », pour vérifier la connexion.

Astuce

Pour utiliser Klastro dans une deuxième organisation, ajoutez le serveur une seconde fois sous un autre nom (par exemple klastro-acme) et choisissez l’autre organisation sur l’écran de consentement.

Révoquer une connexion

Ouvrez votre page Profil dans app.klastro.io. Sous Applications connectées, sélectionnez Révoquer à côté de l’application, puis confirmez. Elle perd l’accès immédiatement.

Si la connexion échoue

Symptôme	Solution
L’écran de consentement affiche Aucune organisation.	Rejoignez ou créez une organisation dans app.klastro.io, puis reconnectez-vous.
La connexion n’a pas abouti	Relancez la connexion depuis votre application.
Sélectionnez au moins une autorisation.	Cochez Lecture, Écriture ou les deux avant de sélectionner Autoriser.
L’assistant indique qu’une action n’est pas autorisée pour le jeton.	Vous n’avez approuvé que la Lecture. Révoquez l’application depuis votre Profil et reconnectez-vous avec l’Écriture.
L’assistant ne voit pas un scénario, un Assessment ou un rapport visible dans l’application.	Il est probablement connecté à une autre organisation. Vérifiez l’organisation indiquée sous Applications connectées dans votre Profil.
Les requêtes sont refusées après une rafale d’activité.	Vous avez atteint la limite de 120 requêtes par minute. Patientez un instant et réessayez.

Si le problème persiste, ouvrez un ticket d’assistance dans la catégorie Compte et accès.