Ir al contenido

GitLab MCP Server

Conecta tu asistente de IA con GitLab para revisar merge requests, diagnosticar pipelines, gestionar incidencias y redactar releases — en lenguaje natural. Más de 1000 herramientas sobre la API REST + GraphQL completa.

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.

Expone más de 1000 operaciones de GitLab como herramientas MCP — 847 en Community Edition y hasta 1071 en GitLab.com — en tres modos de herramientas: una superficie dinámica de bajo consumo (2 herramientas), 32 meta-herramientas de dominio, o una herramienta por operación. Se distribuye como un único binario de Go para Linux, macOS y Windows, y se ejecuta localmente por stdio o como servicio HTTP compartido. Gratuito y de código abierto bajo licencia MIT.

GitLab MCP Server permite que tu asistente de IA ejecute tareas de GitLab por ti — consultar, crear y actualizar recursos directamente desde un prompt de chat. 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ísticaDetalles
Conjunto dinámicoModo predeterminado de bajo consumo con 2 herramientas: encontrar acciones canónicas con schemas exactos y ejecutar acciones canónicas
32/49/50 Meta-herramientasModo opcional por dominio que cubre proyectos, issues, merge requests, pipelines, CI/CD, wikis, releases, Orbit y más
45 Recursos MCPEndpoints 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 MCPPlantillas de prompts predefinidas para informes, auditorías, calidad de flujo Git, análisis entre proyectos y flujos de trabajo en equipo
Modo HTTP multiusuarioDespliega como servidor compartido con aislamiento por token para entornos de equipo
GitLab CE y EECompatible con Community Edition y Enterprise Edition, incluyendo instancias autoalojadas
Herramientas EnterpriseCatálogo Premium/Ultimate opcional: 16 meta-herramientas adicionales autoalojadas, más Orbit Knowledge Graph solo en GitLab.com
AutoactualizaciónMecanismo de autoactualización integrado — ejecuta siempre la última versión
MultiplataformaBinario único para Linux, macOS y Windows (amd64 y arm64)

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:

MRTítuloAutorAsignadoPipeline
!142Add rate limiting middleware@alice@bob✅ exitoso
!139Fix N+1 query in /users@charlie@alice❌ fallido
!137Update OpenAPI spec@bob⏳ en ejecución

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

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.

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

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”
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).

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

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.

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.

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?

Sección titulada «¿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.