# El servidor MCP de AI CodeOps

> 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.

Fuente: https://aicodeops.dev/es/docs/mcp-server · Última actualización: 2026-10-21

AI CodeOps ejecuta un servidor [MCP](https://modelcontextprotocol.io) 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](https://aicodeops.dev/es/docs/mcp-servers), 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](https://aicodeops.dev/es/docs/api#workspace-api-keys).

**Claude Code:**

```bash
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`:

```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

| Herramienta          | Qué hace                                                                                                                                                 | La clave necesita      |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| `list_projects`      | Lista los proyectos del espacio de trabajo y sus repositorios.                                                                                           | `workspace:read`       |
| `start_session`      | Lanza 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_session`        | El estado de una sesión, sus pasos, el pull request que abrió y su cambio.                                                                               | `workspace:read`       |
| `check_release_gate` | Si un pull request o un commit puede entregarse, con los motivos. La misma comprobación que [la API](https://aicodeops.dev/es/docs/api#release-gate-check).                      | `workspace:read`       |
| `list_findings`      | Hallazgos de seguridad y de calidad, filtrados por `severity` o por `category`.                                                                          | `workspace:read`       |
| `get_evidence_pack`  | El [paquete de evidencias](https://aicodeops.dev/es/docs/evidence-packs) firmado de un cambio, por `changeID` o por la sesión que lo inició.                                     | `workspace:audit.read` |
| `list_builds`        | Builds 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_build`          | Un build: el paso en el que falló y el final de su salida, para ver por qué falló.                                                                       | `workspace:read`       |
| `list_saved_builds`  | Los 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](https://aicodeops.dev/es/docs/audit-logs).

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.
