AI CodeOps

Serveurs MCP

Mis à jour le

Connectez des serveurs MCP distants pour que les agents d'AI CodeOps puissent appeler leurs outils : ajoutez un serveur, gardez ses en-têtes chiffrés et limitez les outils par agent et par politique.

Le Model Context Protocol (MCP) permet à un agent IA d'appeler des outils sur un autre service, comme un gestionnaire de tickets ou une recherche dans la documentation. Dans AI CodeOps, vous connectez des serveurs MCP à votre espace de travail et les agents de vos sessions peuvent utiliser leurs outils.

Ici, AI CodeOps est le client : il se connecte aux serveurs MCP que vous ajoutez. Pour utiliser plutôt AI CodeOps depuis votre propre assistant de codage, consultez le serveur MCP d'AI CodeOps.

La prise en charge de MCP est en bêta.

Serveurs distants et locaux

TypeCe que vous saisissezUtilisé par les sessions ?
Remote (HTTP/SSE URL)L'URL du serveur et des en-têtes HTTPOui
Local (stdio command)Une commande et des variables d'environnementNon. Il est enregistré, mais les sessions ne le démarrent pas.

Les sessions s'exécutent sur la plateforme, pas sur votre ordinateur : elles ne peuvent donc pas démarrer un programme sur votre machine. Utilisez un serveur distant pour tout ce que vos agents doivent appeler.

Les serveurs distants doivent :

  • se trouver à une adresse HTTPS publique (les réseaux privés et localhost sont refusés) ;
  • parler le transport MCP Streamable HTTP (JSON-RPC sur POST, avec une réponse en JSON ou en flux d'événements) ;
  • accepter l'authentification dans des en-têtes statiques, comme un bearer token. Les serveurs qui nécessitent une connexion OAuth ne sont pas encore pris en charge, pas plus que l'ancien transport uniquement SSE.

Ajouter un serveur

  1. Ouvrez Configure → MCP Servers et choisissez Add MCP server.
  2. Saisissez un Name, par exemple « GitHub ». AI CodeOps en tire l'identifiant du serveur, en minuscules avec des tirets : « GitHub » devient github, « Docs Search » devient docs-search. Les noms d'outils et les règles de politique utilisent cet identifiant.
  3. Choisissez Remote (HTTP/SSE URL) et saisissez la Server URL.
  4. Sous Headers, ajoutez un KEY=value par ligne, par exemple :
    Authorization=Bearer <your token>
  5. Choisissez Save MCP server.

Le serveur apparaît sous Servers avec Disable et Remove. Il n'y a pas encore de formulaire de modification : pour changer un serveur, supprimez-le et ajoutez-le de nouveau.

La gestion des serveurs MCP nécessite la permission MCP-manage : les rôles Owner, Admin et DevOps Admin par défaut.

Comment les secrets sont stockés

Les en-têtes (serveurs distants) et les variables d'environnement (serveurs locaux) sont chiffrés au repos avec AES-256-GCM. Ils ne sont jamais renvoyés au navigateur ; la liste indique seulement quelles clés sont définies, par exemple « 1 header: Authorization ». Ils ne sont déchiffrés que lorsqu'une session se connecte au serveur. La création, la modification, l'activation, la désactivation et la suppression d'un serveur sont enregistrées dans le journal d'audit.

Comment les agents obtiennent les outils

Lorsqu'une session démarre, AI CodeOps se connecte à chaque serveur distant activé et liste ses outils. Un serveur injoignable est ignoré, et la session s'exécute sans ses outils.

  • Les outils sont nommés <server>__<tool>, par exemple github__create_issue.
  • Une session peut proposer jusqu'à 32 outils MCP au total.
  • À chaque étape d'agent, un agent peut effectuer jusqu'à 6 séries d'appels d'outils.
  • Chaque appel expire au bout de 30 secondes, et les résultats longs sont raccourcis.

Vous pouvez restreindre de deux façons les outils qui parviennent aux agents.

Par agent

Dans Configure → Agents, un agent personnalisé a un choix MCP tools this agent may use : None (la valeur par défaut pour un nouvel agent), Only the tools listed ou All tools the workspace allows. Pour une liste, saisissez des serveurs, des outils ou des noms server__tool, séparés par des virgules. Un agent enregistré avant l'existence de ce choix conserve tous les outils tant que vous ne le modifiez pas.

Par la politique de l'espace de travail

Une règle de politique sur l'action mcp.invoke vise server/tool. Un outil que la politique n'autorise pas n'est jamais proposé aux agents. Par exemple, pour tenir tous les outils de suppression du serveur GitHub à l'écart de vos sessions :

{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }

Les règles mcp.invoke peuvent utiliser allow ou deny, pas ask. Avec le réglage de confiance None, les outils MCP sont refusés sauf si une règle les autorise.

Dépannage

Si une session n'utilise pas les outils d'un serveur :

  • Vérifiez que le serveur est activé et qu'il s'agit d'un serveur Remote.
  • Vérifiez que l'URL est en HTTPS public et que le serveur prend en charge Streamable HTTP, pas seulement SSE.
  • Vérifiez les en-têtes : un token expiré fait que le serveur refuse la connexion.
  • Vérifiez le champ MCP tools allowed de l'agent personnalisé et la politique de votre espace de travail.

Étapes suivantes

Questions fréquentes

AI CodeOps est-il lui-même un serveur MCP ?

Oui, indépendamment de cette page. Son serveur MCP permet à Claude Code, à Cursor ou à un autre client MCP d'utiliser votre espace de travail ; consultez le guide du serveur MCP d'AI CodeOps. Cette page traite de l'autre sens, les serveurs auxquels vos sessions se connectent.

Les sessions démarrent-elles des serveurs MCP locaux (stdio) ?

Non. Vous pouvez enregistrer un serveur local, mais les sessions ne se connectent qu'à des serveurs distants, en HTTPS.

Puis-je voir un en-tête après l'avoir enregistré ?

Non. Les en-têtes et les variables d'environnement sont chiffrés au repos et ne sont plus jamais affichés. La liste indique seulement quelles clés sont définies.

Cette page vous a-t-elle été utile ?