Ir al contenido

GitLab MCP Server

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ísticaDetalles
42+ Meta-herramientasHerramientas agrupadas por dominio que cubren proyectos, issues, merge requests, pipelines, CI/CD, wikis, releases y más
11 Herramientas de análisisAná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
24 Recursos MCPEndpoints de datos de solo lectura para información de proyectos, perfiles de usuario, configuración del servidor
38 Prompts MCPPlantillas de prompts predefinidas para informes, auditorías, 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 Enterprise15 herramientas adicionales opcionales para funciones de GitLab Premium/Ultimate (métricas DORA, vulnerabilidades, cumplimiento)
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.

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

Proyectos y código

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

Merge Requests y revisión de código

  • “Muestra los merge requests abiertos en my-app”
  • “Resume los cambios del MR !42”
  • “¿Es seguro mergear el MR !15? Revisa problemas de seguridad”

Issues y planificación

  • “Lista los issues abiertos asignados a mí”
  • “Crea un bug report titulado ‘Arreglar página de login’ con etiqueta ‘bug’”
  • “¿Cuál es el progreso del milestone v2.0?”

CI/CD y Pipelines

  • “¿Cuál es el estado del último pipeline de my-app?”
  • “¿Por qué falló el último pipeline?”
  • “Muestra las variables CI del proyecto my-app”

Informes y análisis

  • “Genera notas de release de v1.0 a v2.0”
  • “Dame un resumen de standup diario”
  • “Evalúa el riesgo del merge request !23”
graph LR
    A[Tú] -->|lenguaje natural| B[Cliente IA]
    B -->|protocolo MCP| C[GitLab MCP Server]
    C -->|REST API v4| 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 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