Extensión para Claude Desktop

GitLab MCP Server se distribuye como extensión de escritorio (.mcpb) de instalación en un clic para Claude Desktop en macOS y Windows. El paquete contiene un binario universal de macOS (Apple Silicon + Intel) y un ejecutable de Windows — sin Docker, Node.js ni Python.

Instalación

1. Descarga gitlab-mcp-server.mcpb desde la última release.

2. Abre el archivo con Claude Desktop — doble clic, o arrástralo a la ventana de Ajustes de Claude Desktop. Claude muestra un diálogo de instalación con los detalles de la extensión.

3. Rellena los ajustes y empieza a chatear.

Ajustes

Los nombres de la primera columna son los que muestra el diálogo de instalación de Claude Desktop (salen del manifiesto de la extensión, que solo existe en inglés); entre paréntesis tienes su equivalente en esta documentación.

Ajuste	Obligatorio	Por defecto	Variable de entorno
GitLab URL (URL de GitLab)	Sí	https://gitlab.com	GITLAB_URL
GitLab Personal Access Token (token de acceso personal)	Sí	—	GITLAB_TOKEN
Tool surface (superficie de herramientas)	No	dynamic	GITLAB_MCP_TOOL_SURFACE
GitLab tier (tier de GitLab)	No	autodetección	GITLAB_MCP_TIER
Read-only mode (modo solo lectura)	No	desactivado	GITLAB_MCP_READ_ONLY
Safe mode (modo seguro)	No	desactivado	GITLAB_MCP_SAFE_MODE
Skip TLS verification (omitir la verificación TLS)	No	desactivado	GITLAB_MCP_SKIP_TLS_VERIFY
Log level (nivel de log)	No	info	GITLAB_MCP_LOG_LEVEL

Almacenamiento del token

Claude Desktop guarda el Personal Access Token en el llavero del sistema operativo, no en un archivo de configuración en texto plano. Crea el token con el scope api en GitLab → User Settings → Access Tokens.

La superficie de herramientas por defecto, dynamic, registra solo dos herramientas find/execute, de modo que el servidor nunca satura la ventana de contexto de Claude. Cambia a meta (34 meta-herramientas) o individual (una herramienta por acción) en los ajustes de la extensión — consulta Superficies de herramientas.

Actualizaciones

Las actualizaciones llegan como nuevas versiones de la extensión publicadas con cada release. El servidor no se actualiza a sí mismo ni reemplaza nunca su propio binario, así que la versión que instalaste es la que se ejecuta hasta que Claude Desktop instale una extensión más nueva.

Verificación

Pídele a Claude algo como “¿Con qué usuario de GitLab estoy autenticado?” — debería llamar a gitlab_find_action y después a gitlab_execute_action con la acción user.current y devolver tu nombre de usuario.

Instancias self-managed

Configura la URL de tu instancia en el ajuste GitLab URL. Si usa un certificado autofirmado, activa Skip TLS verification.

Privacidad

El servidor se ejecuta íntegramente en tu máquina y no envía telemetría: la exportación opcional de OpenTelemetry viene desactivada por defecto y la extensión no expone ningún ajuste que la active, así que los datos fluyen solo entre Claude Desktop y la instancia de GitLab que configures. Consulta la Política de privacidad.