Serveur MCP Slek

fonctionnalité Premium

1. Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un standard ouvert qui permet aux moteurs IA de se connecter à des services externes. Le serveur MCP de Slek te permet d'utiliser Claude, Mistral ou tout client IA compatible MCP pour interagir avec tes données d'entraînement — consulter tes séances, créer des sessions, analyser la charge et gérer tes athlètes, le tout depuis ton outil IA préféré.

Slek recommande Claude et Mistral pour la meilleure expérience MCP. Si l'intégration avec un autre fournisseur est importante pour toi, n'hésite pas à contacter le support.

2. A qui s'adresse-t-il ?

Slek est une plateforme d'entraînement pour coachs et athlètes. Un coach peut gérer les plans d'entraînement de plusieurs athlètes depuis un seul compte. Le serveur MCP agit pour le compte du coach : il donne à l'assistant IA accès à tous les athlètes du coach et à leurs données.

Un seul athlète est actif à la fois — tous les outils opèrent sur l'athlète actif par défaut. L'assistant peut basculer entre les athlètes avec athlete_list (pour voir tous les athlètes coachés) et athlete_switchTo (pour en sélectionner un). Il peut aussi revenir au profil du coach avec athlete_switchToSelf. Cela permet de planifier, analyser et comparer l'entraînement de tout un groupe d'athlètes depuis une seule conversation.

Par exemple : "Montre-moi les séances de John cette semaine, puis bascule sur Sarah et crée-lui une séance de récupération vendredi."

3. Informations serveur


URL du serveur	https://app.slek.app/mcp
Transport	Streamable HTTP
Authentification	OAuth 2.1 ou clé API (Bearer token)
Requis	Abonnement Premium

4. Comment se connecter

Option 1 : Automatique (recommandé)

Dans Claude aller dans Personnaliser > Connecteurs > Ajouter un connecteur personnalisé,
Dans Mistral Le Chat aller sur Intelligence > Connecteurs > Ajouter un connecteur > Connecteur MCP personnalisé

L'URL du serveur MCP est : https://app.slek.app/mcp

L'implémentation suit la spécification MCP : authentification OAuth 2.1 avec PKCE (S256), Dynamic Client Registration, et tokens d'accès courts (1 heure) avec rotation des refresh tokens.

Option 2 : Clé API (configuration manuelle)

Cette option s'adresse à des utilisateurs chevronnés uniquement !

Va dans Paramètres > Assistant dans Slek
Dans la section Serveur MCP, crée une nouvelle clé API
Copie l'URL du serveur et ta clé API
Configure ton client IA :

Claude Desktop — édite claude_desktop_config.json :

{
  "mcpServers": {
    "slek": {
      "url": "https://app.slek.app/mcp",
      "headers": {
        "Authorization": "Bearer TA_CLE_API"
      }
    }
  }
}

Claude Code (CLI) :

claude mcp add slek --transport http https://app.slek.app/mcp

5. Outils disponibles

Le serveur MCP expose 39 outils organisés par domaine. Chaque outil est annoté avec son comportement : lecture seule, création, modification ou suppression.

Bibliothèque de séances

Outil	Description
`library_search`	Rechercher dans la bibliothèque par sport, effort, durée, distance et tags
`library_read`	Obtenir une séance de bibliothèque par son ID
`library_create`	Créer une nouvelle séance dans la bibliothèque
`library_update`	Modifier les champs d'une séance existante
`library_delete`	Supprimer une séance de bibliothèque (irréversible)
`library_listTags`	Lister tous les tags utilisés dans la bibliothèque

Séances planifiées

Outil	Description
`workout_list`	Lister les séances planifiées sur une plage de dates
`workout_read`	Obtenir les détails d'une séance planifiée
`workout_create`	Créer une séance planifiée sur le calendrier
`workout_createFromLib`	Planifier une séance depuis la bibliothèque
`workout_update`	Modifier une séance planifiée existante
`workout_delete`	Supprimer une séance planifiée (irréversible)
`workout_estimateLoad`	Estimer la charge d'une séance hypothétique

Événements

Outil	Description
`event_list`	Lister les événements du calendrier (notes, courses, douleurs)
`event_read`	Obtenir un événement par son ID
`event_create`	Créer un nouvel événement
`event_update`	Modifier un événement existant
`event_delete`	Supprimer un événement (irréversible)

