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
guardystop_unlessen 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
- En el asistente, abrí la lista de servidores MCP (en Claude Code:
/mcp).neo-docstiene que aparecer conectado. - Preguntá algo de la doc pidiéndole que la use, por ejemplo: "buscá en neo-docs cómo configurar el CI con NEO".
- 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 |