GitLab MCP Server

Hasta 1045 herramientas individuales en GitLab.com Enterprise/Premium (1039 auto-gestionado), consolidadas en 33 meta-herramientas base mediante el Model Context Protocol

Primeros pasos Ver en GitHub

GitLab MCP Server es un servidor Model Context Protocol que permite a los asistentes de IA interactuar con GitLab a través de lenguaje natural. Pide a tu IA que cree issues, revise merge requests, analice pipelines y mucho más — todo sin salir de tu editor.

¿Qué puede hacer?

En lugar de alternar entre tu editor y la interfaz web de GitLab, simplemente pregunta:

Muéstrame todas las merge requests abiertas en my-project que necesitan revisión

¿Por qué falló el pipeline en la rama feature/auth? Resume el error y sugiere una solución

Crea un issue titulado "Refactorizar módulo de auth" con etiqueta de prioridad y asígnamelo

El servidor traduce estas solicitudes en llamadas a la API de GitLab, las ejecuta y devuelve resultados estructurados que tu asistente de IA puede entender y sobre los que puede actuar.

Características principales

Característica	Detalles
Conjunto dinámico	Modo predeterminado de bajo consumo con 2 herramientas: encontrar acciones canónicas con schemas exactos y ejecutar acciones canónicas
33/49/50 Meta-herramientas	Modo opcional por dominio que cubre proyectos, issues, merge requests, pipelines, CI/CD, wikis, releases, Orbit y más
11 Herramientas de análisis	Análisis impulsado por IA mediante MCP sampling — diagnóstico de fallos en pipelines, revisión de seguridad de MRs, detección de deuda técnica
46 Recursos MCP	Endpoints de datos de solo lectura para proyectos, perfiles de usuario, guías de flujo y el manifiesto `gitlab://tools` adaptado a la superficie
37 Prompts MCP	Plantillas de prompts predefinidas para informes, auditorías, calidad de flujo Git, análisis entre proyectos y flujos de trabajo en equipo
Modo HTTP multiusuario	Despliega como servidor compartido con aislamiento por token para entornos de equipo
GitLab CE y EE	Compatible con Community Edition y Enterprise Edition, incluyendo instancias autoalojadas
Herramientas Enterprise	Catálogo Premium/Ultimate opcional: 16 meta-herramientas adicionales autoalojadas, más Orbit Knowledge Graph solo en GitLab.com
Autoactualización	Mecanismo de autoactualización integrado — ejecuta siempre la última versión
Multiplataforma	Binario único para Linux, macOS y Windows (amd64 y arm64)

Ejemplo rápido

Tú: “¿Qué merge requests están abiertas en my-org/backend y quién está asignado?”

Asistente de IA (mediante GitLab MCP Server):

Se encontraron 3 merge requests abiertas en my-org/backend:

MR Título Autor Asignado Pipeline
!142 Add rate limiting middleware @alice @bob ✅ exitoso
!139 Fix N+1 query in /users @charlie @alice ❌ fallido
!137 Update OpenAPI spec @bob — ⏳ en ejecución

!139 tiene un pipeline fallido — ¿quieres que analice el fallo?

MR	Título	Autor	Asignado	Pipeline
!142	Add rate limiting middleware	@alice	@bob	✅ exitoso
!139	Fix N+1 query in /users	@charlie	@alice	❌ fallido
!137	Update OpenAPI spec	@bob	—	⏳ en ejecución

Tú: “Sí, comprueba por qué falló !139”

Asistente de IA:

El pipeline #8847 falló en la etapa test, job unit-tests:
FAIL: TestUserService_ListUsers — expected 10 results, got 15
La corrección del N+1 cambió la consulta para devolver todos los resultados sin aplicar el límite de paginación predeterminado. Solución sugerida: Añadir .Limit(defaultPageSize) a la consulta en user_repository.go:87.

Sin vs con GitLab MCP Server

Flujo de trabajo	❌ Sin	✅ Con GitLab MCP Server
Revisión de código	Cambiar a la UI de GitLab, leer diffs y comentar a mano	”Revisa la seguridad del MR !142 y deja comentarios”
Depuración de pipelines	Abrir logs, rastrear jobs fallidos y buscar errores	”¿Por qué falló el pipeline de feature/auth?”
Gestión de issues	Navegar a Issues, rellenar formularios y asignar etiquetas	”Crea un bug P1 por la regresión de auth y asígnalo a @alice”
Notas de release	Leer cada commit desde el último tag y redactar changelog	”Genera notas de release para v2.1.0 vs v2.0.0”
Resumen de proyecto	Abrir varias pestañas: MRs, issues, pipelines, milestones	”Dame un informe de estado de my-org/backend”

Ejemplos de prompts

Prueba estos con tu asistente de IA una vez conectado GitLab MCP Server:

“Lista mis proyectos de GitLab” - “Muestra el README del proyecto my-app” - “Busca comentarios TODO en el código”

Comenzar

Primeros pasos Instala el binario y conéctalo a tu primer cliente de IA en minutos

Asistente de configuración Configura clientes stdio con el asistente Web, TUI o CLI

Arquitectura Comprende cómo el servidor conecta los asistentes de IA con GitLab

Configuración Variables de entorno, configuraciones de clientes y opciones de despliegue

Referencia de herramientas Explora todas las herramientas MCP disponibles por dominio

Conjunto dinámico Usa el modo de bajo consumo para buscar y ejecutar

Cómo funciona

graph LR
    A[Tú] -->|lenguaje natural| B[Cliente IA]
    B -->|protocolo MCP| C[GitLab MCP Server]
    C -->|REST v4 + GraphQL| D[Instancia GitLab]
    D -->|respuesta JSON| C
    C -->|resultado estructurado| B
    B -->|respuesta formateada| A

El servidor actúa como puente: tu cliente de IA envía llamadas a herramientas a través del protocolo MCP, el servidor las traduce en peticiones a la API REST v4 o GraphQL de GitLab y devuelve los resultados tanto en JSON estructurado (para la IA) como en Markdown formateado (para ti).

Clientes de IA compatibles

GitLab MCP Server funciona con cualquier cliente compatible con MCP:

VS Code + GitHub Copilot — mediante configuración mcp.json
Claude Desktop — mediante claude_desktop_config.json
Cursor — mediante .cursor/mcp.json
Claude Code — mediante claude code mcp add
Cualquier cliente MCP — transporte stdio o HTTP