Servidor MCP para lectores
El servidor MCP para lectores permite que tus lectores conecten su propio agente de IA directamente a tu documentación, de modo que pueda buscar en ella, orientarse y leer cualquier página o endpoint de API en formato Markdown.
La integración MCP permite que los agentes accedan a tu documentación mediante un endpoint de protocolo estandarizado en la ruta /mcp de la URL de tu documentación, por ejemplo: https://docs.example.com/mcp.
Cuando un cliente compatible con MCP o un agente de IA se conecta a esta ruta, puede usar las herramientas que expone el servidor MCP para interactuar con tu documentación.
Este servidor es de solo lectura y abarca tu documentación publicada. Para que tu propio equipo escriba y publique páginas desde un cliente de IA, consulta el servidor MCP para editores.
Herramientas disponibles
Las herramientas disponibles en el servidor MCP son:
search: busca en tu documentación y devuelve los extractos más relevantes, cada uno con la página de la que procede. Con AI Assistant activado, admite preguntas en lenguaje natural; de lo contrario, busca por palabras clave.list_versions: enumera tus versiones publicadas con sus slugs e indica cuál es la predeterminada.list_sections: enumera las secciones de documentación y las referencias de API de una versión, con sus slugs.list_pages: enumera las páginas de una sección de documentación, anidadas como las muestra tu barra lateral, cada una con su URL.read_page: lee una página de documentación en formato Markdown, a partir de su URL.list_endpoints: enumera los endpoints de una referencia de API (método, ruta y resumen), agrupados por etiqueta, cada uno con su URL.read_endpoint: lee un endpoint en formato Markdown, a partir de su URL: sus parámetros, cuerpo de la solicitud y respuestas, con los esquemas que utilizan.
Todas las herramientas funcionan con tu versión predeterminada, a menos que el agente indique otra. Una referencia de API se lee endpoint por endpoint, nunca completa, por lo que el agente primero enumera los endpoints y después lee los que necesita.
El servidor MCP admite el transporte Streamable HTTP.
Si los agentes de tus lectores necesitan algo que estas herramientas no cubren, contáctanos con los detalles.
Qué puede ver un agente
Un agente ve exactamente lo que su lector puede abrir: tus versiones publicadas, secciones de documentación, referencias de API y páginas. En una documentación pública, eso es lo que ve un visitante anónimo. En una documentación privada, el lector inicia sesión, por lo que el agente también ve las páginas de sus audiencias. Cualquier otra cosa le parece al agente una página que no existe.
Activar el servidor MCP
El servidor MCP está disponible en todos los planes y no requiere AI Assistant. Para activarlo:
Abre Configuración del proyecto → AI → AI Agents & MCP y, después, la pestaña Readers.
En MCP server, activa MCP server.
Haz clic en Save changes en el menú superior.
El cambio puede tardar hasta 5 minutos en aplicarse.
El servidor MCP no depende de llms.txt. Lee tus páginas como Markdown tanto si Enable llms.txt está activado como si no.
Si el botón AI Tools está activado, los lectores pueden conectar Claude Code, Codex, VS Code o Cursor a tu documentación desde su opción de menú Connect your AI tool. El botón en sí requiere que llms.txt esté activado.
Documentación privada
El servidor MCP también funciona en documentación privada, sea cual sea la forma en que tus lectores inicien sesión. Los lectores conectan su aplicación de IA a la misma ruta /mcp y, la primera vez, la aplicación les pide iniciar sesión:
Su navegador abre tu sitio de documentación y inician sesión como lo hacen habitualmente.
Una tarjeta Connect your AI app indica el nombre de la aplicación que lo solicita. Hacen clic en Allow access.
Entonces la aplicación lee tu documentación como ese lector. Mantiene el acceso mientras el lector siga con la sesión iniciada en tu documentación, durante un máximo de 30 días, y después le pide que inicie sesión de nuevo. Cualquier cosa que ponga fin al acceso del lector pone fin de inmediato al de la aplicación.
Prueba nuestro servidor MCP
Puedes probar nuestro propio servidor MCP antes de activarlo en tu documentación. Para una prueba rápida, haz clic en la flecha junto a Copy page en la parte superior de esta página > Connect your AI tool. También puedes hacerlo manualmente. Tomemos Cursor como cliente MCP de ejemplo:
Inicia Cursor.
En Settings > Cursor Settings.
Haz clic en Tools en la barra lateral.
Haz clic en New MCP Server.
En el archivo que se abrió, introduce lo siguiente:
Guarda el archivo.
Alterna el panel de IA ⌘ + I.
Hazle al agente una pregunta como "Search DeveloperHub docs for how to add an image" o "List the pages of the DeveloperHub Support Center, then read the one on callouts".

Need help? Visit our community forums or contact us.