Ejemplos de uso
Esta es una referencia rápida de prompts en lenguaje natural que puedes usar con cualquier asistente de IA conectado a GitLab MCP Server, agrupados por dominio. Escribe el prompt en lenguaje natural y el servidor lo traduce automáticamente a la operación correcta de la API de GitLab — las pestañas siguientes muestran a qué meta-herramienta y action se asigna cada prompt, en gestión de proyectos, revisión de código, CI/CD, releases y búsqueda.
Listar tus proyectos
Sección titulada «Listar tus proyectos»Prompt: “Muéstrame mis proyectos de GitLab”
El servidor llama a gitlab_project con action: list, devolviendo nombres de proyectos, descripciones y URLs.
Crear un issue
Sección titulada «Crear un issue»Prompt: “Crea un reporte de bug en my-group/my-project titulado ‘Login page returns 404 after password reset’ con etiquetas bug y priority::high”
El servidor llama a gitlab_issue con action: create, estableciendo el título, descripción, etiquetas y proyecto en una única operación.
Gestionar etiquetas
Sección titulada «Gestionar etiquetas»Prompt: “Lista todas las etiquetas en el proyecto frontend y crea una nueva etiqueta llamada ‘accessibility’ con color #0052CC”
El servidor primero llama a gitlab_label con action: list para mostrar las etiquetas existentes, luego action: create para añadir la nueva.
Seguir milestones
Sección titulada «Seguir milestones»Prompt: “Muéstrame el progreso del milestone Sprint 14 en my-project”
El servidor llama a gitlab_milestone con action: get, devolviendo el porcentaje de completado, conteos de issues abiertos/cerrados y fecha límite.
Listar merge requests abiertos
Sección titulada «Listar merge requests abiertos»Prompt: “Muéstrame todos los merge requests abiertos asignados a mí”
El servidor llama a gitlab_merge_request con action: list, filtrando por asignado y estado.
Verificar estado del pipeline
Sección titulada «Verificar estado del pipeline»Prompt: “¿Cuál es el estado del último pipeline en my-project?”
El servidor llama a gitlab_pipeline con action: list, devolviendo el estado, duración y etapas del pipeline más reciente.
Crear un release
Sección titulada «Crear un release»Prompt: “Crea el release v2.1.0 desde el tag v2.1.0 en my-project con notas de release sobre la corrección de login y mejoras de rendimiento”
El servidor llama a gitlab_release con action: create, asociando el release con el tag y estableciendo la descripción.
Buscar código
Sección titulada «Buscar código»Prompt: “Busca usos de la función obsoleta authenticateUser en todos mis proyectos”
El servidor llama a gitlab_search con action: code, buscando en todos los proyectos el patrón de código especificado.
Gestionar miembros
Sección titulada «Gestionar miembros»Prompt: “Lista todos los miembros del proyecto frontend y sus niveles de acceso”
El servidor llama a gitlab_member con action: list, devolviendo los miembros del equipo con sus roles y permisos.
Flujo de herramientas dinámico primero
Sección titulada «Flujo de herramientas dinámico primero»El modo dinámico es el predeterminado, así que los prompts anteriores no llegan directamente a una meta-herramienta con nombre. En su lugar, el asistente descubre primero la acción y su esquema con gitlab_find_action y luego la ejecuta con gitlab_execute_action usando un ID canónico domain.action:
gitlab_find_action → query: "listar merge requests abiertas"gitlab_execute_action → action: "merge_request.list", params: { project_id: "42", state: "opened" }Para tareas de análisis, el mismo flujo descubre acciones canónicas analyze.* antes de ejecutar:
gitlab_find_action → query: "analizar pipeline fallido"gitlab_execute_action → action: "analyze.pipeline_failure", params: { project_id: "42", pipeline_id: 12345 }Preguntas frecuentes
¿Qué puedo pedirle a un asistente de IA con GitLab MCP Server?
Cualquier cosa que expongan las API REST v4 y GraphQL de GitLab: 847 operaciones en Community Edition y hasta 1,071 en GitLab.com. En la práctica eso incluye listar y crear proyectos e issues, revisar merge requests, consultar y reintentar pipelines, publicar releases, gestionar etiquetas e hitos, buscar código en todo un grupo y administrar miembros. Formulas la petición en lenguaje natural y el servidor la resuelve a una acción canónica de GitLab.
¿Necesito conocer los nombres de las herramientas para usar GitLab MCP Server?
No. En la superficie dinámica predeterminada describes lo que quieres y el asistente llama a gitlab_find_action para localizar la acción y su esquema exacto, y después a gitlab_execute_action para ejecutarla. Los nombres como gitlab_issue solo se hacen visibles si cambias a TOOL_SURFACE=meta o TOOL_SURFACE=individual, que intercambian contexto de arranque por una lista navegable de herramientas.
¿Cómo le indico al asistente qué proyecto de GitLab usar?
Pasa la ruta del proyecto en project_id, con la forma grupo/proyecto — por ejemplo mi-grupo/backend. Los IDs numéricos también funcionan. Si trabajas dentro de un repositorio clonado, gitlab_resolve_project traduce la URL del remoto git al proyecto correcto de GitLab, así que no necesitas indicarlo.
¿Un asistente de IA puede modificar mis datos de GitLab sin preguntar?
No sin desactivar antes alguna salvaguarda. Las acciones destructivas exigen confirmación explícita antes de ejecutarse, GITLAB_READ_ONLY=true elimina del catálogo todas las acciones de escritura, y GITLAB_SAFE_MODE=true intercepta las mutaciones y devuelve una previsualización JSON de lo que ocurriría en vez de aplicarlo. Las operaciones de lectura, como listar y buscar, son siempre seguras.