Donner la doc à ton IA

Une IA t'aide mieux quand elle lit la vraie documentation. Voici trois façons de la lui donner, de la plus simple à la plus complète.

Les deux premières ne demandent pas de clé. Pour la troisième, il te faut une clé qui peut lire, avec un périmètre de lecture comme Élèves › Lire (students:read) : crée-la dans l'app, sous Paramètres › Intégrations › Clés API. Crée-la pour l'IA seule, avec seulement ce dont elle a besoin.

1. Colle le lien llms.txt

Colle l'un de ces liens dans ta conversation avec Claude ou ChatGPT :

• https://fitdistance.io/documentation/api/llms.txt : l'index court, avec un lien et une phrase pour chaque page et chaque famille de routes.
• https://fitdistance.io/documentation/api/llms-full.txt : toute la documentation dans un seul fichier, plus long.

Ces deux fichiers sont en anglais, comme le contrat de l'API. Ils se lisent sans clé : ne la donne pas à l'IA pour ça.

2. Utilise les boutons de chaque page

Chaque page de guide a un menu Copier la page, avec cinq choix :

• Copier en Markdown : copie le texte de la page, à coller dans la conversation si ton IA ne peut pas ouvrir un lien.
• Voir en Markdown : ouvre la page en Markdown dans un nouvel onglet.
• Ouvrir dans Claude et Ouvrir dans ChatGPT : ouvrent l'assistant avec un message qui lui demande de lire la page et de t'aider à l'utiliser. Le message contient l'adresse de la page, pas son texte.
• Copier le lien llms.txt : copie le lien de l'étape 1.

Donne aussi à l'IA le lien de la page de la famille concernée, par exemple https://fitdistance.io/documentation/api/reference/students pour les élèves. Elle y trouve chaque route de la famille, ses paramètres et ses réponses.

3. Branche le serveur MCP avec ta clé

Les liens donnent la documentation à l'IA, pas tes données. Pour qu'elle lise tes élèves, branche le serveur MCP avec la même clé que l'API. Si ton outil IA accepte un serveur MCP avec un en-tête personnalisé, donne-lui :

• l'adresse du serveur : https://mcp.fitdistance.io ;
• l'en-tête : Authorization: Bearer fd_live_xxxxxxxx.

Remplace fd_live_xxxxxxxx par ta clé. Tu retrouves les mêmes outils qu'avec une connexion par compte. Les périmètres de la clé n'en cachent aucun, sauf dans la recherche d'outils (fitdistance_search_tools), qui montre les outils dont la clé a le périmètre de famille. Un outil appelé hors périmètre répond une erreur qui nomme le périmètre manquant, sans coûter de crédit. Crée alors une nouvelle clé qui l'a.

4. Vérifie que ça marche

Demande à l'IA d'appeler l'outil whoami. Il ne coûte aucun crédit et répond avec le compte connecté. S'il échoue, vérifie l'adresse, le mot Bearer et que la clé n'est pas révoquée.

5. Sache ce que ça coûte

Un outil qui touche à tes données coûte un crédit, comme sur l'API : ce sont les mêmes crédits, expliqués dans Clés et crédits. Les outils d'orientation ne coûtent aucun crédit et répondent avec n'importe quelle clé, par exemple :

• fitdistance_learn : explique à l'IA ce qu'elle peut faire, domaine par domaine.
• fitdistance_mcp_info : donne la version du serveur et un diagnostic.
• fitdistance_search_tools : retrouve un outil par ressource et action.

Un aperçu est gratuit aussi : un outil qui demande une confirmation, appelé sans la donner, ne coûte rien, même à solde nul : seule l'exécution est refusée. Exception : neuf outils dont la confirmation dépend du contenu débitent avant l'aperçu et remboursent s'il n'écrit rien. Tu vois donc ce qu'un outil ferait avant de lui donner ta confirmation.

La suite

Le détail des fichiers et du serveur est dans llms.txt et llms-full.txt et le serveur MCP. Ton IA peut aussi t'aider à suivre un cas pratique : un e-mail à chaque nouvel élève, une relance pour les élèves sans bilan, une relance pour les élèves inactifs ou un autre cas pratique de l'accueil. Les cas pratiques qui écrivent le disent en tête de page : leur clé doit pouvoir écrire.