Typemark Documentation

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

ArchivoContenido
/llms.txtEl 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.txtEl 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:

HerramientaQué hace
search_docsBusca en tu documentación y devuelve hasta 10 páginas coincidentes, cada una con un fragmento
get_pageDevuelve una página en Markdown, por ruta o URL
list_pagesLista 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"
    }
  }
}

Añade esto a .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "acme-docs": {
      "type": "http",
      "url": "https://docs.acme.com/mcp"
    }
  }
}

Ejecuta esto en tu terminal:

claude mcp add --transport http acme-docs https://docs.acme.com/mcp

En Claude, abre Customize > Connectors, elige Add custom connector y pega la URL del servidor.

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ónQué hace
Copy pageCopia la página en Markdown, lista para pegarla en un chat
View as MarkdownAbre la versión .md de la página
Open in ChatGPTInicia un chat de ChatGPT que lee la página
Open in ClaudeInicia un chat de Claude que lee la página
Connect to Cursor / VS Code / ClaudeMuestra 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.txt ni 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: true se excluyen de llms.txt, llms-full.txt y de la búsqueda y la lista de páginas del servidor MCP. Su versión en Markdown se marca como noindex.
  • El idioma predeterminado. En un sitio en varios idiomas, llms.txt, llms-full.txt y 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.txt ni servidor MCP.