AI CodeOps

El servidor MCP de AI CodeOps

Última actualización

Conecta Claude Code, Cursor o cualquier cliente MCP a AI CodeOps: lanza sesiones, lee hallazgos, comprueba el control de publicación y obtén paquetes de evidencias desde tu editor.

AI CodeOps ejecuta un servidor MCP remoto, para que la herramienta de programación con IA que ya usas pueda trabajar con tu espacio de trabajo: lanzar una sesión desde tu editor, seguirla, comprobar si un pull request puede entregarse y obtener el registro firmado de un cambio.

Es distinto de los servidores MCP, donde AI CodeOps se conecta a otros servidores para que los agentes de tus sesiones puedan usar sus herramientas. Aquí, AI CodeOps es el servidor.

Conectar

Necesitas una clave de API del espacio de trabajo. Crea una en Configure → API Keys; empieza por sk- y se muestra una sola vez. Consulta claves de API.

Claude Code:

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

Después ejecuta /mcp en Claude Code: aicodeops aparece como conectado, con sus nueve herramientas.

Cursor, en .cursor/mcp.json:

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

Cualquier otro cliente: la dirección es https://console.aicodeops.dev/mcp, el transporte es Streamable HTTP y la clave va en la cabecera Authorization: Bearer.

Mantén la clave fuera de los archivos de los que haces commit: la mayoría de los clientes la leen de una variable de entorno.

Un cliente o un registro que descubre servidores por su descripción puede leer la de este en https://console.aicodeops.dev/server.json (también en /.well-known/mcp/server.json). No necesita ninguna clave, y lista la dirección, el transporte y la cabecera en la que va la clave.

Herramientas

HerramientaQué haceLa clave necesita
list_projectsLista los proyectos del espacio de trabajo y sus repositorios.workspace:read
start_sessionLanza una sesión en un proyecto con una tarea. Opcional: un workflow (por defecto plan-build-review-test) y un agent.workflow_run:manage
get_sessionEl estado de una sesión, sus pasos, el pull request que abrió y su cambio.workspace:read
check_release_gateSi un pull request o un commit puede entregarse, con los motivos. La misma comprobación que la API.workspace:read
list_findingsHallazgos de seguridad y de calidad, filtrados por severity o por category.workspace:read
get_evidence_packEl paquete de evidencias firmado de un cambio, por changeID o por la sesión que lo inició.workspace:audit.read
list_buildsBuilds recientes: qué inició cada uno (una persona, un build guardado, un push, un pull request, una programación), su rama y su commit, y cómo terminó.workspace:read
get_buildUn build: el paso en el que falló y el final de su salida, para ver por qué falló.workspace:read
list_saved_buildsLos builds que conserva el espacio de trabajo, incluidos los del archivo de build de un repositorio, y qué inicia cada uno.workspace:read

Una herramienta que la clave no puede usar responde con un error que dice por qué, y las demás herramientas siguen funcionando. start_session y get_evidence_pack necesitan además que su permiso figure en el Scope de la clave (consulta más abajo).

Qué puede hacer una herramienta

Cada herramienta actúa como el creador de la clave y pasa por las mismas comprobaciones que la consola:

  • Roles: un miembro que no puede lanzar sesiones en la consola tampoco puede lanzarlas aquí. La clave de un Viewer puede leer, y nada más.
  • Scope de la clave: una clave sin Scope, o una cuyo Scope incluya Release gate check from CI, and read-only MCP tools, puede usar las siete herramientas de lectura. start_session y get_evidence_pack solo funcionan con una clave cuyo Scope incluya su permiso: elige Scope en la clave, en Configure → API Keys, y marca Start sessions from the MCP server (/mcp) o Evidence packs from the MCP server (/mcp), y deja marcada Release gate check from CI, and read-only MCP tools para que las herramientas de lectura sigan funcionando. Una clave sin Scope no puede lanzar sesiones aquí, así que las claves ya creadas para CI o para la pasarela de modelos no lo consiguen por sí solas. La limitación del alcance de las claves depende de tu plan.
  • Gasto: las sesiones cuentan para el presupuesto del espacio de trabajo y para el límite de trabajo en curso del agente, igual que en la consola.
  • Auditoría: una sesión registra quién la lanzó, el creador de la clave. La exportación de un paquete de evidencias se anota en el registro de auditoría.

Una sesión lanzada aquí abre su pull request como cualquier otra, así que tus aprobaciones y el control de publicación se siguen aplicando antes de que se fusione.

Límites

  • 120 peticiones por minuto desde una misma dirección.
  • Sin estado: cada petición es independiente. El servidor no envía notificaciones ni abre un flujo de eventos.
  • Solo claves de API del espacio de trabajo. El inicio de sesión con OAuth todavía no es compatible.

Preguntas frecuentes

¿Cómo inicia sesión el servidor MCP?

Con una clave de API del espacio de trabajo enviada como token Bearer. La clave actúa como el miembro que la creó, con el rol actual de ese miembro. El inicio de sesión con OAuth todavía no es compatible.

¿Puede el servidor MCP cambiar mi código directamente?

No. start_session lanza una sesión, y la sesión funciona igual que desde la consola, mediante un pull request al que se siguen aplicando tus aprobaciones y el control de publicación. Todas las demás herramientas solo leen.

¿Qué clientes funcionan?

Cualquier cliente MCP que admita el transporte Streamable HTTP y una cabecera personalizada, incluidos Claude Code y Cursor.

¿Te resultó útil esta página?