GitLab MCP Server

Conecta tu asistente de IA a GitLab con hasta 1011 herramientas mediante el Model Context Protocol

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
32/47/48 Meta-herramientas	Herramientas agrupadas por dominio que cubren proyectos, issues, merge requests, pipelines, CI/CD, wikis, releases, Orbit y más
Conjunto dinámico	Modo opcional de bajo consumo con 3 herramientas: buscar en el catálogo canónico, describir schemas exactos y ejecutar acciones canónicas
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 información de proyectos, perfiles de usuario, configuración del servidor y esquemas de meta-tools
38 Prompts MCP	Plantillas de prompts predefinidas para informes, auditorías, 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: 15 meta-herramientas 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.

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, describir 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