llms.txt, Markdown et serveur MCP

Les assistants de code et les agents lisent la documentation pour écrire du code juste. Docs leur offre trois portes d’entrée, sans rien à configurer.

llms.txt

Le fichier llms.txt est un index de la doc, en Markdown, à la racine du site. Il commence par le nom de la doc et une phrase de présentation, puis liste les pages avec leur description, rangées par onglet et par groupe.

Le même contenu répond sur /llms.txt et sur /.well-known/llms.txt. /llms-full.txt contient toute la doc en un seul fichier, pour les agents qui veulent tout charger d’un coup.

Quand la doc a plusieurs versions, la version par défaut passe en premier. Les autres sont rangées dans une section Optional, que l’agent peut ignorer.

Une page en Markdown

Chaque page existe aussi en Markdown, à la même adresse suivie de .md : /guides/publier.md pour /guides/publier/. La page l’annonce dans son <head>, ce qui permet à un outil de la trouver sans la deviner.

En haut de chaque page, le menu Copier pour un LLM copie ce Markdown dans le presse-papiers. Il propose aussi Ouvrir dans Claude et Ouvrir dans ChatGPT, qui ouvrent l’assistant externe avec la version Markdown de la page.

Le Markdown reflète ce que voit le visiteur : les composants sont rendus, et un encadré devient une citation qui commence par son titre en gras.

Le serveur MCP

Chaque projet a un serveur MCP en lecture seule. Un agent qui le connaît peut chercher dans la doc, lire une page ou lister les pages, sans passer par le site.

Le serveur ne fait que chercher et lire ce que le site publie. Il ne fait pas appel au modèle qui rédige les réponses de l’assistant, et il reste disponible si l’assistant du site est coupé. Son installation est décrite dans Connecter un agent au serveur MCP.

Quelle porte choisir

Besoin	Porte
Un agent veut comprendre la doc entière	llms-full.txt
Un agent veut lire une page précise	La version .md de la page
Un agent doit chercher une réponse dans une grosse doc	Le serveur MCP
Un visiteur de ton site pose une question	L’assistant du site

Voir aussi

• Fichiers publiés.
• Serveur MCP.