Cómo conectar GitLab a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → GitLab, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

GitLab + Cursor

Deja que tu IA trabaje en GitLab: encuentra proyectos, clasifica y actualiza issues, revisa merge requests con sus diffs y comentarios, comprueba pipelines y lee los logs de los jobs fallidos, y lee ramas, commits y archivos. GitLab.com o tu propia instancia de GitLab, con un token de acceso personal.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

GITLAB_URL, GITLAB_TOKEN

Paso 1 — Obtener credenciales

1. En GitLab, haz clic en tu avatar → Edit profile → Access → Personal access tokens → Generate token. En GitLab.com la página está en gitlab.com/-/user_settings/personal_access_tokens.
2. Ponle un nombre al token (por ejemplo "AnythingMCP"), fija una fecha de caducidad (365 días como máximo en GitLab.com) y marca el scope api. Para una configuración de solo lectura, marca read_api en su lugar.
3. Copia el token enseguida: GitLab lo muestra una sola vez. Empieza por glpat-.
4. Pega el token en GITLAB_TOKEN, sin la palabra Bearer. Pon en GITLAB_URL https://gitlab.com para GitLab.com, o la dirección de tu instancia self-managed o Dedicated tal como la abres en el navegador (por ejemplo https://gitlab.example.com), sin /api/v4 y sin barra final. Después instala el conector.
5. Empieza con gitlab_get_current_user: muestra a qué usuario de GitLab pertenece el token y confirma que la dirección es correcta. Después indícale a la IA un proyecto por su ruta, por ejemplo my-group/my-project, o deja que lo encuentre con gitlab_list_projects.

Caducidad y alcance del token: en GitLab.com un token dura como máximo 365 días. Cuando caduque el tuyo, genera uno nuevo con el mismo scope y vuelve a pegarlo en GITLAB_TOKEN. El conector actúa como el usuario del token: la IA ve y cambia exactamente lo que puede ese usuario. Un token de acceso personal fine-grained (GitLab 19.2 y posteriores) funciona igual: dale permiso de lectura y escritura sobre issues, merge requests, repositorio, pipelines y jobs de los proyectos afectados. Algunos grupos de GitLab.com exigen tokens fine-grained, y entonces un token clásico falla en sus proyectos con "Access denied: This operation requires a fine-grained personal access token". Los project y group access tokens también sirven, pero en GitLab.com necesitan Premium o Ultimate.

Configuración de solo lectura: usa un token con read_api y desactiva gitlab_create_issue, gitlab_update_issue, gitlab_add_issue_note, gitlab_create_merge_request, gitlab_update_merge_request, gitlab_add_merge_request_note y gitlab_create_branch.

Desactivadas al instalar: gitlab_delete_issue, que borra una issue para siempre (solo pueden hacerlo los propietarios del proyecto y los administradores, y normalmente lo que quieres es cerrarla con gitlab_update_issue), y gitlab_delete_branch. Actívalas solo si la IA debe borrar issues o ramas.

Proyectos, issues y merge requests: las herramientas reciben un proyecto por su id numérico o su ruta completa, por ejemplo my-group/my-project. Las issues y merge requests se identifican por el número que muestra GitLab (#42, !17), no por su id global. gitlab_list_project_members da los ids de usuario para asignados y revisores. gitlab_list_my_issues y gitlab_list_my_merge_requests funcionan en todos los proyectos y por defecto muestran los elementos del usuario del token, incluidas las merge requests que esperan su revisión.

Revisiones, pipelines y código: para revisar una merge request, la IA lee gitlab_get_merge_request (estado de merge y conflictos), luego gitlab_get_merge_request_diffs página a página, gitlab_list_merge_request_commits y gitlab_list_merge_request_notes. Un archivo con un diff demasiado grande llega sin texto; la IA lo lee entonces con gitlab_get_file_content en la rama de origen. Para un pipeline fallido pasa de gitlab_list_pipelines a gitlab_list_pipeline_jobs (solo los jobs fallidos) y a gitlab_get_job_log. Los archivos y logs de jobs se cortan a 200 KB y se conserva el principio: abre un log más largo en GitLab. gitlab_search_project busca en el código de un proyecto en cualquier plan; la búsqueda de código en toda la instancia con gitlab_search necesita advanced search, una función de Premium.

Confirma antes de escribir: las issues, comentarios, merge requests y ramas se crean a nombre del usuario del token. La IA te muestra antes el título, el texto o la rama y espera tu confirmación. GitLab ejecuta las quick actions de un comentario, como /label, /assign, /close, /approve o /merge, así que la IA solo las incluye si tú lo pides. Crear una rama requiere acceso Developer.

Límites de uso: GitLab.com permite unas 2.000 solicitudes a la API por minuto y usuario, 200 issues nuevas y 60 comentarios nuevos por minuto, y 100 búsquedas por minuto. En una instancia self-managed los límites los fija el administrador. Al superar un límite, GitLab responde 429: espera y vuelve a intentarlo.

Errores frecuentes: 401 significa que el token es incorrecto, caducó o se revocó, o que GITLAB_URL apunta a una instancia distinta de la que lo emitió. 403 significa que falta un scope (por ejemplo un token read_api en una escritura) o que el rol no alcanza para la acción. 404 significa que el proyecto, la issue o el archivo no existe o que el usuario no puede verlo: GitLab oculta los recursos privados tras un 404. 400 indica el campo que falta o no es válido. 409 al crear una merge request significa que ya hay una abierta para esas ramas. Un proyecto renombrado sigue respondiendo a lecturas en su ruta antigua, pero las escrituras ahí fallan con 405: usa la ruta nueva o el id numérico.

El conector no tiene herramientas para hacer merge o aprobar merge requests, hacer push de commits, editar archivos ni lanzar, reintentar o cancelar pipelines, y no cubre variables de CI/CD, releases, wikis, paquetes, el container registry ni la administración.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de GitLab.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué merge requests esperan mi revisión en todos los proyectos, y cuáles tienen conflictos o un pipeline fallido?"
• "¿Por qué falló el último pipeline de main en my-group/web-app? Muéstrame el job fallido y el error de su log."
• "Resume la merge request !128 de my-group/web-app: qué cambió, en qué archivos y qué comentarios de revisión siguen sin resolver."
• "Crea una issue en my-group/web-app con el título Botón de pago desalineado en móvil, con la etiqueta bug, y asígnasela a Lena."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT