Volver al blog
IASeguridadClaude Code

GitLab 19.6 pone límites reales a las herramientas MCP

GitLab ya puede auditar llamadas MCP y bloquear herramientas desde el servidor, incluso cuando el cliente no coopera.

Por Isma6 min de lectura

El problema no está solo en el prompt

Conectar Claude Code o Cursor a GitLab mediante MCP es útil: el agente puede consultar incidencias, revisar merge requests o trabajar con el contexto real del proyecto Laravel. El problema aparece cuando esa conexión también expone acciones de escritura o borrado y la seguridad depende por completo de que el cliente pida permiso. Si el cliente interpreta mal una política, tiene una versión antigua o simplemente decide no mostrar la confirmación, el control se queda en una recomendación.

GitLab 19.6 añade una pieza que faltaba en este escenario: la gobernanza de herramientas del servidor MCP se puede aplicar en el propio GitLab. No es una norma que el agente tenga que obedecer voluntariamente, sino una comprobación antes de ejecutar la llamada. Para quien mantiene una instancia autoalojada, esa diferencia importa bastante más que cualquier ajuste de prompt.

Auditoría para saber qué hizo el agente

Cada acción realizada a través del servidor MCP de GitLab genera ahora un evento de auditoría. El registro permite distinguir las acciones procedentes del MCP server de las realizadas directamente por una persona y conserva quién ejecutó la acción, qué hizo, sobre qué recurso y cuándo ocurrió. En un grupo de nivel superior, estos eventos se consultan desde AI > Governance en la pestaña de auditoría.

Esto no convierte a un agente en seguro por arte de magia, pero sí elimina una zona ciega habitual. Si Claude Code abre una incidencia, añade una nota o intenta operar sobre un merge request, hay trazabilidad sin tener que instalar un sistema paralelo de telemetría en cada portátil. En equipos pequeños y homelabs donde una misma persona administra GitLab, runners y servicios, tener ese registro centralizado simplifica mucho investigar una acción inesperada.

Tres modos para cada herramienta

En AI > Governance, GitLab permite asignar a cada herramienta uno de tres modos: Always Allow, Always Ask o Always Deny. Las reglas se pueden definir en el grupo de nivel superior y, cuando hace falta, concretarse por proyecto. Una regla de proyecto prevalece sobre la del grupo, pero solo puede ser igual de restrictiva o más restrictiva.

Always Allow deja que la herramienta se ejecute sin pedir confirmación. Always Ask indica que la acción necesita aprobación, mientras que Always Deny oculta la herramienta al agente y bloquea su ejecución. Las herramientas se clasifican como lectura, escritura o borrado, y la matriz predeterminada deja las lecturas permitidas y pide confirmación para escritura y borrado.

La parte relevante para Claude Code, Cursor y otros clientes MCP externos es que GitLab aplica Always Deny desde el servidor. Aunque un cliente intente llamar directamente a una herramienta denegada, GitLab rechaza la llamada antes de que se ejecute. El resultado vuelve como un error de ejecución de herramienta, así que no depende de que el cliente haya ocultado correctamente el botón o haya respetado una instrucción.

Una configuración mínima para Claude Code

La conexión directa de Claude Code con un GitLab autoalojado usa transporte HTTP y el endpoint MCP de la instancia. Este comando añade el servidor para el usuario actual y limita además los grupos de herramientas que el servidor devuelve al cliente. Limitar toolsets no reemplaza las reglas de gobernanza, pero reduce la superficie que el agente recibe desde el principio.

claude mcp add -s user --transport http GitLab https://gitlab.example.com/api/v4/mcp \
  --header "X-Gitlab-Enabled-Mcp-Server-Toolsets: core,work_items"

Después de conectarlo, configuraría las reglas desde la interfaz de GitLab, no desde el archivo local de Claude Code. Para un grupo con varios repos Laravel, mi punto de partida sería permitir las consultas necesarias, pedir confirmación en acciones que escriben y denegar las herramientas que borren recursos o creen cambios fuera del flujo habitual. Si un proyecto contiene infraestructura, credenciales o automatizaciones del homelab, merece reglas más estrictas que una aplicación de pruebas.

La letra pequeña de Always Ask

Aquí está el matiz que conviene no pasar por alto: Always Ask no se impone en el servidor para clientes MCP de terceros. GitLab anota la herramienta para que el cliente pida confirmación, pero es el cliente quien decide si muestra y respeta esa aprobación. La documentación indica que Claude Code 2.1.199 o posterior solicita confirmación, mientras que Cursor, Windsurf y otros clientes pueden ejecutar la herramienta sin mostrar ese aviso.

Por eso no usaría Always Ask como barrera de seguridad frente a un cliente externo. Es útil como fricción operativa cuando controlas el cliente y quieres revisar cambios antes de aceptarlos. Si necesito garantizar que una herramienta no se ejecutará desde Claude Code, Cursor o cualquier otro cliente, la opción correcta es Always Deny.

Tampoco es un bloqueo absoluto

Always Deny se evalúa contra el grupo o proyecto indicado en los argumentos de la herramienta. Una herramienta que no actúe sobre un proyecto o grupo, como get_mcp_server_version, no se puede gobernar de esa manera y siempre se ejecuta. Además, GitLab deja claro que estas reglas son una capa adicional y no sustituyen a los permisos normales de GitLab.

Hay otro detalle práctico: si un cliente no envía la cabecera X-Gitlab-Namespace-Id, la lista de herramientas puede construirse usando el espacio de nombres predeterminado de GitLab Duo o quedar sin filtrar si no existe uno. Eso no elimina la protección al ejecutar una llamada denegada, pero puede hacer que el cliente vea herramientas que después fallarán. Conviene configurar bien el contexto del grupo y probar la integración con la cuenta y los proyectos reales que vaya a usar cada desarrollador.

También hay una incidencia conocida con las herramientas de búsqueda. Denegar la herramienta agregada search no basta necesariamente para eliminar todas las búsquedas, porque GitLab puede volver a exponer herramientas más específicas. Si la intención es impedir búsquedas de incidencias, blobs o merge requests, hay que revisar las reglas de esas herramientas concretas y validar el resultado con una sesión MCP real.

Una barrera que sí está donde debe estar

Lo que cambia en GitLab 19.6 no es que MCP deje de requerir prudencia. Sigue habiendo que limitar permisos, tratar el contenido de tickets y repositorios como posible vector de prompt injection, y separar proyectos sensibles de los que usas para experimentar. Pero ahora una decisión de denegación puede vivir en el servidor que protege los datos, no en la configuración local de cada agente.

Para mí, ese es el uso razonable: conectar agentes a GitLab para acelerar tareas repetitivas, pero decidir desde la instancia qué pueden leer, qué deben confirmar y qué no pueden ejecutar. La auditoría añade contexto cuando algo sale mal; Always Deny añade una frontera técnica cuando no basta con confiar en el cliente.


Fuente: GitLab 19.6 release notes

Documentación oficial: Agent tool governance · GitLab MCP server

Newsletter

Lo que aprendo programando con IA, cada dos semanas en tu correo.

Cifras reales, errores incluidos. Sin spam y te das de baja con un clic.

Sin spam y te das de baja con un clic. Uso tu correo solo para enviarte esto y la newsletter. Más en la política de privacidad.