Ir al contenido

GitLab MCP Server

Conecta tu asistente de IA a GitLab con hasta 1033 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.

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í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) |

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?

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ó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” |

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