GitLab MCP Server
La configuración por defecto cuesta 10.359 tokens de contexto en todos los tiers de GitLab; 1694 con GITLAB_MCP_CAPABILITY_SURFACE=minimal. Medido, no estimado.
Qué es
GitLab MCP Server es un servidor Model Context Protocol, escrito en Go, que permite a un asistente de IA trabajar tu GitLab por ti: revisar merge requests, triar pipelines, gestionar issues, redactar releases. Cubre las APIs REST v4 y GraphQL y funciona contra GitLab.com o cualquier instancia autoalojada, Community o Enterprise Edition.
Tú hablas con tu asistente, no con las herramientas. Un único catálogo canónico de acciones se proyecta en tres superficies de tools, de modo que las mismas operaciones sirven a un cliente de contexto reducido, a uno de tools por dominio o a uno con una tool por operación — y el asistente toma los argumentos de esquemas tipados, no de prosa.
Se distribuye como un binario estático (o un contenedor) para Linux, macOS y Windows, hablando stdio para un cliente local o HTTP para un despliegue compartido multiusuario.
Para quién es
- Quien revisa merge requests y prefiere pedir el diff arriesgado en una frase antes que abrir seis pestañas.
- Quien ya usa un cliente MCP — Claude Code, Claude Desktop, Cursor, VS Code o su propio agente.
- Equipos con GitLab autoalojado, Community Edition incluida: las tools con tier se registran solo cuando la licencia de la instancia las cubre.
- Operadores que quieren un único endpoint HTTP compartido con aislamiento por token en lugar de un binario por portátil.
Qué no es
- No es una forma de saltarse tus permisos. Cada llamada se hace con tu token, y lo que sus scopes y la licencia de tu instancia prohíben sigue prohibido.
- No es un producto oficial de GitLab. Habla con las APIs documentadas de GitLab y lo dice; GitLab es una marca de GitLab Inc.
- No está obligado a escribir. El modo de solo lectura elimina toda acción mutadora, y el modo seguro convierte cada una en una vista previa en lugar de una ejecución.
- No es una caja negra. Cada cifra de esta página se genera desde el catálogo, y el comportamiento de cara al modelo se mide con una suite de evaluación real.
Cómo se ve en uso
Un comando para conectarlo; frases normales después.
Conéctalo a Claude Code
Docker lo deja en cero instalación; un binario nativo funciona igual. El token nunca va en la línea de registro: el contenedor lo toma del entorno, y un binario nativo además lee ~/.gitlab-mcp-server.env. Otros clientes usan el mismo servidor por stdio o HTTP.
export GITLAB_TOKEN=glpat-xxxxclaude mcp add gitlab --env GITLAB_URL=https://gitlab.example.com --transport stdio \ -- docker run -i --rm -e GITLAB_URL -e GITLAB_TOKEN \ ghcr.io/jmrplens/gitlab-mcp-server:latestY después, solo pide
El asistente elige la tool y los argumentos; el servidor devuelve JSON estructurado para el modelo y Markdown formateado para ti.
| Tú dices | El servidor hace |
|---|---|
«Muéstrame los merge requests abiertos de my-org/backend pendientes de revisión» | Lista los MRs con autores, asignados y estado del pipeline, en una tabla con enlaces. |
«¿Por qué falló el pipeline de feature/auth?» | Encuentra el job fallido, lee su log y resume el error con una propuesta de arreglo. |
| «Crea un bug P1 para la regresión de auth y asígnaselo a @alice» | Crea la issue con etiquetas y asignación — o, en modo seguro, muestra la llamada exacta que haría. |
| «Redacta las notas de la release v2.1.0 contra v2.0.0» | Compara los tags, agrupa commits y merge requests, y redacta el changelog. |
Un catálogo, tres superficies
Cada operación vive una sola vez, en un catálogo canónico de acciones, y se proyecta en la superficie que encaja con el presupuesto de contexto de tu cliente. Las cifras se generan desde el catálogo, nunca se escriben a mano.
| Superficie | Tools | Cuándo usarla |
|---|---|---|
| Dinámicafind_action + execute_action — la opción por defecto | 2 | La huella de contexto más pequeña: el asistente busca en el catálogo, lee el esquema exacto y ejecuta la acción canónica. |
| Meta-toolsun despachador por dominio | 34–52 | Una tool visible por dominio (proyectos, issues, MRs, pipelines…) con acciones enrutadas dentro — el punto medio. |
| Individualuna tool por operación | 866–1091 | Todo visible a la vez, para clientes que prefieren una lista plana y tienen contexto para sostenerla. |
Los rangos recorren el tier de la instancia: el límite inferior es Free/CE y el superior, GitLab.com Ultimate con Orbit. Las tools Premium y Ultimate se registran solo cuando la licencia de la instancia conectada las cubre.
Empieza aquí
Tres pasos entre la nada y un asistente con las manos en GitLab.
Instala
Docker, Homebrew, winget, un binario de release o la extensión de Claude Desktop — elige lo que le guste a tu máquina.
Primeros pasosApúntalo a GitLab
Un token de acceso personal y la URL de tu instancia son toda la configuración. Ambos van en ~/.gitlab-mcp-server.env, que el servidor lee para lo que su entorno no traiga ya.
Configuración del clienteGITLAB_URL=https://gitlab.example.comGITLAB_TOKEN=glpat-xxxxElige superficie
La dinámica por defecto encaja en cualquier cliente. ¿Prefieres tools por dominio o una por operación? Una variable de entorno cambia la superficie.
Superficies de toolsGITLAB_MCP_TOOL_SURFACE=dynamic|meta|individual
Preguntas frecuentes
¿Qué es GitLab MCP Server?
GitLab MCP Server es un servidor Model Context Protocol, libre y de código abierto, que permite a los asistentes de IA interactuar con GitLab mediante lenguaje natural. Expone las APIs REST v4 y GraphQL de GitLab como herramientas MCP, de modo que un asistente puede revisar merge requests, diagnosticar pipelines, gestionar incidencias y redactar releases por ti. Se distribuye como un único binario de Go y se ejecuta localmente por stdio o de forma remota por HTTP.
¿Con qué asistentes de IA funciona?
Funciona con cualquier cliente compatible con MCP — incluidos VS Code con GitHub Copilot, Claude Desktop, Cursor y Claude Code, además de cualquier otro cliente que hable el Model Context Protocol por transporte stdio o HTTP. La configuración es un pequeño fragmento JSON por cliente.
¿Es gratuito y de código abierto?
Sí. GitLab MCP Server es gratuito y de código abierto bajo la licencia MIT, con todo el código fuente en GitHub. No existe una versión de pago del servidor; las funciones de GitLab Premium o Ultimate dependen únicamente de la licencia de tu propia instancia de GitLab, no del servidor MCP.
¿Funciona con GitLab autoalojado y Community Edition?
Sí. Funciona con GitLab.com y con instancias autoalojadas, y tanto con Community Edition como con Enterprise Edition. Apúntalo a cualquier URL de GitLab con un token de acceso personal. Las herramientas Premium y Ultimate se registran solo cuando la instancia conectada tiene la licencia correspondiente.