AI CodeOps

Servidores MCP

Última actualización

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.

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.

La compatibilidad con MCP está en beta.

Servidores remotos y locales

TipoQué introduces¿Lo usan las sesiones?
Remote (HTTP/SSE URL)La URL del servidor y las cabeceras HTTPSí
Local (stdio command)Un comando y variables de entornoNo. 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:
    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.

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

{ "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

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.

¿Te resultó útil esta página?