- Inicio
- Integraciones
- AI CodeOps para Claude Code
AI CodeOps para Claude Code
Conecta Claude Code al servidor MCP de AI CodeOps: pasa tareas a sesiones con controles, comprueba el control de publicación antes de una fusión y lee los hallazgos, desde tu terminal.
Claude Code es un agente de programación que ejecutas en tu terminal. 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. Conecta los dos mediante el servidor MCP de AI CodeOps, y Claude Code 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
Ten esto claro antes de configurar nada. AI CodeOps somete a sus controles los cambios hechos en sus propias sesiones. Un pull request que Claude Code abre por su cuenta, desde tu terminal o desde Claude Code GitHub Actions, es un pull request corriente: AI CodeOps no lo revisa, y la comprobación de publicación lo deniega con "No workflow runs found for …", porque no lo hizo ninguna sesión de AI CodeOps.
Así que hay dos formas de hacer pasar el trabajo de Claude Code por los controles:
- Pasa la tarea. Desde Claude Code, llama a
start_sessioncon la tarea. Una sesión de AI CodeOps escribe el cambio, ejecuta tus pruebas, lo revisa con varios agentes y abre el pull request solo cuando se supera el control. - Comprueba antes de fusionar. Pregunta a
check_release_gatepor un pull request, o ejecuta la misma comprobación en CI, para que nada se fusione sin un veredicto de permitido.
Conectar Claude Code
- 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 Claude Code pueda lanzar sesiones, elige Scope en la clave y marca Start sessions from the MCP server (/mcp). Marca también Evidence packs from the MCP server (/mcp) si quieres paquetes de evidencias. Consulta claves de API. - Añade el servidor. La documentación de MCP de Claude Code da esta forma para un servidor HTTP remoto con una cabecera:
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \ --header "Authorization: Bearer sk-..." - Ejecuta
/mcpen Claude Code.aicodeopsaparece como conectado, con nueve herramientas.
Por defecto el servidor se añade para ti, solo en el proyecto actual. Para compartirlo con tu equipo, añade --scope project: Claude Code escribe el servidor en .mcp.json en la raíz del repositorio. Claude Code expande las variables de entorno de ese archivo, así que la clave queda fuera del control de versiones:
{
"mcpServers": {
"aicodeops": {
"type": "http",
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
}
}
}
Qué puede hacer Claude Code
| Herramienta | Qué hace |
|---|---|
list_projects | Lista los proyectos del espacio de trabajo y sus repositorios. |
start_session | Lanza una sesión en un proyecto con una tarea, por defecto con el flujo de trabajo plan-build-review-test. |
get_session | El estado de una sesión, sus pasos, el pull request que abrió y su cambio. |
check_release_gate | Si un pull request o un commit puede entregarse, con los motivos. |
list_findings | Hallazgos de seguridad y de calidad, filtrados por gravedad o por categoría. |
get_evidence_pack | El paquete de evidencias firmado de un cambio. |
list_builds | Builds recientes: qué inició cada uno, su rama y su commit, y cómo terminó. |
get_build | Un build: el paso en el que falló y el final de su salida. |
list_saved_builds | Los 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 lanzada desde Claude Code abre su pull request como cualquier otra, así que las aprobaciones y el control de publicación se siguen aplicando. La referencia completa está en la guía del servidor MCP.
Cosas que puedes pedirle a Claude Code una vez conectado:
List my AI CodeOps projects, then start a session on the api project to add rate limiting to the login route.
Check on that session until it finishes, and tell me what the reviewers found.
Ask the AI CodeOps release gate whether https://github.com/acme/api/pull/42 may ship, and list the reasons.
Someter las fusiones al control en CI
La comprobación de publicación es también una API HTTP, así que CI puede hacer la misma pregunta antes de una fusión. Este job de GitHub Actions falla cuando el control deniega el pull request:
name: AI CodeOps release gate
on: pull_request
jobs:
gate:
runs-on: ubuntu-latest
steps:
- name: Ask the release gate
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $AICODEOPS_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pullRequestURL\":\"$PR_URL\"}" > gate.json
jq -r '.summary' gate.json
jq -e '.allowed == true' gate.json
El endpoint responde 200 con allowed en true o false, un resumen y los motivos. Puedes añadir un mínimo de cobertura, flujos de trabajo obligatorios, licencias no permitidas y un despliegue obligatorio en staging; los campos están en la página de la API. Recuerda lo que significa como comprobación obligatoria: un pull request que no hizo ninguna sesión de AI CodeOps se deniega, incluido uno que Claude Code abrió por su cuenta.
Límites
- 120 peticiones MCP por minuto desde una misma dirección; la comprobación de CI admite 60 por minuto por espacio de trabajo.
- El servidor MCP no tiene estado y no envía notificaciones, así que Claude Code consulta
get_sessionperió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
- Crea una cuenta gratuita: AI CodeOps está en beta abierta y funciona en tu navegador.
- Conecta tu proveedor de Git y crea un proyecto, con la guía de inicio rápido.
- Crea una clave de API y añade el servidor a Claude Code como se indica arriba.
¿Usas otro agente de programación? Consulta AI CodeOps para Codex, Cursor o GitHub Copilot. Para el otro sentido, en el que las sesiones de AI CodeOps llaman a tus servidores MCP, consulta AI CodeOps y MCP.
Preguntas frecuentes
¿AI CodeOps revisa los pull requests que abre Claude Code?
No. AI CodeOps somete a sus controles los cambios que hacen sus propias sesiones. Un pull request que Claude Code abre por su cuenta no se revisa, y la comprobación de publicación lo deniega porque no lo hizo ninguna sesión. Para someter el trabajo a los controles, pasa la tarea a una sesión de AI CodeOps desde Claude Code.
¿Cómo inicia sesión Claude Code en AI CodeOps?
Con una clave de API del espacio de trabajo enviada como cabecera Bearer. La clave actúa como el miembro que la creó, con el rol y el presupuesto de ese miembro. El inicio de sesión con OAuth todavía no es compatible.
¿Puede Claude Code lanzar sesiones sin preguntarme?
Solo con una clave cuyo Scope incluya Start sessions from the MCP server. Una clave sin Scope puede usar las siete herramientas de lectura y nada más.
¿Puedo compartir la configuración con mi equipo?
Sí. Añade el servidor con --scope project y Claude Code lo escribe en .mcp.json en el repositorio. Guarda la clave en una variable de entorno, no en el archivo.