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é acción del catálogo se asigna cada prompt: el action que pasarías a gitlab_execute_action en la superficie dinámica predeterminada, que es también la acción de la meta-herramienta de dominio correspondiente cuando GITLAB_MCP_TOOL_SURFACE=meta. Cubren 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 asistente ejecuta project.list (gitlab_project con action: list cuando GITLAB_MCP_TOOL_SURFACE=meta), 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 asistente ejecuta issue.create (gitlab_issue con action: create en la superficie meta), 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 asistente ejecuta primero project.label_list para mostrar las etiquetas existentes y luego project.label_create para añadir la nueva (gitlab_project con action: label_list y action: label_create en la superficie meta).
Seguir milestones
Sección titulada «Seguir milestones»Prompt: “Muéstrame el progreso del milestone Sprint 14 en my-project”
El asistente ejecuta project.milestone_get (gitlab_project con action: milestone_get en la superficie meta), devolviendo el estado, las fechas y la URL web del milestone, y project.milestone_issues para los issues que siguen abiertos en él.
Listar merge requests abiertos
Sección titulada «Listar merge requests abiertos»Prompt: “Muéstrame todos los merge requests abiertos asignados a mí”
El asistente ejecuta merge_request.list (gitlab_merge_request con action: list en la superficie meta), 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 asistente ejecuta pipeline.latest (gitlab_pipeline con action: latest en la superficie meta), devolviendo el estado, la ref, la duración y la URL web 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 asistente ejecuta release.create (gitlab_release con action: create en la superficie meta), 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 asistente ejecuta search.code (gitlab_search con action: code en la superficie meta), 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 asistente ejecuta project.members (gitlab_project con action: members en la superficie meta), 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 nunca nombran una herramienta directamente. 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" }Cuando falla un pipeline, el mismo flujo encadena dos acciones — localizar los jobs fallidos y leer el log de uno de ellos:
gitlab_find_action → query: "listar jobs fallidos de un pipeline"gitlab_execute_action → action: "job.list", params: { project_id: "42", pipeline_id: 8847, scope: ["failed"] }gitlab_execute_action → action: "job.trace", params: { project_id: "42", job_id: 501 }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: 865 operaciones en Community Edition y hasta 1,091 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 GITLAB_MCP_TOOL_SURFACE=meta o GITLAB_MCP_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, la acción de descubrimiento de proyecto traduce la URL del remoto git al proyecto correcto de GitLab, así que no necesitas indicarlo: discover_project.resolve mediante gitlab_execute_action en la superficie predeterminada, o la herramienta independiente gitlab_discover_project con GITLAB_MCP_TOOL_SURFACE=meta o individual.
¿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_MCP_READ_ONLY=true elimina del catálogo todas las acciones de escritura, y GITLAB_MCP_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.