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: "group/gitlab-mcp-server", "group/redmine-mcp-server"

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:

| Argumento | Completa | Ejemplo | | ----------- | ------------------------------ | --------------------- | | project | Nombres/rutas de proyectos | my-group/my-project | | group | Nombres/rutas de grupos | engineering | | user | Nombres/logins de usuarios | john.doe | | namespace | Namespaces (grupos + usuarios) | my-group |

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

| Argumento | Completa | Ejemplo | | --------------- | --------------------------- | ----------------- | | branch | Nombres de ramas | feature/login | | tag | Nombres de tags | v1.2.0 | | milestone | Títulos de milestones | Sprint 14 | | label | Nombres de etiquetas | priority::high | | merge_request | IIDs de MRs | 42 | | issue | IIDs de issues | 100 | | pipeline | IDs de pipelines | 12345 | | environment | Nombres de entornos | production | | release | Nombres de tags de releases | v2.0.0 | | wiki_slug | Slugs de páginas wiki | getting-started | | version | IDs de versiones/milestones | v1.0 | | runner | Descripciones de runners | shared-runner-1 | | board | Nombres de tableros | Development |

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