🔧 Dépannage¶

Cette page regroupe les problèmes courants et leurs solutions.

Installation¶

`uv` introuvable après installation¶

export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$PATH"

Rechargez votre shell (source ~/.zshrc ou source ~/.bashrc) puis relancez le script.

`garmin-mcp` introuvable¶

uv tool install --python 3.12 git+https://github.com/Taxuspt/garmin_mcp

`leanproxy-mcp` introuvable (mode passerelle uniquement)¶

brew tap mmornati/leanproxy-mcp
brew install leanproxy-mcp

Note

leanproxy-mcp n'est requis qu'en mode passerelle (--use-leanproxy). En mode direct (défaut), il n'est pas installé.

Authentification Garmin¶

Tokens expirés¶

Les tokens Garmin sont valides environ 6 mois. Pour les renouveler :

uv run garmin-mcp-auth

Vérifier les tokens¶

uv run garmin-mcp-auth --verify

Erreur de connexion à Garmin Connect¶

Vérifiez que garmin-mcp fonctionne : garmin-mcp stdio
Vérifiez que les tokens existent : ls ~/.garminconnect/
Relancez l'authentification : uv run garmin-mcp-auth

Configuration IDE¶

L'agent `coach` n'apparaît pas dans mon IDE¶

Claude Code : vérifiez que .claude/agents/ existe et contient coach.md
OpenCode : vérifiez que .opencode/agents/ existe et contient coach.md
Gemini CLI : vérifiez que .gemini/commands/ contient les fichiers .toml

Relancez ./install.sh --ide <votre-ide> si nécessaire.

Le serveur MCP `garmin` (ou `leanproxy`) n'apparaît pas¶

Vérifiez la configuration MCP de votre IDE :

# Claude Code
cat .mcp.json

# OpenCode
cat ~/.config/opencode/opencode.json

# Cursor
cat .cursor/mcp.json

# Windsurf
cat .windsurf/mcp_config.json

Chaque configuration doit contenir une référence au serveur MCP garmin (mode direct) ou leanproxy (mode passerelle).

Données¶

Les dossiers de travail sont vides¶

Les dossiers activities/, medical/, nutrition/, planning/, rapports/, resources/ sont créés par le script d'installation. Ils sont exclus du dépôt (voir .gitignore).

Les données Garmin ne se synchronisent pas¶

Vérifiez que les tokens sont valides : uv run garmin-mcp-auth --verify
En mode passerelle, vérifiez que le serveur garmin est configuré dans leanproxy : cat ~/.config/leanproxy_servers.yaml
Vérifiez que garmin-mcp fonctionne : garmin-mcp stdio

Scripts Python¶

`download_fit.py` échoue avec une erreur de dépendances¶

Le script nécessite garminconnect et fitparse. Ces dépendances sont disponibles dans l'environnement garmin-mcp. Le script tente de se relancer automatiquement dans cet environnement. Si cela échoue :

uv tool run --from garminconnect --from fitparse python3 skills/fit-download/scripts/download_fit.py

Les autres scripts échouent¶

Les scripts analyze_gpx.py, compare_course.py et analyze_session_parts.py utilisent uniquement la stdlib Python — aucune dépendance externe n'est nécessaire.

Autres¶

Le script d'installation ne trouve pas Homebrew¶

En mode passerelle, le script affiche des instructions d'installation manuelle pour leanproxy-mcp. Installez-le manuellement puis relancez le script.

Problème non résolu ?¶

Ouvrez une issue avec :

Le système d'exploitation et sa version
La version de votre IDE
La sortie complète de ./install.sh
Les messages d'erreur exacts