# Documentación de GitLab MCP Server

> Documentación de gitlab-mcp-server, un servidor Model Context Protocol que expone la API REST v4 y GraphQL de GitLab como herramientas para asistentes de IA.

Este es el índice del sitio de documentación (versión 3.0.0). Cada entrada enlaza una página de documentación con su propia descripción. El código, los issues y las releases están en https://github.com/jmrplens/gitlab-mcp-server.

Portada: [GitLab MCP Server](https://jmrp.io/docs/gitlab-mcp-server/es/) - Servidor Model Context Protocol de código abierto para GitLab, con superficies de herramientas dinámicas, meta-herramientas e individuales para asistentes de IA.

La documentación está completa en inglés y en español. Esta es la mitad en español; el índice en inglés está en https://jmrp.io/docs/gitlab-mcp-server/llms.txt.

## Primeros pasos

- [Primeros pasos](https://jmrp.io/docs/gitlab-mcp-server/es/getting-started/): Instala y configura GitLab MCP Server en menos de cinco minutos — con Docker, binario nativo, npm, PyPI o NuGet — para VS Code, Claude, Cursor y otros clientes MCP.
- [Configuración](https://jmrp.io/docs/gitlab-mcp-server/es/configuration/): Configura GitLab MCP Server con variables de entorno en modo stdio y flags de CLI en modo HTTP, además de configuración de clientes y opciones de despliegue.
- [Arquitectura](https://jmrp.io/docs/gitlab-mcp-server/es/architecture/): Cómo GitLab MCP Server conecta los asistentes de IA con GitLab — transportes stdio y HTTP, un catálogo canónico de acciones y un modelo de seguridad sin estado.
- [Compatibilidad](https://jmrp.io/docs/gitlab-mcp-server/es/compatibility/): Compatibilidad de plataforma, edición de GitLab y clientes MCP — CE y EE, binarios por SO y arquitectura, y cualquier cliente MCP por stdio o HTTP.

## Instalación

- [Instalación](https://jmrp.io/docs/gitlab-mcp-server/es/install/overview/): Todas las formas de instalar GitLab MCP Server, desde un binario nativo, Homebrew o winget hasta Docker, npm, PyPI, NuGet, un plugin de agente, la extensión para Claude Desktop o el endpoint alojado, y cómo se actualiza cada canal.
- [Binario nativo](https://jmrp.io/docs/gitlab-mcp-server/es/install/binary/): Descarga el binario de GitLab MCP Server para tu plataforma desde GitHub Releases o deja que el script de instalación lo coloque, verifica el checksum y la firma Sigstore, ponlo en tu PATH y actualízalo volviendo a descargar.
- [Homebrew](https://jmrp.io/docs/gitlab-mcp-server/es/install/homebrew/): Instala GitLab MCP Server en macOS o Linux desde el tap de Homebrew jmrplens/tap, averigua dónde deja el binario la fórmula, apunta tu cliente MCP a él y actualiza con brew upgrade.
- [Windows (winget)](https://jmrp.io/docs/gitlab-mcp-server/es/install/winget/): Instala GitLab MCP Server en Windows con winget como paquete portable, averigua dónde quedan el ejecutable y su alias en el PATH, actualízalo y desinstálalo, y entiende por qué winget puede ir por detrás de GitHub Releases.
- [Docker](https://jmrp.io/docs/gitlab-mcp-server/es/install/docker/): Ejecuta GitLab MCP Server desde la imagen de contenedor de ghcr.io, sobre stdio para un cliente de escritorio o como servicio HTTP en un puerto, pasa los ajustes por variables de entorno, elige una etiqueta y actualiza con docker pull.
- [npm y npx](https://jmrp.io/docs/gitlab-mcp-server/es/install/npm/): Instala GitLab MCP Server desde npm como un paquete lanzador más un binario precompilado para tu plataforma, ejecútalo con npx sin instalar nada y mantenlo al día con npm update.
- [PyPI, uvx y pipx](https://jmrp.io/docs/gitlab-mcp-server/es/install/pypi/): Instala GitLab MCP Server desde PyPI como una wheel de plataforma que lleva el binario nativo, ejecútalo con uvx sin instalar nada o ponlo en tu PATH con pipx, uv tool o pip.
- [NuGet y dnx](https://jmrp.io/docs/gitlab-mcp-server/es/install/nuget/): Instala GitLab MCP Server desde NuGet.org como una herramienta .NET cuyo punto de entrada es el binario nativo, ejecútalo con dnx sin instalar nada o ponlo en tu PATH con dotnet tool install.
- [Extensión para Claude Desktop](https://jmrp.io/docs/gitlab-mcp-server/es/claude-desktop/): Instala GitLab MCP Server en Claude Desktop con un clic mediante la extensión de escritorio .mcpb — macOS y Windows, sin Docker ni runtimes.
- [Plugins de agente](https://jmrp.io/docs/gitlab-mcp-server/es/install/agent-plugin/): Instala GitLab MCP Server como Agent Plugin en Cursor, Claude Code, VS Code u OpenCode a partir del manifest que incluye este repositorio, y entiende cómo llega tu token al servidor.
- [Endpoint alojado](https://jmrp.io/docs/gitlab-mcp-server/es/install/hosted/): Usa la instancia pública de GitLab MCP Server en mcp.jmrp.io sin instalar nada, iniciando sesión con OAuth o enviando un token de GitLab.com, y entiende qué implica ese intercambio antes de depender de ella.

## Herramientas

- [Visión general de herramientas](https://jmrp.io/docs/gitlab-mcp-server/es/tools/overview/): Los tres modos de herramientas de GitLab MCP Server (dinámico, meta-herramientas e individual) y cómo equilibran el coste de tokens con la granularidad.
- [Meta-herramientas](https://jmrp.io/docs/gitlab-mcp-server/es/tools/meta-tools/): Las meta-herramientas agrupan operaciones de GitLab en herramientas MCP por dominio que enrutan según un parámetro action, reduciendo el recuento más del 95%.
- [Conjunto de herramientas dinámico](https://jmrp.io/docs/gitlab-mcp-server/es/tools/dynamic-tools/): El modo predeterminado de bajo consumo de tokens — dos herramientas buscan y ejecutan un catálogo canónico de acciones de GitLab.
- [Orbit](https://jmrp.io/docs/gitlab-mcp-server/es/tools/orbit/): Seis herramientas MCP de solo lectura para la API experimental Knowledge Graph de GitLab.com, disponibles solo en GitLab.com con nivel Premium o Ultimate.
- [Recursos y prompts](https://jmrp.io/docs/gitlab-mcp-server/es/tools/resources-prompts/): Recursos MCP de solo lectura y plantillas de prompts reutilizables, las dos primitivas MCP que dan contexto a los asistentes de IA más allá de las herramientas.

## Capacidades MCP

- [Capacidades MCP](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/overview/): Las cuatro capacidades MCP de GitLab MCP Server — progreso, elicitación, autocompletado y suscripciones a recursos — más metadatos de iconos en herramientas, recursos y prompts.
- [Elicitación](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/elicitation/): Flujos interactivos de elicitación MCP que guían la creación de issues, merge requests, releases y proyectos de GitLab mediante formularios paso a paso.
- [Autocompletado](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/completions/): Autocompletado de argumentos MCP que sugiere proyectos, ramas, usuarios y etiquetas de GitLab en tiempo real al componer parámetros de herramientas.
- [Suscripciones a Recursos](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/subscriptions/): Suscripciones a recursos MCP que entregan notificaciones de cambio en vivo para 26 tipos de recurso de GitLab — pipelines, issues, merge requests, archivos y más — atendidas mediante sondeo.
- [Progreso](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/progress/): Notificaciones MCP de progreso en tiempo real que informan del estado paso a paso, de streaming y de sondeo de operaciones largas de GitLab.
- [Iconos](https://jmrp.io/docs/gitlab-mcp-server/es/capabilities/icons/): GitLab MCP Server asigna 50 iconos de dominio a cada herramienta, recurso y prompt, más una marca para la identidad del servidor, como data URIs base64 — una entrada SVG más variantes WebP clara/oscura para clientes que rechazan SVG.

## Operaciones

- [Seguridad](https://jmrp.io/docs/gitlab-mcp-server/es/operations/security/): Modelo de seguridad de GitLab MCP Server — aislamiento de tokens, scopes, modos solo lectura y seguro, TLS, OAuth y verificación de integridad del release.
- [Política de privacidad](https://jmrp.io/docs/gitlab-mcp-server/es/operations/privacy/): Política de privacidad de GitLab MCP Server: sin analítica, sin backend, telemetría solo si la activas y solo hacia un colector que ejecutas tú; los datos fluyen entre tu máquina y la instancia de GitLab que configures.
- [OpenTelemetry](https://jmrp.io/docs/gitlab-mcp-server/es/operations/telemetry/): Exporta trazas, métricas y logs por OTLP a un colector que tú ejecutas. Desactivado por defecto, con todas las opciones de configuración, las trampas de codificación de credenciales y exactamente qué sale y qué no sale del proceso.
- [Modo servidor HTTP](https://jmrp.io/docs/gitlab-mcp-server/es/operations/http-server/): Despliega GitLab MCP Server como servicio HTTP multiusuario con autenticación por token en cada petición, pool de credenciales aisladas, OAuth y rate limiting.
- [Despliegue remoto](https://jmrp.io/docs/gitlab-mcp-server/es/operations/remote-deployment/): Ejecuta GitLab MCP Server para otras personas: como servicio del sistema, en Docker, tras nginx, Caddy, Traefik, Apache o un túnel de Cloudflare, y con varias instancias usando afinidad por token.
- [Manejo de errores](https://jmrp.io/docs/gitlab-mcp-server/es/operations/error-handling/): Cómo GitLab MCP Server clasifica los errores de API por estado HTTP, extrae diagnósticos detallados y devuelve sugerencias accionables a los asistentes de IA.
- [Uso en CI/CD](https://jmrp.io/docs/gitlab-mcp-server/es/operations/ci-cd/): Ejecuta gitlab-mcp-server en jobs CI/CD de GitLab en modo determinista JSON-RPC o con LLM para revisiones automáticas y flujos de release.
- [Pruebas E2E con Docker](https://jmrp.io/docs/gitlab-mcp-server/es/operations/docker-testing/): Ejecuta la suite end-to-end de GitLab MCP Server contra una instancia efímera de GitLab CE o EE con runner de CI y fixtures deterministas.
- [Solución de problemas](https://jmrp.io/docs/gitlab-mcp-server/es/operations/troubleshooting/): Guía para resolver problemas de configuración, autenticación, transporte, Docker y ejecución de herramientas.

## Rendimiento

- [Dimensionar un despliegue](https://jmrp.io/docs/gitlab-mcp-server/es/performance/sizing/): Cuánta gente cabe en una instancia y qué lo decide de verdad: lo que cuesta una credencial en reposo, lo que cuesta una forma de configuración una sola vez, lo que cuesta una llamada y los mandos que merece la pena tocar a escala.
- [Consumo de recursos](https://jmrp.io/docs/gitlab-mcp-server/es/performance/resource-benchmark/): Lo que cuesta ejecutar el servidor, medido y no estimado: memoria residente, tiempo de procesador, goroutines y latencia por método en ambos transportes, según la superficie de herramientas, el número de clientes y la telemetría.

## Despliegue empresarial

- [Despliegues empresariales](https://jmrp.io/docs/gitlab-mcp-server/es/enterprise/overview/): Da servicio a cientos de personas desde un único despliegue de GitLab MCP Server: qué cambia a ese tamaño y dónde está escrita cada parte.
- [Balanceo de carga](https://jmrp.io/docs/gitlab-mcp-server/es/enterprise/load-balancing/): Varias instancias tras un balanceador: para qué sirve la afinidad, hash consistente sobre un digest con sal, configuraciones trabajadas de nginx y HAProxy, ventanas de drenaje y reintentos que nunca repiten una llamada entregada.
- [Pasarelas MCP](https://jmrp.io/docs/gitlab-mcp-server/es/enterprise/mcp-gateways/): Qué cambia una pasarela MCP delante de este servidor: validación del catálogo, el camino de la credencial, sesiones y suscripciones, caché, renombrado de herramientas y enrutado por identificador canónico de acción.
- [TLS](https://jmrp.io/docs/gitlab-mcp-server/es/enterprise/tls/): Dónde terminar TLS, el certificado del propio listener, la rotación en caliente sin reinicio, los certificados de cliente y lo que un socket unix le cuesta al presupuesto de fallos de autenticación a escala.
- [Operación a escala](https://jmrp.io/docs/gitlab-mcp-server/es/enterprise/operations/): Llevar la flota: actualizaciones progresivas, comparar config_digest entre instancias, telemetría con muchos usuarios, salida fija para las listas de permitidos de GitLab, los secretos que guarda un despliegue y qué vigilar.

## Ejemplos

- [Casos de uso](https://jmrp.io/docs/gitlab-mcp-server/es/use-cases/): Flujos de trabajo comunes de GitLab MCP Server — revisión de código, depuración CI/CD, gestión de issues, releases, informes y seguridad, en lenguaje natural.
- [Ejemplos de uso](https://jmrp.io/docs/gitlab-mcp-server/es/examples/usage/): Ejemplos prácticos de GitLab MCP Server para issues, merge requests, CI/CD, releases y flujos de repositorio.
- [Ejemplos de flujos CI/CD](https://jmrp.io/docs/gitlab-mcp-server/es/examples/ci-cd-workflows/): Ejemplos CI/CD con GitLab MCP Server — diagnosticar pipelines fallidos, gestionar variables, programar builds, controlar entornos y leer métricas DORA.
- [Ejemplos de revisión de código](https://jmrp.io/docs/gitlab-mcp-server/es/examples/code-review-workflows/): Ejemplos de revisión de merge requests con GitLab MCP Server — listar MRs, leer diffs, aprobaciones, notas y discusiones, fusionar y comparar ramas.
- [Ejemplos de gestión de issues](https://jmrp.io/docs/gitlab-mcp-server/es/examples/issue-management/): Ejemplos de gestión de issues con GitLab MCP Server — triar, asignar y etiquetar, vincular issues, seguir milestones, discutir y buscar.

## Acerca de

- [Sobre este proyecto](https://jmrp.io/docs/gitlab-mcp-server/es/about/): Quién mantiene GitLab MCP Server, por qué existe, cómo se licencia y versiona, y cómo reportar problemas o contribuir.
- [Comparar servidores MCP de GitLab](https://jmrp.io/docs/gitlab-mcp-server/es/comparison/): Cómo se compara GitLab MCP Server con el servidor MCP oficial de GitLab y otras opciones de la comunidad — cobertura de API, licencia, transporte, runtime y controles de seguridad.
- [Glosario](https://jmrp.io/docs/gitlab-mcp-server/es/glossary/): Definiciones de los términos que usa GitLab MCP Server — superficie de herramientas, catálogo de acciones, meta-herramienta, modo dinámico, gating por tier, elicitación, safe mode y más.
- [Releases y versionado](https://jmrp.io/docs/gitlab-mcp-server/es/changelog/): Cómo se versiona y publica GitLab MCP Server, qué incluye cada release, cómo suscribirse a las novedades y cómo verificar o revertir una build.

## Referencias legibles por máquina

Estos archivos los genera el catálogo del servidor, no el sitio, y se republican aquí sin cambios; su contenido está en inglés, porque ese catálogo no tiene traducción. Cada entrada lleva su tamaño, porque de eso depende cuáles puedes cargar y cuáles solo consultar por recuperación. Empieza por el índice del servidor.

- [Índice del servidor](https://jmrp.io/docs/gitlab-mcp-server/llms-server.txt) (22 KB, ~6k tokens): el servidor MCP en sí: canales de instalación, configuración del cliente, variables de entorno y un resumen de una línea de cada meta-herramienta, recurso y prompt
- [Referencia media](https://jmrp.io/docs/gitlab-mcp-server/llms-medium.txt) (153 KB, ~39k tokens): cada herramienta y acción con su descripción, sin los esquemas JSON por acción. El mayor de estos archivos que aún cabe en una ventana de contexto
- [Superficies dinámica y de meta-herramientas, esquemas completos](https://jmrp.io/docs/gitlab-mcp-server/llms-full-meta-tools.txt) (2.2 MB, ~588k tokens): esquemas completos solo de la superficie dinámica de dos herramientas y de las meta-herramientas por dominio
- [Herramientas individuales, esquemas completos](https://jmrp.io/docs/gitlab-mcp-server/llms-full-individual-tools.txt) (894 KB, ~229k tokens): esquemas completos solo de la superficie de una herramienta por operación
- [Recursos y prompts, definiciones completas](https://jmrp.io/docs/gitlab-mcp-server/llms-full-resources-prompts.txt) (29 KB, ~7k tokens): solo las definiciones de recursos y prompts MCP
- [Referencia completa](https://jmrp.io/docs/gitlab-mcp-server/llms-full.txt) (3.1 MB, ~824k tokens): los tres archivos por superficie anteriores concatenados: cada superficie con cada esquema JSON por acción. Muy por encima de cualquier ventana de contexto, así que consúltalo solo mediante búsqueda o recuperación

## Otros idiomas

- [Índice de la documentación en inglés](https://jmrp.io/docs/gitlab-mcp-server/llms.txt): la misma documentación en inglés, página por página