AI CodeOps

AI CodeOps para OpenAI Codex

Añade el servidor MCP de AI CodeOps a Codex en config.toml: lanza sesiones de IA con controles, lee los hallazgos y consulta el control de publicación desde la CLI de Codex o la extensión del IDE.

Codex es el agente de programación de OpenAI, disponible en una CLI, una extensión de IDE, la aplicación de escritorio de ChatGPT y la nube. AI CodeOps es una plataforma en el navegador en la que agentes de IA planifican, escriben, prueban y revisan un cambio, y el cambio solo se convierte en un pull request cuando se superan sus controles de calidad y una persona lo aprueba. Añade el servidor MCP de AI CodeOps a Codex y este puede pasar una tarea a una sesión de AI CodeOps con controles, seguirla, leer sus hallazgos y preguntar si un pull request puede entregarse.

Qué somete AI CodeOps a sus controles y qué no

AI CodeOps somete a sus controles los cambios hechos en sus propias sesiones. Cuando una tarea de Codex en la nube termina, puedes hacer commit o abrir un pull request a partir de ella (Codex cloud), y en GitHub puedes pedir a Codex que revise un pull request con @codex review (Codex en GitHub). Esos pull requests son pull requests corrientes: AI CodeOps no los revisa, y la comprobación de publicación los deniega porque no los hizo ninguna sesión de AI CodeOps.

Para hacer pasar el trabajo por los controles de AI CodeOps, pide a Codex que lance una sesión de AI CodeOps con la tarea. La sesión escribe el cambio, ejecuta tus pruebas, lo revisa con varios agentes y abre el pull request solo cuando se supera el control. O pregunta al control de publicación antes de una fusión, desde Codex o desde CI.

Conectar Codex

  1. En AI CodeOps, crea una clave de API del espacio de trabajo en Configure → API Keys. Empieza por sk- y se muestra una sola vez. Para que Codex pueda lanzar sesiones, elige Scope en la clave y marca Start sessions from the MCP server (/mcp). Consulta claves de API.
  2. Pon la clave en una variable de entorno, por ejemplo AICODEOPS_API_KEY.
  3. Añade el servidor a ~/.codex/config.toml. Para un servidor Streamable HTTP, la documentación de OpenAI indica url y bearer_token_env_var, el nombre de la variable cuyo valor envía Codex en la cabecera Authorization (documentación de MCP de Codex):
    [mcp_servers.aicodeops]
    url = "https://console.aicodeops.dev/mcp"
    bearer_token_env_var = "AICODEOPS_API_KEY"

Para limitar el servidor a un repositorio, pon la misma tabla en .codex/config.toml en ese proyecto; Codex solo lee los archivos de proyecto en los proyectos de confianza. La CLI, la extensión de IDE y la aplicación de escritorio de ChatGPT comparten esta configuración, así que una sola entrada cubre las tres.

Qué puede hacer Codex

HerramientaQué hace
list_projectsLista los proyectos del espacio de trabajo y sus repositorios.
start_sessionLanza una sesión en un proyecto con una tarea. Puedes indicar un workflow y un agent.
get_sessionEl estado de una sesión, sus pasos, el pull request que abrió y su cambio.
check_release_gateSi un pull request o un commit puede entregarse: hallazgos bloqueantes, pruebas fallidas y otros motivos.
list_findingsHallazgos de seguridad y de calidad, del más reciente al más antiguo.
get_evidence_packEl paquete de evidencias firmado de un cambio, por cambio o por sesión.
list_buildsBuilds recientes: qué inició cada uno, su rama y su commit, y cómo terminó.
get_buildUn build: el paso en el que falló y el final de su salida.
list_saved_buildsLos builds que conserva el espacio de trabajo y qué inicia cada uno.

Cada herramienta actúa como el creador de la clave y pasa por las mismas comprobaciones que la consola: su rol, el presupuesto del espacio de trabajo y el límite de trabajo en curso del agente. Una sesión que lanza Codex abre su pull request como cualquier otra, así que las aprobaciones y el control de publicación se siguen aplicando. Consulta la guía del servidor MCP.

Cosas que pedirle a 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.

Someter las fusiones al control en CI

La comprobación de publicación es una API HTTP, así que cualquier sistema de CI que pueda ejecutar curl puede consultarla antes de una fusión:

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

Puedes enviar un pullRequestURL o un commitSHA de 7 caracteres o más. La respuesta es 200 con allowed, un resumen y los motivos; si la propia comprobación falla, allowed es false. Las opciones incluyen un mínimo de cobertura, flujos de trabajo obligatorios, licencias no permitidas y un despliegue obligatorio en staging (API). Como comprobación obligatoria, deniega cualquier cambio que no haya hecho una sesión de AI CodeOps.

Límites

  • 120 peticiones MCP por minuto desde una misma dirección; 60 comprobaciones de publicación por minuto por espacio de trabajo.
  • El servidor no tiene estado y no envía notificaciones, así que Codex consulta get_session periódicamente para seguir una sesión.
  • Solo claves de API del espacio de trabajo. El inicio de sesión con OAuth todavía no es compatible.

Primeros pasos

  1. Crea una cuenta gratuita: AI CodeOps está en beta abierta y funciona en tu navegador.
  2. Conecta tu proveedor de Git y crea un proyecto, con la guía de inicio rápido.
  3. Crea una clave de API y añade el servidor a config.toml como se indica arriba.

¿Usas otro agente de programación? Consulta AI CodeOps para Claude Code, Cursor o GitHub Copilot.

Preguntas frecuentes

¿AI CodeOps revisa los pull requests que abre Codex?

No. AI CodeOps somete a sus controles los cambios hechos en sus propias sesiones. Un pull request abierto desde una tarea de Codex en la nube no lo revisa AI CodeOps, y la comprobación de publicación lo deniega porque no lo hizo ninguna sesión de AI CodeOps.

¿Dónde va la configuración?

En ~/.codex/config.toml, o en .codex/config.toml en un proyecto de confianza. La documentación de OpenAI dice que la CLI de Codex, la extensión de IDE y la aplicación de escritorio de ChatGPT comparten esta configuración.

¿Cómo envía Codex la clave de API?

Pon en bearer_token_env_var el nombre de una variable de entorno que contenga la clave. Codex la envía en la cabecera Authorization, así que la clave nunca está en el archivo.

¿Puede Codex lanzar sesiones de AI CodeOps?

Sí, con una clave cuyo Scope incluya Start sessions from the MCP server. Una clave sin Scope solo puede usar las siete herramientas de lectura.