🤖 Serveur MCP - Guide d'installation

Qu'est-ce que le serveur MCP ?

Le serveur MCP (Model Context Protocol) permet d'utiliser tous les outils BetTracker Pro directement dans Claude Desktop. Vous pouvez poser des questions en langage naturel et l'IA utilisera vos données en temps réel.

📋 Prérequis

• Claude Desktop installé sur votre ordinateur
• Une clé API BetTracker (générez-la dans vos paramètres)

🚀 Configuration (2 minutes)

1. Générez votre clé API

Allez dans Paramètres > Clé API et cliquez sur Générer une clé API.

⚠️ Important : Copiez et sauvegardez votre clé immédiatement, vous ne pourrez plus la voir ensuite !

2. Configuration Claude Desktop

Selon votre système d'exploitation, ouvrez le fichier de configuration :

🍎 macOS

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

🐧 Linux

code ~/.config/Claude/claude_desktop_config.json

🪟 Windows

Ouvrez l'Explorateur de fichiers et allez à :

%APPDATA%\Claude\claude_desktop_config.json

Ajoutez cette configuration (copiez-collez et remplacez juste votre clé API) :

{
  "mcpServers": {
    "bettracker-pro": {
      "command": "npx",
      "args": [
        "-y",
        "bettracker-mcp-client@latest"
      ],
      "env": {
        "BETTRACKER_API_KEY": "btk_votre_clé_ici",
        "BETTRACKER_API_URL": "https://bettracker.io/api/mcp/sse"
      }
    }
  }
}

🔑 Important : Remplacez btk_votre_clé_ici par votre vraie clé API générée à l'étape 1.

3. Redémarrez Claude Desktop

Fermez complètement Claude Desktop et relancez-le.

✅ Test

Ouvrez Claude Desktop et tapez :

"Montre-moi mes statistiques de paris du mois"

Claude devrait utiliser l'outil get_user_stats et vous afficher vos statistiques !

🛠️ Outils disponibles

Le serveur MCP expose 11 outils pour gérer vos paris hippiques :

📊 Statistiques & Paris

• get_user_stats - Statistiques globales (ROI, bankroll, win rate, paris gagnés/perdus)
• get_recent_bets - Liste des paris récents avec filtres (mode, status, limite)
• get_bankroll_history - Évolution de la bankroll sur N jours (graphique)
• get_budget_status - État du budget (limites quotidiennes/hebdo/mensuelles, dépenses)

🏇 Courses & Pronostics

• get_today_races - Courses PMU du jour (hippodromes, horaires)
• get_ai_pronostics - Pronostics IA validés (expert consensus, cotes)
• search_races - Recherche de courses par hippodrome, date ou réunion
• get_pmu_race_analysis - Analyse complète d'une course PMU (chevaux, jockeys, stats)

👤 Compte & Notifications

• get_subscription_info - Informations abonnement (plan, statut, période)
• get_notifications - Notifications avec filtre lu/non lu
• ask_ai_chat - Envoi de message au chatbot IA BetTracker

🐛 Dépannage

Les outils ne s'affichent pas dans Claude Desktop

1. Vérifiez que votre clé API est correcte
2. Redémarrez complètement Claude Desktop
3. Consultez les logs : ~/Library/Logs/Claude/mcp*.log
4. Vérifiez que le backend BetTracker est accessible

Erreur d'authentification

Vérifiez que votre clé API commence bien par btk_ et est active dans vos paramètres.

Le serveur ne démarre pas

Le package bettracker-mcp-client est installé automatiquement via npx. Aucune installation manuelle n'est nécessaire !

📚 Ressources

• API REST
• Exemples de code
• Intégration ChatGPT