Référence
Dépannage
Les problèmes les plus fréquents à l’installation, et leur solution.
Le connecteur est ajouté mais aucun outil n’apparaît+
Déconnecte puis reconnecte Athletia dans les réglages du connecteur. Dans la conversation, vérifie qu’il est activé : bouton + de la zone de saisie → Connecteurs.
« Issuer mismatch » ou erreur de métadonnées OAuth+
L’émetteur annoncé par le serveur MCP doit correspondre exactement, barre oblique finale comprise, à celui que publie le serveur d’autorisation. En développement, vérifie que ATH_OIDC_ISSUER se termine par / et que les services ont été redémarrés après un changement (make up).
Claude n’arrive pas à se connecter à un serveur local+
Claude échange le code de connexion depuis ses propres serveurs : l’émetteur et le serveur MCP doivent être publics, en https. Utilise un tunnel (Cloudflare Tunnel, ngrok) pour chacun.
Je n’ai pas reçu le code de vérification+
Vérifie les indésirables. En développement, tous les e-mails arrivent dans Mailpit : http://localhost:8125.
La connexion à l’assistant a expiré+
Les jetons se renouvellent seuls. Si la session a été révoquée (compte supprimé, déconnexion), reconnecte le connecteur.
L’assistant propose une charge qui me paraît fausse+
Demande-lui quelle règle de progression a été appliquée : chaque charge prévue en porte une. Pour la séance suivante seulement, demande-lui d’ajuster la charge (« mets 80 kg au squat la prochaine fois »).
Ça bloque toujours ? Déconnecte Athletia dans ton assistant, puis reconnecte-le : l’écran de connexion Athletia doit s’ouvrir.