Comment utiliser l’API et le serveur MCP de TrainerPlan

L’API de TrainerPlan permet à vos propres outils de lire votre compte d’entraîneur et de planifier pour vos athlètes : un assistant IA comme Claude, ChatGPT ou Cursor via notre serveur MCP, un script ou un tableur. Elle est comprise dans l’offre Elite. Cet article explique comment créer une clé, connecter un assistant et faire votre première requête.

Ce que vous pouvez en faire

• Lire vos athlètes, leurs calendriers (séances planifiées et réalisées, avec leurs étapes), événements, notes, commentaires, zones d’entraînement, condition physique, fatigue et forme, mesures quotidiennes comme le poids, le sommeil et la VFC, et votre bibliothèque de séances.
• Faire des modifications, avec une clé qui le permet : planifier des séances avec des étapes structurées, copier des séances de votre bibliothèque, ajouter des notes et des événements, et commenter une séance. L’athlète est notifié et voit la modification dans son calendrier, exactement comme si vous l’aviez faite dans TrainerPlan.

Avant de commencer

• L’API et le serveur MCP font partie de l’offre Elite. Pendant l’essai ou avec une autre offre, la page API / MCP indique comment changer d’offre.
• Seuls le propriétaire du compte et les administrateurs de l’équipe peuvent créer des clés.

1. Créez une clé

1. Ouvrez votre profil et choisissez API / MCP dans le menu de gauche, ou allez sur app.trainerplan.co/trainer/api, puis cliquez sur Créer la clé.
2. Donnez-lui un nom qui dit ce qui va l’utiliser, par exemple « Rapport hebdomadaire ».
3. Choisissez une Expiration si vous voulez que la clé cesse de fonctionner d’elle-même au bout de 30 jours, 90 jours ou 1 an.
4. Cochez Autoriser cette clé à faire des modifications seulement si l’outil doit planifier ou modifier. Sans cette option, la clé ne peut que lire.
5. La première fois, acceptez les conditions de l’API. Vous ne le faites qu’une fois pour votre compte.
6. Cliquez sur Créer la clé puis sur Copier. La clé n’est affichée qu’une seule fois : conservez-la en lieu sûr.

Une clé donne accès à tous les athlètes de votre compte : traitez-la comme un mot de passe. Utilisez une clé distincte pour chaque outil : vous pouvez en avoir jusqu’à 10 et en Révoquer une à tout moment sans toucher aux autres.

2. Connectez un assistant IA (MCP)

Les assistants compatibles avec le Model Context Protocol (MCP), comme Claude, ChatGPT, Cursor ou VS Code, se connectent directement à TrainerPlan : tout ce que fait l’API devient un outil que l’assistant peut utiliser, sans écrire de code ni téléverser de fichier. L’adresse du serveur figure aussi sur la page API / MCP :

https://api.trainerplan.co/api/v1/mcp

Il s’identifie avec votre clé et ne fait que ce que la clé permet : avec une clé en lecture seule, l’assistant ne peut que lire. La plupart des assistants permettent d’envoyer la clé dans un en-tête. Dans Claude Code, par exemple :

claude mcp add --transport http trainerplan https://api.trainerplan.co/api/v1/mcp \

  --header "Authorization: Bearer YOUR_API_KEY"

Si un assistant ne demande qu’une adresse (un connecteur personnalisé dans Claude ou ChatGPT, par exemple), ajoutez votre clé à la fin : https://api.trainerplan.co/api/v1/mcp/YOUR_API_KEY. Cette adresse vaut la clé elle-même : gardez-la privée et révoquez la clé si elle a été partagée.

Posez ensuite vos questions avec vos mots, par exemple « Qui a manqué une séance cette semaine ? » ou « Planifie 5 x 1 km pour Laura jeudi ». Ce que l’assistant modifie arrive dans les calendriers et sur les appareils de vos athlètes comme si vous l’aviez fait vous-même. Il a pour consigne de vous demander avant de modifier quoi que ce soit, mais donnez-lui une clé en lecture seule sauf si vous voulez qu’il planifie, et vérifiez ce qu’il planifie avant de vous y fier.

3. Utilisez-la depuis vos propres scripts

Envoyez la clé dans l’en-tête Authorization. Cette requête liste vos athlètes :

curl https://api.trainerplan.co/api/v1/athletes \
  -H "Authorization: Bearer YOUR_API_KEY"

Toutes les adresses commencent par https://api.trainerplan.co/api/v1. La liste complète de ce que vous pouvez demander, avec un exemple pour chaque requête, se trouve dans Documentation de l’API, le lien en bas de la page de l’API.

Limites et utilisation

Chaque clé peut faire 120 requêtes par minute, dont 30 modifications. Une requête au-delà de la limite reçoit une erreur 429 : attendez une minute et réessayez. Sous vos clés, Utilisation des 30 derniers jours montre les requêtes de chaque jour et combien ont été refusées par la limite.

Bon à savoir

• Pour un athlète qui n’a pas encore accepté votre invitation, l’API ne renvoie que ce que vous avez ajouté vous-même.
• Les notes qu’un athlète garde privées ne sont pas renvoyées.
• Si vous pensez qu’une clé a été exposée, révoquez-la sur la page de l’API et créez-en une autre.

Des questions ? Écrivez-nous à info@trainerplan.co.