AI CodeOps

Le serveur MCP d'AI CodeOps

Mis à jour le

Connectez Claude Code, Cursor ou tout client MCP à AI CodeOps : lancez des sessions, lisez les constats, vérifiez la barrière de livraison et récupérez des dossiers de preuves depuis votre éditeur.

AI CodeOps exploite un serveur MCP distant : l'outil de codage IA que vous utilisez déjà peut donc travailler avec votre espace de travail, pour lancer une session depuis votre éditeur, la suivre, vérifier si une pull request peut être livrée et récupérer l'enregistrement signé d'un changement.

Il est distinct des serveurs MCP, où AI CodeOps se connecte à d'autres serveurs pour que les agents de vos sessions puissent utiliser leurs outils. Ici, AI CodeOps est le serveur.

Se connecter

Il vous faut une clé API de l'espace de travail. Créez-en une sous Configure → API Keys ; elle commence par sk- et n'est affichée qu'une fois. Consultez Clés API.

Claude Code :

claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
  --header "Authorization: Bearer sk-..."

Exécutez ensuite /mcp dans Claude Code : aicodeops apparaît comme connecté, avec ses neuf outils.

Cursor, dans .cursor/mcp.json :

{
  "mcpServers": {
    "aicodeops": {
      "url": "https://console.aicodeops.dev/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}

Tout autre client : l'adresse est https://console.aicodeops.dev/mcp, le transport est Streamable HTTP, et la clé va dans l'en-tête Authorization: Bearer.

Gardez la clé hors des fichiers que vous commitez : la plupart des clients la lisent dans une variable d'environnement.

Un client ou un registre qui découvre les serveurs par leur description peut lire celle de ce serveur à https://console.aicodeops.dev/server.json (également à /.well-known/mcp/server.json). Elle ne nécessite aucune clé, et indique l'adresse, le transport et l'en-tête dans lequel va la clé.

Outils

OutilCe qu'il faitLa clé doit avoir
list_projectsListe les projets de l'espace de travail et leurs dépôts.workspace:read
start_sessionLance une session sur un projet avec une tâche. Facultatif : un workflow (par défaut plan-build-review-test) et un agent.workflow_run:manage
get_sessionLe statut d'une session, ses étapes, la pull request qu'elle a ouverte et son changement.workspace:read
check_release_gateIndique si une pull request ou un commit peut être livré, avec les motifs. La même vérification que l'API.workspace:read
list_findingsLes constats de sécurité et de qualité, filtrés par severity ou category.workspace:read
get_evidence_packLe dossier de preuves signé d'un changement, par changeID ou par la session qui l'a lancé.workspace:audit.read
list_buildsLes builds récents : ce qui a lancé chacun (une personne, un build enregistré, un push, une pull request, une planification), sa branche et son commit, et comment il s'est terminé.workspace:read
get_buildUn build : l'étape où il a échoué et la fin de sa sortie, pour voir pourquoi il a échoué.workspace:read
list_saved_buildsLes builds que l'espace de travail conserve, y compris ceux du fichier de build d'un dépôt, et ce qui lance chacun.workspace:read

Un outil que la clé ne peut pas utiliser répond par une erreur qui indique pourquoi, et les autres outils continuent de fonctionner. start_session et get_evidence_pack ont aussi besoin que leur permission figure dans le périmètre de la clé (voir ci-dessous).

Ce qu'un outil peut faire

Chaque outil agit au nom du créateur de la clé, en passant par les mêmes contrôles que la console :

  • Rôles : un membre qui ne peut pas lancer de sessions dans la console ne peut pas en lancer ici. La clé d'un Viewer peut lire, rien de plus.
  • Périmètre de la clé : une clé sans périmètre, ou dont le périmètre inclut Release gate check from CI, and read-only MCP tools, peut utiliser les sept outils de lecture. start_session et get_evidence_pack ne fonctionnent que pour une clé dont le périmètre inclut leur permission : choisissez Scope sur la clé sous Configure → API Keys et cochez Start sessions from the MCP server (/mcp) ou Evidence packs from the MCP server (/mcp), et laissez Release gate check from CI, and read-only MCP tools coché pour que les outils de lecture fonctionnent toujours. Une clé sans périmètre ne peut pas lancer de sessions ici : les clés déjà créées pour la CI ou la passerelle de modèles n'obtiennent donc pas cette possibilité d'elles-mêmes. La limitation du périmètre des clés dépend de votre offre.
  • Dépenses : les sessions comptent dans le budget de l'espace de travail et dans la limite de travaux en cours de l'agent, comme dans la console.
  • Audit : une session enregistre qui l'a lancée, à savoir le créateur de la clé. L'export d'un dossier de preuves est enregistré dans le journal d'audit.

Une session lancée ici ouvre sa pull request comme n'importe quelle autre : vos approbations et la barrière de livraison s'appliquent donc toujours avant sa fusion.

Limites

  • 120 requêtes par minute depuis une même adresse.
  • Sans état : chaque requête est autonome. Le serveur n'envoie pas de notifications et n'ouvre pas de flux d'événements.
  • Clés API de l'espace de travail uniquement. La connexion par OAuth n'est pas encore prise en charge.

Questions fréquentes

Comment le serveur MCP s'authentifie-t-il ?

Avec une clé API de l'espace de travail envoyée comme Bearer token. La clé agit au nom du membre qui l'a créée, avec le rôle actuel de ce membre. La connexion par OAuth n'est pas encore prise en charge.

Le serveur MCP peut-il modifier mon code directement ?

Non. start_session lance une session, et la session travaille comme depuis la console, par une pull request à laquelle vos approbations et votre barrière de livraison s'appliquent toujours. Tous les autres outils ne font que lire.

Quels clients fonctionnent ?

Tout client MCP qui prend en charge le transport Streamable HTTP et un en-tête personnalisé, dont Claude Code et Cursor.

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