Aller au contenu principal

Brancher votre propre assistant IA

Vos propres outils d'IA — Claude Code, Cursor, ou tout client parlant le Model Context Protocol (MCP) — peuvent lire les projets, applications et déploiements de votre organisation à travers cette plateforme, au moyen des mêmes outils en lecture seule que l'Org Agent. Cela demande la fonctionnalité d'assistant IA dans votre offre.

  1. Ouvrez Settings → AI puis, sous Connect your AI assistant, cliquez sur Create token. Le jeton n'est affiché qu'une fois : copiez-le tout de suite.

  2. Déclarez cette plateforme dans votre client, avec l'URL MCP et le jeton qui y figurent. Le nom du serveur est le vôtre — platform dans les exemples ci-dessous. Pour Claude Code :

    claude mcp add --transport http platform https://<votre-domaine-console>/api/ai/agent-mcp --header "x-api-key: <jeton>"

    Pour Cursor, dans .cursor/mcp.json :

    { "mcpServers": { "platform": { "url": "https://<votre-domaine-console>/api/ai/agent-mcp", "headers": { "x-api-key": "<jeton>" } } } }

  3. Posez à votre assistant des questions comme « qu'est-ce qui est déployé dans mon organisation ? » ou « pourquoi le dernier déploiement de mon application a-t-il échoué ? ».

Ce que ce jeton permet, et ce qu'il ne permet pas :

  • Lecture seule. Il liste les projets, lit l'état d'une application et liste ses déploiements. Il ne peut rien modifier, et n'ouvre pas le reste de l'API de la plateforme.
  • Il sert aussi en dehors de MCP. Le même jeton authentifie l'API publique : vos scripts et vos tâches d'intégration continue peuvent lire les mêmes informations en HTTP ordinaire.
  • Uniquement ce que vous voyez. Les propriétaires et administrateurs voient tous les projets ; un membre ne voit que les projets et services auxquels on lui a donné accès.
  • Un par personne et par organisation. Créer un nouveau jeton remplace le précédent ; Revoke le désactive immédiatement.

Vérifier ce qu'un jeton donne à voir​

  1. Créez un jeton, branchez votre client comme ci-dessus, et demandez-lui de lister mes projets. Il doit énumérer les projets de votre organisation.
  2. Pour constater la vue plus étroite d'un membre, un propriétaire ou un administrateur ouvre Settings → Users, clique sur Add Permissions pour ce membre et, dans la section Projects, ne coche que certains projets, ainsi que les services auxquels le membre doit accéder.
  3. Connectez-vous en tant que ce membre, créez son propre jeton dans Settings → AI, branchez-le, et listez de nouveau les projets. Seuls les projets cochés apparaissent, et toute question sur une application extérieure renvoie Application not found.
  4. Cliquez sur Revoke quand vous avez terminé : le client perd l'accès immédiatement.