Ir al contenido

Autocompletado

El autocompletado proporciona sugerencias en tiempo real para los parámetros de las herramientas. En lugar de memorizar IDs de proyectos, nombres de ramas o nombres de usuario, escribes unos pocos caracteres y el servidor consulta GitLab para encontrar coincidencias.

Sin autocompletado:
Usuario: "Crear issue en el proyecto..." → ¿Cuál es el ID? → Primero hay que llamar a list_projects
Con autocompletado:
El usuario escribe: "mcp" → El servidor sugiere: "gitlab-mcp-server (1835)", "redmine-mcp-server (1869)"

Esto transforma una búsqueda de múltiples pasos en una selección única e interactiva.

sequenceDiagram
    participant U as Usuario
    participant AI as Asistente IA
    participant S as Servidor MCP
    participant GL as API de GitLab

    U->>AI: Comienza a escribir el valor del argumento
    AI->>S: completion/complete (arg: "project_id", value: "mcp")
    S->>GL: GET /projects?search=mcp
    GL-->>S: Proyectos coincidentes
    S-->>AI: Sugerencias de autocompletado
    AI->>U: Muestra desplegable con opciones

El servidor soporta 17 tipos de argumentos de autocompletado organizados en completadores globales y por proyecto:

Funcionan sin contexto de proyecto:

ArgumentoCompletaEjemplo
projectNombres/rutas de proyectosmy-group/my-project
groupNombres/rutas de gruposengineering
userNombres/logins de usuariosjohn.doe
namespaceNamespaces (grupos + usuarios)my-group

Requieren un contexto de proyecto y buscan dentro de ese proyecto:

ArgumentoCompletaEjemplo
branchNombres de ramasfeature/login
tagNombres de tagsv1.2.0
milestoneTítulos de milestonesSprint 14
labelNombres de etiquetaspriority::high
merge_requestTítulos/IIDs de MRs!42 Fix login
issueTítulos/IIDs de issues#100 Bug report
pipelineIDs de pipelines12345
environmentNombres de entornosproduction
releaseNombres de tags de releasesv2.0.0
wiki_slugSlugs de páginas wikigetting-started
versionIDs de versiones/milestonesv1.0
runnerDescripciones de runnersshared-runner-1
boardNombres de tablerosDevelopment

Cómo el autocompletado mejora la precisión de la IA

Sección titulada «Cómo el autocompletado mejora la precisión de la IA»

El autocompletado reduce errores de varias formas:

  1. Elimina errores tipográficos — Los usuarios seleccionan de sugerencias validadas en lugar de escribir valores exactos
  2. Reduce viajes de ida y vuelta — No es necesario llamar a list_projects antes de create_issue
  3. Proporciona contexto — Las sugerencias incluyen IDs junto con nombres, asegurando valores correctos
  4. Búsqueda en tiempo real — Los resultados se actualizan mientras el usuario escribe, potenciados por la API de búsqueda de GitLab