Compatibilidad
Compatibilidad con ediciones de GitLab
Sección titulada «Compatibilidad con ediciones de GitLab»GitLab MCP Server funciona tanto con Community Edition (CE) como con Enterprise Edition (EE). El catálogo Enterprise/Premium desbloquea 16 meta-herramientas adicionales exclusivas de Enterprise: establece GITLAB_TIER=premium (o GITLAB_TIER=ultimate) en modo stdio, usa --tier=premium/--tier=ultimate en modo HTTP, o confía en la autodetección desde GET /license (por defecto free). Los flags heredados GITLAB_ENTERPRISE=true (stdio) y --enterprise (HTTP) siguen respetándose por compatibilidad, pero están deprecados.
| Funcionalidad | Community (CE) | Enterprise (EE) |
|---|---|---|
| Proyectos, Issues, MRs, Pipelines, CI/CD | ✅ | ✅ |
| Wikis, Etiquetas, Hitos, Releases | ✅ | ✅ |
| Usuarios, Grupos, Miembros, Búsqueda | ✅ | ✅ |
| Despliegues, Entornos, Paquetes | ✅ | ✅ |
| 32 meta-herramientas base | ✅ | ✅ |
| 45 recursos, 37 prompts | ✅ | ✅ |
| Merge Trains | ❌ | ✅ |
| Métricas DORA | ❌ | ✅ |
| Gestión de vulnerabilidades | ❌ | ✅ |
| Eventos de auditoría | ❌ | ✅ |
| Políticas de cumplimiento | ❌ | ✅ |
| +16 meta-herramientas enterprise | ❌ | ✅ |
Para habilitar funcionalidades enterprise en modo stdio, establece GITLAB_TIER=premium o GITLAB_TIER=ultimate. En modo HTTP, configura --tier=premium/--tier=ultimate para forzar el catálogo Enterprise/Premium, u omítelo para que el servidor autodetecte CE/EE por entrada token+URL cuando GitLab informe la edición. Los flags heredados GITLAB_ENTERPRISE=true (stdio) y --enterprise (HTTP) siguen respetándose por compatibilidad.
Soporte de plataformas
Sección titulada «Soporte de plataformas»Hay binarios precompilados disponibles para todas las plataformas principales:
| SO | Arquitectura | Binario |
|---|---|---|
| Linux | amd64 | gitlab-mcp-server-linux-amd64 |
| Linux | arm64 | gitlab-mcp-server-linux-arm64 |
| macOS | amd64 (Intel) | gitlab-mcp-server-darwin-amd64 |
| macOS | arm64 (Apple Silicon) | gitlab-mcp-server-darwin-arm64 |
| Windows | amd64 | gitlab-mcp-server-windows-amd64.exe |
| Windows | arm64 | gitlab-mcp-server-windows-arm64.exe |
Compatibilidad con clientes MCP
Sección titulada «Compatibilidad con clientes MCP»Cualquier cliente que soporte el transporte stdio del Model Context Protocol puede usar este servidor. Clientes probados:
| Cliente | Transporte | Estado |
|---|---|---|
| VS Code + GitHub Copilot | stdio | ✅ |
| Claude Desktop | stdio | ✅ |
| Cursor | stdio | ✅ |
| Claude Code (CLI) | stdio | ✅ |
| Windsurf | stdio | ✅ |
| JetBrains IDEs | stdio | ✅ |
| Zed | stdio | ✅ |
| Kiro | stdio | ✅ |
| OpenAI Codex | stdio | ✅ |
| Cualquier cliente Streamable HTTP | HTTP | ✅ |
Perfiles de compatibilidad por cliente
Sección titulada «Perfiles de compatibilidad por cliente»La mayoría de los clientes ignoran los campos MCP que no entienden, así que el servidor envía su superficie completa a todos. La única excepción se gestiona automáticamente: las builds de Codex incluidas en ChatGPT.app rechazan resultados cuyas anotaciones de contenido llevan un valor priority fraccionario, de modo que cuando una sesión se identifica como Codex el servidor redondea esas prioridades al entero válido más cercano según la especificación. Todo lo demás — anotaciones de audiencia, contenido estructurado, esquemas de salida, iconos — se entrega sin cambios, y ningún otro cliente se ve afectado. Configura CLIENT_COMPAT=off para desactivar la reescritura.
Para Codex, añade el servidor a ~/.codex/config.toml con pre-aprobación de herramientas — sin ella, Codex pide confirmación en cada herramienta que no sea de solo lectura, y las ejecuciones no interactivas de codex exec cancelan esas llamadas:
[mcp_servers.gitlab]command = "/ruta/a/gitlab-mcp-server"args = ["stdio"]default_tools_approval_mode = "approve"
[mcp_servers.gitlab.env]GITLAB_URL = "https://gitlab.example.com"GITLAB_TOKEN = "glpat-xxxxxxxxxxxxxxxxxxxx"Mantén la superficie de herramientas dynamic por defecto para clientes con límites de número de herramientas (Cursor limita cada servidor a 40 herramientas, Windsurf a 100, los clientes basados en OpenAI a 128 por petición) y deja META_PARAM_SCHEMA en su valor por defecto opaque para Codex, que recorta silenciosamente los esquemas de herramienta mayores de ~5 KB.
Funcionalidades del protocolo MCP
Sección titulada «Funcionalidades del protocolo MCP»GitLab MCP Server implementa el conjunto completo de capacidades MCP más allá de las herramientas — recursos, prompts, completions, elicitation y notificaciones de progreso — para que los clientes compatibles obtengan datos contextuales, plantillas de prompts y autocompletado de argumentos además de las llamadas a herramientas.
| Capacidad | Soportada |
|---|---|
| Tools | ✅ (hasta 1065 autoalojadas Enterprise / 1071 GitLab.com + Orbit individuales / 32 base, 49 autoalojadas, 50 GitLab.com meta) |
| Resources | ✅ (45) |
| Prompts | ✅ (37) |
| Completions | ✅ (17 tipos de argumento) |
| Elicitation | ✅ |
| Progress | ✅ |
Las cifras de 1065 autoalojadas y 1071 en GitLab.com son el conjunto expandido de instancias de herramienta distintas. Los recuentos de 32 base, 49 autoalojadas y 50 en GitLab.com son tamaños del catálogo de meta-herramientas cuyas acciones se expanden a esa superficie individual mayor.
Preguntas frecuentes
¿GitLab MCP Server funciona con GitLab Community Edition?
Sí. GitLab MCP Server funciona tanto con Community Edition (CE) como con Enterprise Edition (EE). En CE expone el catálogo base completo — 32 meta-herramientas base, 45 recursos y 37 prompts — que cubre proyectos, issues, merge requests, pipelines, CI/CD, wikis, releases, usuarios, grupos, búsqueda, despliegues, entornos y paquetes. Las funcionalidades exclusivas de Enterprise como merge trains, métricas DORA, gestión de vulnerabilidades, eventos de auditoría y políticas de cumplimiento requieren una licencia Premium o Ultimate y no están disponibles en CE.
¿Cómo habilito las herramientas Enterprise?
Define el tier de licencia explícitamente o deja que el servidor lo autodetecte. En modo stdio, establece GITLAB_TIER=premium o GITLAB_TIER=ultimate; en modo HTTP pasa --tier=premium o --tier=ultimate. Cuando se omite el tier, el servidor autodetecta la edición desde GET /license por entrada token+URL, con valor por defecto free. Forzar el catálogo Enterprise/Premium añade 16 meta-herramientas exclusivas de Enterprise. Los flags heredados GITLAB_ENTERPRISE=true (stdio) y --enterprise (HTTP) siguen respetándose por compatibilidad, pero están deprecados.
¿Qué sistemas operativos y arquitecturas se admiten?
Hay binarios precompilados disponibles para Linux, macOS y Windows en amd64 y arm64 — seis binarios en total. macOS ofrece compilaciones separadas para Intel (amd64) y Apple Silicon (arm64). Cada plataforma es un binario estático único sin dependencias en tiempo de ejecución.
¿Funciona GitLab MCP Server con OpenAI Codex?
Sí. El servidor detecta las sesiones de Codex automáticamente y aplica un perfil de compatibilidad: las prioridades de las anotaciones de contenido se redondean a valores enteros, que es lo que exigen las builds de Codex incluidas en ChatGPT.app, mientras que el resto de campos se entrega sin cambios. Configura el servidor en ~/.codex/config.toml con default_tools_approval_mode = "approve" para que las ejecuciones no interactivas puedan usar herramientas de escritura, y mantén la superficie de herramientas dynamic por defecto. Usa CLIENT_COMPAT=off para desactivar la reescritura por cliente.
¿Qué clientes MCP son compatibles con GitLab MCP Server?
Cualquier cliente que soporte el Model Context Protocol puede usar GitLab MCP Server. Los clientes stdio probados incluyen VS Code + GitHub Copilot, Claude Desktop, Cursor, Claude Code (CLI), Windsurf, IDEs de JetBrains, Zed y Kiro. Cualquier cliente Streamable HTTP puede conectarse mediante el modo HTTP. El servidor también admite recursos MCP (45), prompts (37), completions (17 tipos de argumento), elicitation y notificaciones de progreso.