AI CodeOps

AI CodeOps pour OpenAI Codex

Ajoutez le serveur MCP d'AI CodeOps à Codex dans config.toml : lancez des sessions IA sous barrières, lisez les constats et vérifiez la barrière de livraison depuis la CLI Codex ou l'extension IDE.

Codex est l'agent de codage d'OpenAI, disponible dans une CLI, une extension IDE, l'application de bureau ChatGPT et le cloud. AI CodeOps est une plateforme dans le navigateur où des agents IA planifient, écrivent, testent et relisent un changement, et où ce changement ne devient une pull request qu'une fois ses barrières qualité franchies et l'approbation d'une personne obtenue. Ajoutez le serveur MCP d'AI CodeOps à Codex, et il peut confier une tâche à une session AI CodeOps sous barrières, la suivre, lire ses constats et demander si une pull request peut être livrée.

Ce qu'AI CodeOps soumet à ses barrières, et ce qu'il laisse de côté

AI CodeOps soumet à ses barrières les changements réalisés dans ses propres sessions. Lorsqu'une tâche Codex cloud se termine, vous pouvez créer un commit ou ouvrir une pull request à partir d'elle (Codex cloud), et sur GitHub vous pouvez demander à Codex de relire une pull request avec @codex review (Codex sur GitHub). Ces pull requests sont des pull requests ordinaires : AI CodeOps ne les relit pas, et la vérification de livraison les refuse parce qu'aucune session AI CodeOps ne les a produites.

Pour faire passer le travail par les barrières d'AI CodeOps, demandez à Codex de lancer une session AI CodeOps avec la tâche. La session écrit le changement, exécute vos tests, le fait relire par plusieurs agents et n'ouvre la pull request que lorsque la barrière est franchie. Ou interrogez la barrière de livraison avant une fusion, depuis Codex ou depuis la CI.

Connecter Codex

  1. Dans AI CodeOps, créez une clé API de l'espace de travail sous Configure → API Keys. Elle commence par sk- et n'est affichée qu'une fois. Pour permettre à Codex de lancer des sessions, choisissez Scope sur la clé et cochez Start sessions from the MCP server (/mcp). Consultez clés API.
  2. Placez la clé dans une variable d'environnement, par exemple AICODEOPS_API_KEY.
  3. Ajoutez le serveur à ~/.codex/config.toml. Pour un serveur Streamable HTTP, la documentation d'OpenAI mentionne url et bearer_token_env_var, le nom de la variable dont Codex envoie la valeur dans l'en-tête Authorization (documentation MCP de Codex) :
    [mcp_servers.aicodeops]
    url = "https://console.aicodeops.dev/mcp"
    bearer_token_env_var = "AICODEOPS_API_KEY"

Pour limiter le serveur à un seul dépôt, placez la même table dans .codex/config.toml dans ce projet ; Codex ne lit les fichiers de projet que pour les projets de confiance. La CLI, l'extension IDE et l'application de bureau ChatGPT partagent cette configuration : une seule entrée couvre donc les trois.

Ce que Codex peut faire

OutilCe qu'il fait
list_projectsListe les projets de l'espace de travail et leurs dépôts.
start_sessionLance une session sur un projet avec une tâche. Vous pouvez nommer un workflow et un agent.
get_sessionLe statut d'une session, ses étapes, la pull request qu'elle a ouverte et son changement.
check_release_gateIndique si une pull request ou un commit peut être livré : constats bloquants, tests en échec et autres motifs.
list_findingsLes constats de sécurité et de qualité, les plus récents d'abord.
get_evidence_packLe dossier de preuves signé d'un changement, par changement ou par session.
list_buildsLes builds récents : ce qui a lancé chacun, sa branche et son commit, et comment il s'est terminé.
get_buildUn build : l'étape où il a échoué et la fin de sa sortie.
list_saved_buildsLes builds que l'espace de travail conserve, et ce qui lance chacun.

Chaque outil agit au nom du créateur de la clé, en passant par les mêmes contrôles que la console : son rôle, le budget de l'espace de travail et la limite de travaux en cours de l'agent. Une session que Codex lance ouvre sa pull request comme n'importe quelle autre : les approbations et la barrière de livraison s'appliquent donc toujours. Consultez le guide du serveur MCP.

Ce que vous pouvez demander à Codex :

Use AI CodeOps to start a security-sensitive-change session on the payments project: rotate the webhook signing secret handling.
Poll that AI CodeOps session and summarize the findings when it's done.
Check the AI CodeOps release gate for commit 3f9c2ab and tell me why it's denied, if it is.

Soumettre les fusions à la barrière dans la CI

La vérification de livraison est une API HTTP : tout système de CI capable d'exécuter curl peut donc l'interroger avant une fusion :

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $AICODEOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"commitSHA\":\"$GIT_COMMIT\"}" > gate.json
jq -e '.allowed == true' gate.json

Vous pouvez envoyer un pullRequestURL ou un commitSHA de 7 caractères ou plus. La réponse est 200 avec allowed, un résumé et des motifs ; si la vérification elle-même échoue, allowed vaut false. Les options comprennent un seuil de couverture, des workflows requis, des licences interdites et un déploiement en staging requis (API). En tant que vérification requise, elle refuse tout changement qu'aucune session AI CodeOps n'a produit.

Limites

  • 120 requêtes MCP par minute depuis une même adresse ; 60 vérifications de livraison par minute et par espace de travail.
  • Le serveur est sans état et n'envoie aucune notification : Codex interroge donc régulièrement get_session pour suivre une session.
  • Clés API de l'espace de travail uniquement. La connexion par OAuth n'est pas encore prise en charge.

Pour commencer

  1. Créez un compte gratuit : AI CodeOps est en bêta ouverte et fonctionne dans votre navigateur.
  2. Connectez votre hébergeur Git et créez un projet, à l'aide du guide de démarrage rapide.
  3. Créez une clé API et ajoutez le serveur à config.toml comme ci-dessus.

Vous utilisez un autre agent de codage ? Consultez AI CodeOps pour Claude Code, Cursor ou GitHub Copilot.

Questions fréquentes

AI CodeOps relit-il les pull requests ouvertes par Codex ?

Non. AI CodeOps soumet à ses barrières les changements réalisés dans ses propres sessions. Une pull request ouverte depuis une tâche Codex cloud n'est pas relue par AI CodeOps, et la vérification de livraison la refuse parce qu'aucune session AI CodeOps ne l'a produite.

Où placer la configuration ?

Dans ~/.codex/config.toml, ou dans .codex/config.toml pour un projet de confiance. La documentation d'OpenAI indique que la CLI Codex, l'extension IDE et l'application de bureau ChatGPT partagent cette configuration.

Comment Codex envoie-t-il la clé API ?

Définissez bearer_token_env_var sur le nom d'une variable d'environnement qui contient la clé. Codex l'envoie dans l'en-tête Authorization, de sorte que la clé ne se trouve jamais dans le fichier.

Codex peut-il lancer des sessions AI CodeOps ?

Oui, avec une clé dont le périmètre inclut Start sessions from the MCP server. Une clé sans périmètre ne peut utiliser que les sept outils de lecture.