Goatching en MCP

Laisse ton assistant IA (Claude Desktop, Claude Code…) lire tes données réelles et préparer ton plan — toi, tu gardes la main sur la publication.

MCP (Model Context Protocol) est la prise standard qui relie un assistant IA à des outils. Le serveur Goatching expose uniquement les outils d'auto-coaching, branchés sur ton jeton personnel — donc sur ton compte, et rien d'autre.

1. Récupère ton jeton

Dans l'app : Compte → Accès API → Nouveau jeton. Copie le secret (préfixé gch_) — il ne s'affiche qu'une fois. C'est le même jeton que pour l'API.

2. Installe le serveur

Le serveur MCP est un unique fichier Python (transport stdio). Télécharge-le et installe ses deux dépendances :

curl -O https://goatching.fr/goatching-mcp.py
pip install fastmcp httpx

3. Configure ton assistant

Ajoute le serveur à la configuration MCP de ton client. Pour Claude Desktop (claude_desktop_config.json) ou Claude Code :

{
  "mcpServers": {
    "goatching": {
      "command": "python",
      "args": ["/chemin/absolu/vers/goatching-mcp.py"],
      "env": {
        "GOATCHING_TOKEN": "gch_ton_jeton_ici",
        "GOATCHING_API": "https://goatching.fr"
      }
    }
  }
}

Redémarre le client : les outils Goatching apparaissent.

4. Ce que l'IA peut faire

Outil	Rôle
`get_coaching_guide`	La méthode d'entraînement + garde-fous anti-blessure (l'IA la lit avant de bâtir un plan)
`get_my_profile`	Lire ton questionnaire, tes seuils, tes zones dérivées
`list_my_activities`	Lire tes sorties réelles (charge, durée, D+…)
`get_my_plan`	Voir ton plan (brouillon + version publiée)
`create_my_plan`	Créer ton plan (tu en es le coach)
`update_my_draft`	Écrire ton plan brouillon (validé, pas publié)
`validate_my_plan`	Tester un plan contre les garde-fous, sans l'enregistrer
`publish_my_plan`	Publier — seulement avec `confirm=True`

La publication n'est pas automatique. Le MCP construit et valide un brouillon ; c'est toi qui le relis dans l'app et qui appuies sur « Publier ». Une IA ne met jamais un plan en route à ta place.

5. Le guide d'entraînement (le « skill »)

Pour bâtir un plan sûr, l'assistant s'appuie sur le guide d'auto-coaching de Goatching — la même méthode que le coach : partir de tes données réelles, progressivité (rampe de charge, sortie longue +10 % max), décharges, affûtage, distribution d'intensité, spécificités trail, et le contrat PlanDoc.

Il le lit automatiquement via l'outil get_coaching_guide avant de construire ou modifier ton plan (c'est inscrit dans les instructions du serveur MCP) — tu n'as rien à faire. Tu peux aussi le lire toi-même : goatching.fr/coaching-guide.md.

Si l'assistant s'écarte de la méthode, redis-lui simplement « suis le guide d'auto-coaching » : il rappellera get_coaching_guide.

6. Exemple de conversation

Une fois branché, tu peux simplement demander :

« Regarde mes 8 dernières semaines sur Goatching et prépare-moi un
  plan de 10 semaines pour un semi en 1h45, 4 séances/semaine.
  Dépose-le en brouillon, je le publierai moi-même. »

L'assistant lit tes données, construit le PlanDoc, le valide contre les garde-fous, et le dépose. Tu ouvres l'app, tu relis, tu publies.

Ton jeton reste dans la config locale de ton assistant. Il expire tout seul, et tu peux le révoquer quand tu veux depuis l'app.