Saltar a contenido

Consultar esta documentación desde el asistente (MCP neo-docs)

Esta guía explica cómo conectar tu asistente de IA a esta misma documentación, para que responda las preguntas sobre NEO buscando en la doc oficial, en lugar de responder de memoria.

Nombre del servidor neo-docs
Paquete neo-docs-mcp, que se ejecuta con uvx neo-docs-mcp
Tipo Local (stdio): se ejecuta en tu computadora, igual que los MCP de Jira o Playwright
Contenido Todo lo que ves en este sitio, en español e inglés, actualizado en cada publicación de la doc
Acceso Solo lectura

1. ¿Para qué sirve?

Mientras trabajás con NEO, el asistente puede consultar la documentación en el momento: cómo se configura el CI, qué hace una skill, qué playbook corresponde a una situación, qué significa un error del engine. Cada respuesta trae el link a la sección del sitio de donde salió, así que siempre podés verificarla.

Ejemplos de preguntas:

  • "¿Cómo configuro el CI de NEO en GitLab?"
  • "¿Qué playbook uso si salió un bug en producción?"
  • "¿Qué diferencia hay entre guard y stop_unless en un plan?"

2. Cómo se mantiene actualizado

El servidor no trae la documentación adentro. Cada vez que se publica el sitio, también se publica su índice de búsqueda, y el servidor lo descarga al arrancar. Si no cambió nada, reusa la copia que ya tiene; si no hay conexión, trabaja con la última que descargó.

No hace falta actualizar el paquete para tener la doc nueva: alcanza con abrir una sesión nueva del asistente.


3. Conectarlo

Requisito: tener uv instalado (trae uvx). Es el mismo que usa el MCP de Jira; verificalo con uvx --version.

Desde una terminal:

claude mcp add -s user neo-docs -- uvx neo-docs-mcp

-s user lo deja disponible en todos tus proyectos. Después abrí una conversación nueva: los servidores MCP se cargan al iniciar la sesión.

En .mcp.json (Claude Code), .vscode/mcp.json (Copilot) o .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "neo-docs": {
      "command": "uvx",
      "args": ["neo-docs-mcp"]
    }
  }
}

En .vscode/mcp.json la clave raíz es servers en lugar de mcpServers.

Para que responda en inglés por defecto, agregá "--lang", "en" a args.

Cómo busca

Cada consulta combina dos búsquedas y fusiona los resultados: una léxica (encuentra nombres exactos como lippia-neo-run-and-heal o qa-stack.yaml) y una semántica (entiende preguntas dichas con otras palabras). No hay que elegir ni configurar nada.

La búsqueda semántica usa un modelo que corre en tu computadora (multilingual-e5-small). La primera vez lo descarga en segundo plano (unos 470 MB): mientras tanto el servidor ya responde con la búsqueda léxica, y pasa a la combinada apenas termina. Las siguientes veces lo usa desde el inicio.

Si trabajás en una red donde no se puede descargar el modelo, agregá "--mode", "bm25" a args para usar solo la búsqueda léxica.


4. Verificar que funciona

  1. En el asistente, abrí la lista de servidores MCP (en Claude Code: /mcp). neo-docs tiene que aparecer conectado.
  2. Preguntá algo de la doc pidiéndole que la use, por ejemplo: "buscá en neo-docs cómo configurar el CI con NEO".
  3. La respuesta tiene que incluir links a docs.neo.crowdar.com.

5. Qué herramientas expone

Herramienta Qué hace
search_docs Busca en la doc y devuelve los fragmentos más relevantes, con su link. Si varios fragmentos de la misma sección son relevantes, devuelve la sección entera
get_section Devuelve una sección completa, a partir del id que dio search_docs
get_page Devuelve una página completa y el índice de sus secciones
list_toc Devuelve el árbol de navegación del sitio

Todas aceptan lang (es por defecto, o en).

Preguntá en el idioma de la doc que consultás

La búsqueda funciona mejor con consultas en el mismo idioma que lang. Sirven tanto preguntas en lenguaje natural como nombres exactos (lippia-neo-run-and-heal, qa-stack.yaml, bug-fix-cycle).


6. Problemas comunes (y qué hacer)

Lo que ves Por qué puede pasar Qué hacer
neo-docs no aparece en /mcp Lo agregaste con la sesión ya abierta Abrí una conversación nueva (en VS Code, si hace falta, Developer: Reload Window)
Aparece en una carpeta pero no en otra En Claude Code lo agregaste con alcance de proyecto (el default) Volvé a agregarlo con -s user
uvx: command not found No está instalado uv Instalalo desde docs.astral.sh/uv
could not reach … and there is no cached index Sin conexión en el primer arranque Conectate una vez: después funciona con la copia local
El asistente responde sin consultar la doc Decide solo cuándo usar una herramienta Pedíselo explícitamente: "buscá en neo-docs…"
No aparece algo que acabás de publicar El servidor descarga el índice al arrancar Abrí una sesión nueva del asistente