# Servidores MCP

> Conecta servidores MCP remotos para que los agentes de AI CodeOps llamen a sus herramientas: añade un servidor, mantén cifradas sus cabeceras y limita las herramientas por agente y por política.

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

El Model Context Protocol (MCP) permite que un agente de IA llame a herramientas de otro servicio, como un gestor de incidencias o un buscador de documentación. En AI CodeOps, conectas servidores MCP a tu espacio de trabajo y los agentes de tus sesiones pueden usar sus herramientas.

Aquí AI CodeOps es el cliente: se conecta **a** los servidores MCP que añades. Para usar AI CodeOps desde tu propio asistente de programación, consulta [el servidor MCP de AI CodeOps](https://aicodeops.dev/es/docs/mcp-server).

La compatibilidad con MCP está en beta.

## Servidores remotos y locales

| Tipo                      | Qué introduces                           | ¿Lo usan las sesiones?                                 |
| ------------------------- | ---------------------------------------- | ------------------------------------------------------ |
| **Remote (HTTP/SSE URL)** | La URL del servidor y las cabeceras HTTP | Sí                                                     |
| **Local (stdio command)** | Un comando y variables de entorno        | No. Queda registrado, pero las sesiones no lo inician. |

Las sesiones se ejecutan en la plataforma, no en tu equipo, así que no pueden iniciar un programa en tu máquina. Usa un servidor remoto para todo lo que deban llamar tus agentes.

Los servidores remotos deben:

- estar en una dirección HTTPS pública (las redes privadas y `localhost` se rechazan);
- usar el transporte **Streamable HTTP** de MCP (JSON-RPC sobre POST, con una respuesta JSON o de flujo de eventos);
- aceptar la autenticación en cabeceras estáticas, como un token bearer. Los servidores que necesitan un inicio de sesión con OAuth todavía no son compatibles, y tampoco lo es el transporte antiguo, solo SSE.

## Añadir un servidor

1. Abre **Configure → MCP Servers** y elige **Add MCP server**.
2. Introduce un **Name**, por ejemplo "GitHub". AI CodeOps forma con él el ID del servidor, en minúsculas y con guiones: "GitHub" se convierte en `github`, "Docs Search" se convierte en `docs-search`. Los nombres de las herramientas y las reglas de política usan este ID.
3. Elige **Remote (HTTP/SSE URL)** e introduce la **Server URL**.
4. En **Headers**, añade un `KEY=value` por línea, por ejemplo:

   ```text
   Authorization=Bearer <your token>
   ```

5. Elige **Save MCP server**.

El servidor aparece en **Servers** con **Disable** y **Remove**. Todavía no hay formulario de edición: para cambiar un servidor, quítalo y añádelo de nuevo.

Gestionar servidores MCP requiere el permiso MCP-manage: por defecto lo tienen los roles Owner, Admin y DevOps Admin.

## Cómo se guardan los secretos

Las cabeceras (remotos) y las variables de entorno (locales) se cifran en reposo con AES-256-GCM. Nunca se devuelven al navegador; la lista solo muestra qué claves están definidas, como "1 header: Authorization". Solo se descifran cuando una sesión se conecta al servidor. Añadir, cambiar, activar, desactivar y eliminar un servidor se anota en el [registro de auditoría](https://aicodeops.dev/es/docs/audit-logs).

## Cómo reciben los agentes las herramientas

Cuando se lanza una sesión, AI CodeOps se conecta a cada servidor remoto habilitado y lista sus herramientas. Un servidor al que no se puede llegar se omite, y la sesión se ejecuta sin sus herramientas.

- Las herramientas se llaman `<server>__<tool>`, por ejemplo `github__create_issue`.
- Una sesión puede ofrecer hasta 32 herramientas MCP en total.
- En cada paso de agente, un agente puede hacer hasta 6 rondas de llamadas a herramientas.
- Cada llamada agota el tiempo a los 30 segundos, y los resultados largos se acortan.

Puedes restringir qué herramientas llegan a los agentes de dos formas.

### Por agente

En **Configure → Agents**, un agente personalizado tiene una opción **MCP tools this agent may use**: **None** (el valor por defecto de un agente nuevo), **Only the tools listed** o **All tools the workspace allows**. Para una lista, introduce servidores, herramientas o nombres `server__tool`, separados por comas. Un agente guardado antes de que existiera esta opción conserva todas las herramientas hasta que la cambies.

### Por la política del espacio de trabajo

Una [regla de política](https://aicodeops.dev/es/docs/policy-engine) sobre la acción `mcp.invoke` coincide con `server/tool`. Una herramienta que la política no permite nunca se ofrece a los agentes. Por ejemplo, para mantener lejos de tus sesiones todas las herramientas de borrado del servidor GitHub:

```json
{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
```

Las reglas `mcp.invoke` pueden usar `allow` o `deny`, no `ask`. Con el ajuste de confianza **None**, las herramientas MCP se deniegan salvo que una regla las permita.

## Solución de problemas

Si una sesión no usa las herramientas de un servidor:

- Comprueba que el servidor está habilitado y es un servidor **Remote**.
- Comprueba que la URL es HTTPS pública y que el servidor admite Streamable HTTP, no solo SSE.
- Comprueba las cabeceras: un token caducado hace que el servidor rechace la conexión.
- Comprueba el campo **MCP tools allowed** del agente personalizado y la política de tu espacio de trabajo.

## Siguientes pasos

- [Agentes y flujos de trabajo](https://aicodeops.dev/es/docs/agents)
- [Referencia de las reglas de política](https://aicodeops.dev/es/docs/policy-engine)
- [Auditoría de dependencias](https://aicodeops.dev/es/docs/dependency-audit)

## Preguntas frecuentes

### ¿AI CodeOps es él mismo un servidor MCP?

Sí, aparte de lo que cubre esta página. Su servidor MCP permite que Claude Code, Cursor u otro cliente MCP use tu espacio de trabajo; consulta la guía del servidor MCP de AI CodeOps. Esta página trata del otro sentido, los servidores a los que se conectan tus sesiones.

### ¿Las sesiones inician servidores MCP locales (stdio)?

No. Puedes registrar un servidor local, pero las sesiones solo se conectan a servidores remotos por HTTPS.

### ¿Puedo ver una cabecera después de guardarla?

No. Las cabeceras y las variables de entorno se cifran en reposo y no se vuelven a mostrar. La lista solo muestra qué claves están definidas.
