llms.txt devuelve 404 pero llms-full.txt funciona

Mintlify aloja automáticamente un archivo llms.txt en la raíz de cada sitio de documentación. Si https://yourdocs.com/llms.txt devuelve 404 mientras https://yourdocs.com/llms-full.txt carga con normalidad, la causa más probable es la opción Don’t index project.

Cuando activas Don’t index project en la página General de tu panel, Mintlify devuelve 404 para llms.txt y /.well-known/llms.txt. La opción no bloquea llms-full.txt, que sigue disponible. Esta discrepancia hace que la ausencia de llms.txt parezca un error del despliegue cuando en realidad es un comportamiento configurado.

La exportación en Markdown de cada página (la URL .md) también conserva su referencia a /llms.txt después de que actives Don’t index project, aunque esa URL devuelva 404.

Para restaurar llms.txt:

1. Abre la página General de tu panel.
2. Desactiva Don’t index project.
3. Espera a que se complete el redespliegue. Activar o desactivar la indexación redespliega tu sitio, y el cambio surte efecto una vez finalizado el redespliegue.

Consulta Desactivar la indexación de todo el proyecto para conocer todo lo demás que controla esta opción.

Si Don’t index project está desactivada y llms.txt sigue devolviendo 404:

• Autenticación: en los sitios totalmente autenticados, tanto llms.txt como llms-full.txt requieren autenticación. Las solicitudes no autenticadas fallan para ambos archivos, no solo para llms.txt. Consulta llms.txt para ver cómo la autenticación afecta a cada archivo.
• Enrutamiento del proxy inverso: si sirves tu documentación a través de un proxy inverso con una lista de rutas permitidas, confirma que el proxy reenvía /llms.txt y /.well-known/llms.txt. Consulta Proxy inverso.