Asistente de configuración

El asistente instala y configura GitLab MCP Server para clientes MCP stdio. Úsalo para instalaciones locales donde tu cliente de IA arranca directamente el proceso del servidor, como VS Code, Claude Desktop, Claude Code, Cursor, Windsurf, Copilot CLI, OpenCode, Crush o Zed.

Solo stdio

El asistente no configura despliegues en modo servidor HTTP. Para despliegues HTTP compartidos o remotos, usa Modo servidor HTTP.

Comando rápido

Ejecuta el asistente con selección automática de interfaz:

gitlab-mcp-server --setup

El modo automático prueba primero la interfaz más completa disponible: Web UI, después TUI y finalmente CLI simple.

Elegir un modo de interfaz

Usa --setup-mode cuando quieras una interfaz concreta:

Web

gitlab-mcp-server --setup --setup-mode web

El asistente Web inicia un servidor local temporal en 127.0.0.1, abre el navegador y espera hasta que completes la configuración. Es la mejor opción para la primera instalación porque las opciones avanzadas incluyen ayudas en línea.

TUI

gitlab-mcp-server --setup --setup-mode tui

El asistente TUI se ejecuta en la terminal con navegación por teclado. Úsalo cuando estés en una shell interactiva y prefieras no abrir el navegador.

CLI

gitlab-mcp-server --setup --setup-mode cli

El asistente CLI pregunta una opción cada vez. Úsalo en terminales headless, sesiones SSH o entornos donde el navegador y la TUI no estén disponibles.

Qué hace el asistente

1. Selecciona la ruta de instalación del binario gitlab-mcp-server.
2. Recoge tu URL de GitLab y tu Personal Access Token.
3. Carga cualquier configuración previa del asistente para que puedas conservar o cambiar valores existentes.
4. Permite elegir los clientes MCP soportados que quieres configurar.
5. Escribe el archivo de entorno stdio compartido y los archivos de configuración de los clientes seleccionados.

Archivos que escribe

El asistente mantiene los secretos fuera de los archivos JSON de los clientes.

Archivo	Propósito
~/.gitlab-mcp-server.env	Guarda GITLAB_URL, GITLAB_TOKEN, TLS, catálogo, seguridad, carga de archivos, rate limit, autoactualización y logging. En Unix se escribe con permisos 0600.
Archivos de configuración de clientes	Guardan la entrada MCP para cada cliente seleccionado. Cuando el cliente lo soporta, referencian el archivo env en lugar de incrustar secretos.

VS Code recibe una referencia envFile a ~/.gitlab-mcp-server.env. JetBrains IDEs es de solo visualización en el asistente: imprime el fragmento JSON para que lo pegues en el IDE.

Configuración existente

Cuando ~/.gitlab-mcp-server.env ya existe, el asistente lo carga antes de mostrar el formulario o los prompts. Los valores existentes quedan preseleccionados para URL de GitLab, token, modo de catálogo, flags de seguridad, autoactualización, rate limits, nivel de log y otras opciones avanzadas.

Deja vacío el campo del token para conservar el token existente. Escribe un token nuevo solo cuando quieras rotarlo.

Clientes soportados

El asistente puede configurar estos clientes stdio:

Cliente	Comportamiento
VS Code (GitHub Copilot)	Escribe una entrada MCP y referencia el archivo env. Seleccionado por defecto.
Claude Desktop	Escribe el archivo de configuración MCP de escritorio.
Claude Code (CLI)	Escribe el archivo de configuración MCP de Claude Code.
Cursor	Escribe la configuración MCP de Cursor.
Windsurf (Codeium)	Escribe la configuración MCP de Windsurf.
JetBrains IDEs	Imprime JSON para copia manual.
Copilot CLI	Escribe la configuración MCP de Copilot CLI. Seleccionado por defecto.
OpenCode	Escribe la configuración MCP de OpenCode.
Crush (Charm)	Escribe la configuración MCP de Crush.
Zed	Escribe la configuración MCP de Zed.

Opciones avanzadas

Las opciones avanzadas se corresponden con variables de entorno stdio escritas en ~/.gitlab-mcp-server.env.

Opción del asistente	Variable de entorno	Descripción
Omitir verificación TLS	GITLAB_SKIP_TLS_VERIFY	Permite certificados GitLab autofirmados o de CA privada.
Superficie de herramientas	TOOL_SURFACE	Elige meta, individual, dynamic, dynamic-2 o dynamic-3.
Superficie de capacidades	CAPABILITY_SURFACE	Elige recursos/prompts completos o contexto inicial mínimo.
Esquema de parámetros meta	META_PARAM_SCHEMA	Controla el detalle del esquema de entrada de las meta-herramientas.
Catálogo Enterprise/Premium	GITLAB_ENTERPRISE	Habilita herramientas Premium/Ultimate en modo stdio.
Modo solo lectura	GITLAB_READ_ONLY	Registra solo herramientas que no mutan estado.
Vistas previas seguras	GITLAB_SAFE_MODE	Devuelve vistas previas de llamadas mutantes en lugar de ejecutarlas.
Recursos embebidos	EMBEDDED_RESOURCES	Añade enlaces de recursos MCP canónicos en resultados tipo get.
Ignorar scopes del PAT	GITLAB_IGNORE_SCOPES	Omite la detección de scopes del token y registra todas las herramientas.
Herramientas excluidas	EXCLUDE_TOOLS	Omite nombres de herramientas separados por comas.
Tamaño máximo de subida	UPLOAD_MAX_FILE_SIZE	Define el tamaño máximo aceptado para subidas y archivos.
Modo de autoactualización	AUTO_UPDATE	Aplica, comprueba o desactiva actualizaciones antes del arranque.
Repositorio de autoactualización	AUTO_UPDATE_REPO	Elige el repositorio GitHub usado para comprobar releases.
Timeout de autoactualización	AUTO_UPDATE_TIMEOUT	Limita el tiempo dedicado a la comprobación pre-arranque.
Rate limit RPS	RATE_LIMIT_RPS	Define el límite de llamadas stdio; 0 lo desactiva.
Rate limit burst	RATE_LIMIT_BURST	Define el tamaño del bucket cuando el rate limit está activo.
Modo YOLO	YOLO_MODE	Omite algunas confirmaciones locales de seguridad. Úsalo con cuidado.
Nivel de log	LOG_LEVEL	Define logging debug, info, warn o error.

Las opciones exclusivas del servidor HTTP, como modo OAuth, timeout de sesión, máximo de clientes HTTP o intervalo de autoactualización HTTP, no aparecen en el asistente porque pertenecen al proceso HTTP de larga duración.

Reconfigurar más tarde

Vuelve a ejecutar el asistente en cualquier momento:

gitlab-mcp-server --setup

El asistente carga primero el archivo env existente, así que puedes cambiar solo los valores que necesites.

Siguientes pasos

• Consulta Configuración para la referencia completa de variables de entorno.
• Consulta Conjunto dinámico para elegir catálogos de bajo consumo.
• Consulta Modo servidor HTTP para despliegues compartidos o remotos.