Documentación lista para agentes
Cada sitio de Typemark sirve Markdown, llms.txt y un servidor MCP, para que las herramientas de IA puedan leer tu documentación igual que las personas.
Actualizado el 19 nov 20264 min de lectura
Tus lectores cada vez preguntan primero a un asistente de IA antes de abrir tu documentación. Todos los sitios de Typemark están preparados para eso, en todos los planes y sin nada que configurar: cada página tiene una versión en Markdown, el sitio tiene llms.txt y llms-full.txt, y un servidor MCP permite que las herramientas de programación busquen y lean tu documentación directamente.
La documentación privada es la excepción: las herramientas de IA no pueden iniciar sesión, así que un sitio protegido con contraseña no tiene servidor MCP, y su Markdown y llms.txt requieren la contraseña como todo lo demás.
Los ejemplos siguientes usan https://docs.acme.com. Sustitúyelo por la dirección de tu sitio: tu dominio personalizado o {slug}.typemark.dev.
Versión en Markdown de cada página
Añade .md a la URL de cualquier página para obtenerla en Markdown:
curl https://docs.acme.com/guides/authentication.md
Obtienes el título de la página como encabezado, la descripción como cita y el cuerpo de la página sin el frontmatter. Los componentes como <Callout> se mantienen tal cual, y los enlaces apuntan a URL completas de tu sitio.
Las herramientas que envían Accept: text/markdown reciben Markdown desde la URL normal de la página. Cada página HTML también apunta a su versión en Markdown mediante una cabecera Link.
llms.txt y llms-full.txt
| Archivo | Contenido |
|---|---|
/llms.txt | El nombre y el resumen de tu sitio, seguidos de una lista de todas las páginas con un enlace a su versión en Markdown y su descripción. Sigue el formato de llms.txt. |
/llms-full.txt | El Markdown de todas las páginas en un único archivo, en el orden de navegación. |
La línea de resumen procede de seo.default_description en typemark.json. Las páginas con hidden: true en su frontmatter se excluyen de ambos archivos.
Estos archivos pueden almacenarse en caché durante hasta una hora, así que un cambio puede tardar ese tiempo en aparecer.
Servidor MCP
Cada sitio tiene un servidor MCP de solo lectura en /mcp. Añádelo a una herramienta de IA y esta podrá buscar y leer tu documentación mientras trabaja. No se necesita inicio de sesión ni clave de API.
https://docs.acme.com/mcp
Tiene tres herramientas:
| Herramienta | Qué hace |
|---|---|
search_docs | Busca en tu documentación y devuelve hasta 10 páginas coincidentes, cada una con un fragmento |
get_page | Devuelve una página en Markdown, por ruta o URL |
list_pages | Lista todas las páginas en orden de navegación, con su ruta y descripción |
Conecta tus herramientas
Añade esto a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto:
{
"mcpServers": {
"acme-docs": {
"url": "https://docs.acme.com/mcp"
}
}
}Los lectores no tienen que escribir esta configuración por su cuenta. Connect to Cursor / VS Code / Claude en el menú de acciones de la página muestra estos fragmentos con la URL de tu sitio ya rellenada.
Límites
Cada dirección IP puede hacer 60 solicitudes MCP por minuto, y cada sitio atiende hasta 600 por minuto.
Acciones de página
Cada página publicada tiene un botón Copy page junto a su título, con un menú de acciones de IA:
| Acción | Qué hace |
|---|---|
| Copy page | Copia la página en Markdown, lista para pegarla en un chat |
| View as Markdown | Abre la versión .md de la página |
| Open in ChatGPT | Inicia un chat de ChatGPT que lee la página |
| Open in Claude | Inicia un chat de Claude que lee la página |
| Connect to Cursor / VS Code / Claude | Muestra la configuración de MCP para tu sitio |
Una tarjeta Use these docs with AI debajo de la tabla de contenidos ofrece Connect via MCP y Copy llms.txt link.
Las acciones de página están activadas por defecto. Para ocultar el botón, el menú y la tarjeta, desactiva Page actions en Settings > Reader features, o establece esto en typemark.json:
"features": {
"page_actions": false
}
Desactivar las acciones de página solo las oculta a los lectores. Las páginas en Markdown, llms.txt y el servidor MCP siguen disponibles.
Lo que ven los agentes
Las herramientas de IA reciben exactamente lo que reciben los lectores:
- Solo contenido publicado. En el modo de despliegue manual, las ediciones no publicadas no aparecen en las páginas Markdown,
llms.txtni MCP. - Nada mientras el sitio está sin conexión. Si tu sitio está fuera de línea, estas superficies no sirven tu contenido.
- Las páginas ocultas siguen sin listarse. Las páginas con
hidden: truese excluyen dellms.txt,llms-full.txty de la búsqueda y la lista de páginas del servidor MCP. Su versión en Markdown se marca comonoindex. - El idioma predeterminado. En un sitio en varios idiomas,
llms.txt,llms-full.txty el servidor MCP sirven el idioma predeterminado. - Sin vistas previas. Los despliegues de vista previa y las vistas previas de ramas no tienen páginas Markdown,
llms.txtni servidor MCP.