---
title: Servidor MCP de documentación
description: El mismo contenido que lee en esta página se sirve a los agentes por MCP. Punto de conexión, catálogo de cinco herramientas y el veredicto de la búsqueda.
allan.topic: reference
allan.service: allan-mcp-hub
allan.date: 08/03/2026
allan.fuente: [internal/providers/docs/provider.go]
allan.audiencia: [desarrollador, agente]
allan.aplica_a: agentes de la plataforma y clientes MCP externos
---

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

```http
POST /docs/mcp
Content-Type: application/json
X-Allan-Service-Token: <token>
```

> [!NOTA]
> 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. |

> [!IMPORTANTE]
> 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.

## Pasos siguientes

- [Metadatos de contenido](metadatos-de-contenido.md)