AI CodeOps

AI CodeOps para GitHub Copilot

Conecta GitHub Copilot al servidor MCP de AI CodeOps en VS Code o en el agente en la nube de Copilot, y somete los pull requests al control con la comprobación de publicación que tu CI puede llamar.

GitHub Copilot funciona en tu editor, como un agente en la nube que abre pull requests y como revisor en GitHub. 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 Copilot al servidor MCP de AI CodeOps y Copilot puede pasar una tarea a una sesión de AI CodeOps con controles, 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 el agente en la nube de Copilot trabaja en una tarea, hace push a su propia rama y abre un pull request; la documentación de GitHub dice que está sujeto a las protecciones de rama y a las comprobaciones obligatorias del repositorio, y que no puede aprobar ni fusionar su propio pull request (riesgos y mitigaciones). Ese pull request no es un cambio de AI CodeOps: AI CodeOps no lo revisa, y la comprobación de publicación lo deniega porque no lo hizo ninguna sesión de AI CodeOps.

Para hacer pasar el trabajo por los controles de AI CodeOps, haz que Copilot lance una sesión de AI CodeOps con la tarea, o lánzala tú en AI CodeOps. La sesión escribe el cambio, ejecuta tus pruebas, lo revisa con varios agentes y abre el pull request en una rama codeops/run-<id> solo cuando se supera el control (AI CodeOps para GitHub).

Conectar Copilot en VS Code

  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 Copilot pueda lanzar sesiones, elige Scope en la clave y marca Start sessions from the MCP server (/mcp). Consulta claves de API.
  2. Añade el servidor a .vscode/mcp.json. El formato de VS Code usa un objeto servers, y una entrada inputs pide la clave para que nunca se escriba en el archivo (configuración de MCP en VS Code):
    {
      "inputs": [
        { "type": "promptString", "id": "aicodeops-key", "description": "AI CodeOps API key", "password": true }
      ],
      "servers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer ${input:aicodeops-key}" }
        }
      }
    }
  3. Inicia el servidor desde VS Code, que te pide la clave, y después usa Copilot en modo agente. Puede llamar a las nueve herramientas de AI CodeOps.

Conectar el agente en la nube de Copilot

El agente en la nube lee una configuración de MCP desde los ajustes del repositorio (ampliar el agente en la nube con MCP):

  1. En el repositorio en GitHub, abre Settings. En Code, planning, and automation, elige Copilot y después MCP servers.
  2. Añade un secreto de Agents llamado COPILOT_MCP_AICODEOPS_KEY que contenga la clave de API. Solo los secretos y las variables cuyo nombre empieza por COPILOT_MCP_ están disponibles para la configuración.
  3. Pega esto en MCP configuration y elige Save MCP configuration:
    {
      "mcpServers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer $COPILOT_MCP_AICODEOPS_KEY" },
          "tools": ["list_projects", "get_session", "check_release_gate", "list_findings"]
        }
      }
    }

La documentación de GitHub dice que los campos de texto de esta configuración, incluidas las cabeceras, pueden hacer referencia a secretos COPILOT_MCP_ con $NAME o ${NAME}. La lista tools es obligatoria; el ejemplo permite solo las herramientas de lectura, de modo que el agente en la nube puede consultar el control y leer hallazgos, pero no puede lanzar sesiones. La documentación de GitHub dice también que la revisión de código de Copilot puede usar servidores MCP para incorporar contexto a una revisión (revisión de código).

Qué hacen las herramientas

HerramientaQué haceLa clave necesita
list_projectsLos proyectos del espacio de trabajo y sus repositoriosworkspace:read
start_sessionLanza una sesión con controles en un proyecto con una tareaworkflow_run:manage
get_sessionEl estado de una sesión, sus pasos, su pull request y su cambioworkspace:read
check_release_gateSi un pull request o un commit puede entregarse, con los motivosworkspace:read
list_findingsHallazgos de seguridad y de calidad, por gravedad o por categoríaworkspace:read
get_evidence_packEl paquete de evidencias firmado de un cambioworkspace:audit.read
list_buildsBuilds recientes, qué inició cada uno y cómo terminóworkspace:read
get_buildUn build: el paso en el que falló y el final de su salidaworkspace:read
list_saved_buildsLos builds que conserva el espacio de trabajo y qué inicia cada unoworkspace:read

Cada herramienta actúa como el creador de la clave, con su rol y su presupuesto, igual que en la consola (guía del servidor MCP).

Someter las fusiones al control en CI

Tu flujo de trabajo de GitHub Actions puede preguntar directamente al control de publicación y fallar cuando deniega el pull request:

- name: Ask the AI CodeOps 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

Convierte el job en una comprobación de estado obligatoria en la protección de ramas y un pull request solo se fusionará con un veredicto de permitido. Eso incluye los pull requests del agente en la nube de Copilot, que el control deniega porque no los hizo ninguna sesión de AI CodeOps; úsalo en las ramas en las que AI CodeOps deba ser el camino hacia la fusión. Los campos, incluidos un mínimo de cobertura y las licencias no permitidas, están en la página de la API.

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 Copilot 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 GitHub y crea un proyecto, con la guía de inicio rápido.
  3. Crea una clave de API y añade el servidor a VS Code o al agente en la nube como se indica arriba.

¿Quieres comparar en lugar de combinar? Lee AI CodeOps vs. la revisión de código de GitHub Copilot y AI CodeOps vs. el agente de programación de GitHub Copilot.

Preguntas frecuentes

¿AI CodeOps revisa los pull requests que abre el agente en la nube de Copilot?

No. AI CodeOps somete a sus controles los cambios hechos en sus propias sesiones. Un pull request de Copilot 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 configuro MCP para el agente en la nube de Copilot?

En Settings del repositorio, en Copilot y después MCP servers. Los secretos que usa la configuración deben ser secretos de Agents cuyos nombres empiecen por COPILOT_MCP_.

¿Qué herramientas de AI CodeOps debería recibir el agente en la nube?

La configuración del agente en la nube admite una lista de herramientas permitidas. Empieza con las herramientas de lectura, como check_release_gate y list_findings, y añade start_session solo si quieres que Copilot pase tareas a AI CodeOps.

¿El servidor de AI CodeOps necesita OAuth?

No. Admite una clave de API del espacio de trabajo en una cabecera Authorization Bearer, que es lo que admiten tanto VS Code como el agente en la nube de Copilot. GitHub dice que el agente en la nube no admite servidores remotos que usen OAuth.