El mismo contenido que lee en esta página se sirve a los agentes mediante el Protocolo de Contexto de Modelo. No hay una segunda documentación para máquinas: si diverge alguna vez, es un fallo.
Punto de conexión
POST /docs/mcp
Content-Type: application/json
X-Allan-Service-Token: <token>
Transporte HTTP en modo sin estado, un mensaje JSON-RPC por petición. El
servidor anuncia únicamente tools: no expone resources ni prompts, y una
llamada a resources/list devuelve -32601.
Herramientas
| Herramienta | Qué hace | Respuesta típica |
|---|---|---|
docs.buscar |
Busca en el corpus y devuelve extractos con su ancla. Nunca devuelve cuerpos completos. | ~1.200 tokens |
docs.leer |
Devuelve el markdown de hasta tres artículos, con paginación por ancla. | ~1.800 tokens |
docs.termino |
Resuelve hasta ocho términos del vocabulario controlado. | ~400 tokens |
docs.pantalla |
Devuelve el manual de una ruta de la interfaz con sus acciones y errores. | ~1.800 tokens |
docs.simbolo |
Resuelve un código de error, un identificador de herramienta o una ruta de código. | ~500 tokens |
Veredicto de la búsqueda
Toda respuesta de docs.buscar incluye un campo veredicto con tres valores
posibles.
| Valor | Significado |
|---|---|
encontrado |
Hay artículos que responden. |
no_existe_confirmado |
La funcionalidad no existe y está documentado que no existe. |
sin_cobertura |
Nadie lo ha escrito. La consulta pasa al backlog documental. |
Un agente debe distinguir no_existe_confirmado de sin_cobertura antes de
responder. El primero permite afirmar que algo no existe; el segundo, no.
Confundirlos es cómo un agente acaba prometiendo un botón que no existe.
Cuándo no usar esta herramienta
Si la respuesta cambia según la organización, no está aquí: está en la memoria organizacional. Esta documentación es idéntica para todos los inquilinos.