Connecter un assistant AI à une clé API

Tous les assistants AI ne peuvent pas se connecter au FitnessSyncer MCP Server à votre place. Beaucoup ne fournissent qu'une adresse de serveur et un champ pour saisir un jeton, tandis que d'autres lisent l'intégralité de leur configuration à partir d'un fichier sur le disque. Pour ces derniers, FitnessSyncer délivre une clé API, qui est un jeton unique à longue durée de vie remplaçant l'ensemble de la procédure de connexion.

C'est ainsi que Mistral Vibe s'intègre, et c'est également la solution idéale pour un assistant auto-hébergé, un client en ligne de commande, un framework d'agent ou un ChatGPT qui vous propose un en-tête plutôt qu'un écran OAuth. Claude, ChatGPT, Perplexity et Home Assistant disposent chacun de leur propre procédure de connexion ; privilégiez donc leurs instructions spécifiques lorsque cela s'applique.

Avant de commencer

• Un compte FitnessSyncer avec vos sources connectées. Le MCP Server est inclus avec chaque compte, vous n'avez donc rien à acheter en plus ; consultez la rubrique « Pour commencer » si vous êtes nouveau. Un compte gratuit donne accès à un historique moins long ici, exactement comme partout ailleurs sur le site.
• Un assistant capable d'envoyer un en-tête « Authorization », ou qui désigne cette même information sous le nom de « Bearer Token » ou de « jeton API ». Si le vôtre permet de se connecter avec OAuth à la place, c'est la meilleure solution, car vous choisissez les autorisations à chaque fois plutôt qu'une seule fois.

Étape 1 : Créez votre clé API sur FitnessSyncer

1. Accédez à la page « Comptes développeurs ».
2. Au bas de la page, sélectionnez « MCP : Clé API » dans la liste, puis cliquez sur « Créer ».
3. FitnessSyncer vous demande quelles autorisations cette clé doit comporter. Sélectionnez uniquement les actions que vous souhaitez que l'assistant effectue ; pour répondre aux questions, les autorisations de lecture suffisent, et aucune des options que vous ne cochez pas ne pourra être utilisée par la suite sans créer une nouvelle clé.
4. Sélectionnez « Créer une clé API », puis notez la clé API qui s'affiche sur la page suivante. Elle n'est affichée qu'une seule fois ; si vous la perdez, vous pouvez la régénérer, mais vous devrez alors la saisir à nouveau dans votre assistant.

  Step 2: Mistral Vibe

Une fois votre clé API en votre possession :

1. Dans le menu de gauche, sélectionnez « Contexte », puis « Connecteurs ».
2. Sélectionnez « Ajouter un connecteur » dans le coin supérieur droit de l'écran.
3. Sélectionnez le connecteur personnalisé MCP.
4. Saisissez « FitnessSyncer » comme nom
5. Saisissez « https://www.fitnesssyncer.com/services/mcp » pour le serveur
6. Sélectionnez « Authentification par jeton API » et collez votre clé API dans le champ « Jeton Bearer ».

Étape 2 : Tout autre assistant doté d'un écran de paramètres

Les champs portent des noms différents d'un assistant à l'autre, mais il n'y en a jamais que trois :

1. Saisissez « FitnessSyncer » comme nom
2. Saisissez « https://www.fitnesssyncer.com/services/mcp » dans le champ « Serveur », que certains assistants appellent « URL du serveur distant MCP ».
3. Saisissez votre clé API dans le champ « Bearer Token ». Si l'assistant vous demande plutôt un en-tête, le nom de cet en-tête est « Authorization » et sa valeur est le mot « Bearer », suivi d'un espace, puis de votre clé API.

Si l'assistant vous demande également de choisir un protocole de transport, sélectionnez « Streamable HTTP ». FitnessSyncer ne propose pas l'ancien protocole SSE.

Étape 2 : un assistant configuré à partir d'un fichier

De nombreux clients en ligne de commande et de bureau lisent les paramètres de leurs serveurs à partir d’un fichier JSON. Le format varie, vous devez donc vous référer à la documentation de votre assistant, mais il se présente généralement comme suit :

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

Remplacez « YOUR_TOKEN_HERE » par votre clé API, en conservant le mot « Bearer » et l'espace qui le précède.

Essayez-le

Lancez une nouvelle conversation et collez l'un de ces messages pour vérifier que tout fonctionne correctement :

• Répertorier toutes les applications et tous les appareils auxquels FitnessSyncer est actuellement connecté pour mon compte, et indiquer la date de leur dernière synchronisation.
• Comment ai-je dormi cette semaine par rapport à la semaine dernière ?
• Comment a évolué ma fréquence cardiaque au repos au cours du dernier mois ?

Vous trouverez bien d'autres idées sur la page MCP Server.