Saisons

Outil	Description
`season_list`	Lister toutes les saisons d'entraînement
`season_read`	Obtenir les détails d'une saison avec sa planification
`season_create`	Créer une nouvelle saison d'entraînement
`season_update`	Modifier les métadonnées d'une saison (nom, dates)
`season_updatePlanning`	Modifier la planification (périodes, cycles, charges)
`season_delete`	Supprimer une saison (irréversible)
`season_readLoadProgress`	Charge prévue vs réalisée semaine par semaine

Activités

Outil	Description
`activity_list`	Lister les activités récentes (lecture seule)
`activity_read`	Obtenir les données détaillées : stats, zones, pics
`activity_recentVolume`	Volume d'entraînement agrégé par sport sur les jours récents

Athlètes

Outil	Description
`athlete_list`	Lister tous les athlètes coachés
`athlete_switchTo`	Basculer vers un autre athlète
`athlete_switchToSelf`	Revenir à son propre profil
`activeAthlete_profile`	Obtenir le profil de l'athlète actif
`activeAthlete_zones`	Obtenir les zones d'entraînement (FC, puissance, vitesse)
`activeAthlete_availability`	Obtenir les disponibilités à venir

Utilitaires de dates

Outil	Description
`date_add`	Ajouter des jours/heures à une date
`date_weekday`	Obtenir le nom du jour pour une date
`date_weekStart`	Obtenir le lundi de la semaine
`date_weekEnd`	Obtenir le dimanche de la semaine
`date_validate`	Vérifier si une date est valide

6. Exemples

1. Consulter les données d'entraînement

Prompt : "Montre-moi mes séances de cette semaine et compare la charge prévue à ce que j'ai réellement fait"

Comportement attendu : L'assistant appelle workout_list avec la plage de dates de la semaine, puis season_readLoadProgress pour obtenir la charge prévue vs réalisée. Il présente un résumé montrant chaque séance, sa charge cible, si elle a été complétée, et l'équilibre de charge global de la semaine.

2. Créer une séance

Prompt : "Crée un footing au seuil d'1 heure pour lundi avec un RPE de 70 et ajoute-le au calendrier"

Comportement attendu : L'assistant appelle date_weekStart et date_add pour calculer la date du prochain lundi, puis workout_create avec sport=RUNNING__GENERIC, duration=3600s, effort=70, et un titre descriptif. Il confirme la séance créée avec sa date, son sport et son estimation de charge.

3. Analyse de saison

Prompt : "Regarde mon plan de saison actuel et dis-moi si je suis en phase avec la progression de charge prévue"

Comportement attendu : L'assistant appelle season_list pour trouver la saison en cours, puis season_read pour obtenir la planification détaillée (périodes, cycles, charges cibles par semaine), et season_readLoadProgress pour obtenir la charge réellement exécutée. Il compare prévu vs réalisé semaine par semaine et signale tout écart significatif.

7. Gestion des clés API

Tu peux créer plusieurs clés API (par ex. une par appareil ou par client)
Les clés peuvent être révoquées à tout moment depuis Paramètres > Assistant
Révoquer une clé bloque immédiatement tout accès
Les clés ne sont affichées qu'une seule fois à la création — copie-les en lieu sûr

8. Confidentialité et sécurité

Le serveur MCP fournit le même accès aux données que l'assistant intégré Slek
Ton client IA fournit le modèle IA — Slek fournit uniquement les données et les outils
Les clés API et tokens OAuth peuvent être révoqués à tout moment
Les tokens d'accès OAuth expirent après 1 heure et sont automatiquement rafraîchis
Les refresh tokens OAuth expirent après 30 jours
Les données de session (contexte de l'athlète actif) sont conservées 24 heures puis supprimées
Toute la communication utilise HTTPS
Slek ne stocke ni les conversations ni les prompts envoyés via MCP — ceux-ci restent chez ton client IA

9. Limitations

Le serveur MCP nécessite un abonnement Premium
Le modèle IA est fourni par ton client (Claude, Mistral, etc.) — Slek ne contrôle pas la qualité ni le coût du modèle
La validation des actions (confirmer avant de créer/modifier/supprimer) dépend des capacités de ton client IA
Les activités sont en lecture seule — elles ne peuvent pas être créées ou modifiées via MCP (elles proviennent des appareils connectés)