FitnessSyncer AI en MCP Server

De FitnessSyncer MCP Server koppelt je account aan een AI-assistent, zodat je in gewone taal vragen kunt stellen over je eigen gezondheids- en fitnessgegevens in plaats van daar zelf een rapport over te moeten maken. Vraag bijvoorbeeld hoe je hartslag in rust zich sinds januari heeft ontwikkeld, of je beter slaapt op de dagen dat je traint, of welke bron vorige week niet meer synchroniseerde, en de assistent geeft antwoord op basis van jouw gegevens in plaats van algemene informatie. Hij kan ook een notitie voor je vastleggen, zodat je tijdens hetzelfde gesprek je gewicht kunt doorgeven of een opmerking kunt dicteren.

Het werkt met de Assist-functie van Claude, ChatGPT, Perplexity, Mistral en Home Assistant, en met elke assistent die zich kan authenticeren met een Bearer-token of een API-sleutel. Het is bij elk account inbegrepen, dus je hoeft niets extra's aan te schaffen; bij een gratis account is de geschiedenis hier gewoon korter, net zoals dat overal elders op de site het geval is. Hieronder vind je de configuratiehandleiding.

Voor sommige geavanceerde instellingen moet je nog steeds de FitnessSyncer-website of -app gebruiken.

Voorbeelden van opdrachten

Nadat je FitnessSyncer hebt aangesloten, kun je een van de onderstaande opdrachten in Claude, ChatGPT, Perplexity of Mistral plakken. Dit zijn slechts voorbeelden; je kunt de onderwerpen naar eigen inzicht combineren.

Dagelijkse gezondheidscontroles

Hiermee krijg je snel een idee van “hoe gaat het met me?”.

• Geef me een wekelijks gezondheidsoverzicht op basis van alles wat FitnessSyncer over mij weet, inclusief activiteit, slaap, gewicht, bloeddruk en bloedglucose (indien beschikbaar). Wijs me op alles wat buiten mijn normale bereik lijkt te vallen.
• Geef een overzicht van mijn gezondheid in de afgelopen 30 dagen en benadruk de drie belangrijkste punten waarop ik me moet richten om mijn algehele gezondheid te verbeteren.
• Als ik naar mijn recente FitnessSyncer-gegevens kijk, wat is er de afgelopen maand het meest veranderd: activiteit, slaap, gewicht, bloeddruk of bloedsuikerspiegel?
• Geef me van 1 januari tot en met 31 januari een overzicht van mijn gezondheid en laat me weten welke dagen er ongewoon goed of ongewoon slecht uitzagen.
• Is er de laatste tijd daadwerkelijk iets veranderd in mijn gezondheidsgegevens? Vertel me alleen over echte veranderingen, en niet over normale schommelingen van week tot week.
• Vergelijk de afgelopen vier weken met de drie maanden daarvoor en laat me weten welke van mijn statistieken zijn veranderd, in welke richting en met hoeveel.

Activiteit en training

Concentreer je op het aantal stappen, de afstand en de trainingsbelasting.

• Ben ik deze week actiever geweest dan vorige week? Gebruik de maatstaf (aantal stappen of afstand) die ik normaal gesproken in FitnessSyncer gebruik en leg het verschil uit.
• Geef me een overzicht van mijn trainingen van de afgelopen 30 dagen, inclusief de totale afstand, de duur, het aantal calorieën en de trainingstypen die ik het vaakst doe.
• Is mijn dagelijkse aantal stappen de afgelopen 90 dagen gestegen of gedaald? Geef ook aan hoe groot de verandering is en of deze statistisch gezien klein of significant is.
• Vergelijk mijn activiteiten van deze maand met die van vorige maand en laat me weten of ik, gezien mijn recente patronen, genoeg doe voor mijn algemene gezondheid.
• Wat was mijn snelste mijl van de afgelopen 30 dagen, en tijdens welke loop was dat?
• Laat me de tussentijden per mijl van mijn laatste hardloopsessie zien en vertel me of ik een gelijkmatig tempo heb aangehouden.
• Laat me mijn tussentijden per 100 yard zien van mijn laatste zwemsessie in het zwembad.

Hartslag, HRV en herstel

Hartslag in rust, hartslagzones, HRV, VO₂max en andere herstelindicatoren.

• Geef me een overzicht van mijn hartgezondheid van de afgelopen 30 dagen: hartslag in rust, HRV, hartslag tijdens de slaap en de tijd die ik in elke hartslagzone heb doorgebracht.
• Hoe heeft mijn hartslag in rust zich de afgelopen 30 dagen ontwikkeld? Gaat deze omhoog of omlaag?
• Vergelijk mijn HRV ’s nachts met mijn HRV overdag van de afgelopen twee weken en laat me weten of het erop lijkt dat ik goed herstel tussen de trainingen door.
• Wat is mijn huidige VO2max en hoe heeft deze zich de afgelopen 90 dagen ontwikkeld?
• Is mijn HRV vandaag laag in vergelijking met mijn normale waarde? Is er op dit moment nog iets anders dat voor mij ongebruikelijk is?

ECG opnames

Het vastleggen van metagegevens, geschiedenisoverzichten en contextgegevens van verschillende aanbieders voor ECG’s die zijn gesynchroniseerd vanuit Apple Watch, Fitbit Sense, Withings en andere apparaten die ECG ondersteunen. De classificatie wordt altijd door het opnameapparaat gerapporteerd, is niet bedoeld voor diagnostisch gebruik en de golfvorm zelf wordt nooit teruggestuurd.

• Hoeveel ECG-metingen heb ik dit jaar gedaan, en wat bleek daaruit?
• Laat me mijn laatste paar ECG-opnames zien en markeer degene die geen sinusritme vertoonden.
• Had ik cafeïne gedronken of ongewoon weinig geslapen vóór mijn meest recente ECG?

Gewicht en lichaamssamenstelling

Trendgerichte aanwijzingen die een momentopname en een richtlijn combineren.

• Hoe is mijn gewicht de afgelopen 3 maanden veranderd? Geef mijn gemiddelde gewicht, de totale verandering en of het gewicht stijgt, daalt of stabiel blijft.
• Wat is mijn gemiddelde lichaamsvetpercentage deze maand en hoe verhoudt dat zich tot vorige maand? Laat me weten of het verschil significant is.
• Ik probeer ongeveer 0,5 kg (of 1 lb) per week af te vallen. Ligt ik, gezien mijn recente gewichtsontwikkeling, ongeveer op schema?
• Bereken aan de hand van mijn recente FitnessSyncer-gegevens hoe lang het zou duren voordat ik 75 kg weeg, als mijn huidige gewichtsontwikkeling zich voortzet.

Bloeddruk en cardiovasculaire gezondheid

Handig voor mensen die samen met hun arts hun hoge bloeddruk in de gaten houden.

• Geef me een overzicht van mijn bloeddruk over de afgelopen 90 dagen, inclusief gemiddelden, minimum- en maximumwaarden en mijn AHA-classificatie. Leg in begrijpelijke taal uit wat die classificatie inhoudt.
• Ligt mijn bloeddruk deze maand over het algemeen binnen het normale bereik, of zijn er veel verhoogde waarden of gevallen van hypertensie? Wijs eventuele zorgwekkende patronen aan.
• Is mijn bloeddruk de afgelopen 3 maanden gestegen of gedaald, en wat was mijn meest recente meting?
• Welke praktische vragen zou ik, op basis van mijn bloeddrukmetingen van de afgelopen 30 dagen, met mijn arts moeten bespreken?

Glucose en diabetes

Vergelijkingen van ‘tijd binnen het bereik’ en ‘recent versus eerder’.

• Wat zijn mijn gemiddelde bloedglucosewaarde, de tijd binnen het streefbereik en de geschatte A1C-waarde van de afgelopen 14 dagen op basis van mijn FitnessSyncer-gegevens? Vergelijk dit met de voorgaande 14 dagen.
• Heb ik de afgelopen maand de gebruikelijke streefwaarde voor de tijd binnen het doelbereik voor mensen met diabetes gehaald? Leg uit in hoeverre ik dicht bij dat doel zit.
• Hoe verhoudt mijn glucosewaarde van deze week zich tot die van vorige week? Geef het gemiddelde, de variabiliteit en de tijd binnen het streefbereik weer.
• Als ik naar mijn bloedsuikerspiegel van de afgelopen 90 dagen kijk, zijn er dan bepaalde momenten op de dag of bepaalde dagen van de week waarop mijn bloedsuikerspiegel vaak hoog of laag is?

Slaap en herstel

Leg de nadruk op consistentie, duur en kwaliteit.

• Heb ik de afgelopen 30 dagen gemiddeld minstens 7 uur slaap gehad? Vermeld indien mogelijk de duur van de lichte slaap, diepe slaap en REM-slaap.
• Is mijn slaappatroon de afgelopen maand consistent geweest, of ga ik op heel verschillende tijden naar bed en sta ik op? Geef eventuele grote verschuivingen aan.
• Geef een overzicht van mijn slaap van de afgelopen week en wijs eventuele nachten aan waarin ik ongewoon kort heb geslapen of waarin mijn slaapefficiëntie laag was.
• Als ik naar de afgelopen 3 maanden kijk, hoe verhoudt mijn slaap zich dan tot mijn activiteit? Hebben dagen met meer activiteit doorgaans een positief of negatief effect op mijn slaap?

Menselijke cyclus bijhouden

Vraag naar de huidige dag van je cyclus, de fase en de voorspellingen, zonder dat je zelf de datum hoeft uit te rekenen.

• Op welke dag van mijn cyclus zit ik, en wanneer kan ik mijn volgende menstruatie verwachten?
• Wanneer is mijn vruchtbare periode deze cyclus?
• Wat is de gemiddelde cyclusduur geweest van mijn laatste paar geregistreerde cycli in FitnessSyncer?

Doelstellingen en verantwoordingsplicht

Opdrachten die gebruikmaken van opgeslagen doelen of ad-hocdoelen.

• Heb ik in FitnessSyncer gezondheidsdoelen vastgesteld en haal ik die deze week? Geef een samenvatting van elk doel en de stand van zaken.
• Stel in FitnessSyncer een doel in om minstens 8.000 stappen per dag te lopen en controleer vervolgens of het doel is aangemaakt.
• Ik wil streven naar 10.000 stappen per dag en 7 uur slaap per nacht. Controleer, zonder deze als doelen op te slaan, of mijn recente gegevens aangeven dat ik op schema lig.
• Stel op basis van mijn huidige trends op het gebied van stappen, slaap en gewicht realistische doelen voor de komende 30 dagen voor en stel deze voor mij in.

Ranglijsten

Berichten over de FitnessSyncer Leaderboards die je organiseert of waaraan je deelneemt. Je assistent kan ze lezen; aanmelden, afmelden en een FitnessSyncer Leaderboards opzetten doe je in FitnessSyncer.

• Hoe doe ik het in mijn FitnessSyncer Leaderboards? Vertel me mijn positie in elke categorie, wie er boven mij staat en met hoeveel verschil.
• Kijk eens naar de FitnessSyncer Leaderboard die ik heb opgesteld en laat me weten welke deelnemers nog geen gegevens hebben, en waarom.

Aantekeningen en bewerkingen in het notitieboek

Vertel de AI eenvoudig wat er is gebeurd, zodat dit in je FitnessSyncer Notebook wordt vastgelegd.

• Een bloeddrukwaarde noteren in mijn FitnessSyncer Notebook: 118 over 76, hartslag 62, vanochtend om 8.00 uur gemeten, met de opmerking dat ik me ontspannen voelde.
• Noteer de nuchtere bloedglucosewaarde van 95 mg/dL van vanochtend in mijn notitieboekje, met het label ‘Voor het ontbijt’.
• Voeg de slaap van gisteravond, van 23.00 uur tot 07.00 uur, toe aan mijn notitieboek, bereken hoeveel uur ik heb geslapen en voeg een opmerking toe dat ik rond 03.00 uur één keer wakker ben geworden.
• Wat waren de laatste drie notities die ik vandaag heb toegevoegd, en kun je ze even voor me samenvatten?
• De bloeddrukwaarde die je zojuist hebt toegevoegd, heeft een verkeerde hartslag; die zou 58 moeten zijn. Zoek dat record op en corrigeer de hartslagwaarde.
• Ik noteer de cholesterolwaarden in mijn FitnessSyncer Notebook op basis van de laboratoriumuitslagen van vandaag: totaal cholesterol 180 mg/dL, LDL 100 mg/dL, HDL 50 mg/dL, triglyceriden 120 mg/dL.
• Ik noteer de gegevens van mijn cyclus van vandaag in mijn FitnessSyncer Notebook: matige menstruatie, basale lichaamstemperatuur 36,7 °C, baarmoederhalsslijm met de consistentie van eiwit.
• Voeg penicilline toe als allergie in mijn FitnessSyncer Notebook, met de opmerking dat het netelroos veroorzaakt.
• Aantekening: ik ben vandaag begonnen met het innemen van 10 mg Lisinopril, eenmaal daags, in mijn FitnessSyncer Notebook.
• Voeg diabetes type 2 toe als aandoening in mijn FitnessSyncer Notebook, vorig jaar vastgesteld.
• Welke allergieën, aandoeningen en medicijnen staan er momenteel in FitnessSyncer geregistreerd?
• Ik heb de krachttraining van 30 minuten die ik vandaag heb gedaan handmatig bijgehouden in mijn FitnessSyncer Notebook, waarbij ik ongeveer 250 calorieën heb verbrand.

Bronnen, synchronisatie en probleemoplossing

Bekijk uw FitnessSyncer bronnen en bestemmingen en los enkele problemen op.

• Geef een overzicht van alle apps en apparaten waarmee FitnessSyncer momenteel is verbonden voor mijn account, en laat zien wanneer ze voor het laatst zijn gesynchroniseerd.
• Geef een overzicht van mijn geconfigureerde bestemmingen, of ze zijn ingeschakeld en wanneer ze voor het laatst zijn uitgevoerd.
• Ververs mijn Coros-bron en laat me weten of de synchronisatie succesvol is gestart.
• Voer nu mijn Strava-bestemming uit, zodat mijn meest recente trainingen worden gesynchroniseerd, en controleer of de synchronisatie in de wachtrij is geplaatst.

Eenheden, voorkeuren en personalisatie

Maak duidelijk dat de medewerker de voorkeuren op een natuurlijke manier kan afhandelen.

• Welke eenheden gebruik je in FitnessSyncer voor mijn gewicht, afstand, bloedsuikerspiegel en temperatuur?
• Voor welke statistieken kun je in FitnessSyncer trends bijhouden of vergelijkingen maken tussen verschillende periodes?
• Pas mijn instellingen aan zodat afstand in mijlen wordt weergegeven, gewicht in pond en glucose in mg/dL, en bevestig vervolgens de wijziging.
• Wat is mijn gemiddelde gewicht van de afgelopen 30 dagen? Geef dit weer in de eenheden van mijn voorkeur en laat me weten hoe dit is veranderd ten opzichte van de voorgaande 30 dagen.
• Werk mijn FitnessSyncer-profiel bij met mijn huidige lengte, geboortedatum en glucosedrempels, en geef vervolgens een overzicht van mijn bijgewerkte instellingen.

Meerstaps-workflows voor „gevorderde gebruikers“

Hieruit blijkt hoe de MCP-server op basis van meerdere factoren tot een conclusie komt.

• Als ik naar de gegevens van de afgelopen 3 maanden van mijn FitnessSyncer kijk, wat zijn dan de belangrijkste trends op het gebied van activiteit, gewicht, slaap en bloeddruk? Geef voor elk van deze punten aan of de trend verbetert, verslechtert of stabiel is.
• Stel op basis van mijn huidige gewicht, slaap en aantal stappen een eenvoudig plan van vier weken voor, met doelen voor elk gebied die realistisch zijn en niet te extreem.
• Zoek in de afgelopen 90 dagen naar weken waarin ik slecht heb geslapen en mijn hartslag in rust of mijn bloeddruk hoger was dan normaal. Beschrijf die weken en wat er veranderd is.
• Gebruik FitnessSyncer om al mijn gewichtsnotities uit mijn notitieboekje van het afgelopen jaar weer te geven, mijn laagste en hoogste punten te bepalen en uit te leggen hoe ik tussen die twee punten in ben geëvolueerd.

Aan de slag

Aan de slag gaan is eenvoudig. Als je nog geen FitnessSyncer-gebruiker bent of je account nog niet hebt geconfigureerd, raden we je aan hier te beginnen om je account in te stellen. De AI-assistenten krijgen nooit je accountwachtwoord te zien. Ze gebruiken een OAuth-app die je aanmaakt met een Client ID en Client Secret. Je kunt de toegang op elk moment intrekken via je FitnessSyncer-profiel of de ontwikkelaarsconfiguratie.

Zodra je account is ingesteld, moet je een API-profiel aanmaken om te integreren met je AI-assistent. Dit klinkt ingewikkeld, maar het is eigenlijk heel eenvoudig.

1. Ga naar de pagina ‘Ontwikkelaarsaccounts’.
2. Selecteer onderaan de pagina je AI-assistent uit de lijst en klik op ‘Aanmaken’. Als je deze niet ziet, kies dan ‘MCP: API-sleutel’.
3. Als je een AI-assistent hebt geselecteerd die we standaard ondersteunen, noteer dan op de volgende pagina de Client-ID en het Client-geheim, want die heb je nodig bij het configureren van je assistent.
   
   Als je de API-sleutel hebt geselecteerd, vraagt FitnessSyncer je op de volgende pagina om alle machtigingen die je aan deze AI-assistent wilt toekennen. Selecteer de opties die u wilt vrijgeven en klik op ‘API-sleutel aanmaken’. Op de volgende pagina wordt uw API-sleutel weergegeven, die u nodig hebt om uw assistent te configureren.
   
   Opmerking: De Client Secret en API-sleutel worden alleen de eerste keer weergegeven; als u ze kwijtraakt, kunt u deze altijd opnieuw genereren, maar dan moet u uw assistent ook opnieuw configureren.
4. Volg de instructies voor je eigen assistent, waarnaar hieronder een link staat.

Uw AI-assistent kan aanbieden om zichzelf automatisch bij FitnessSyncer te registreren, onder een naam als ‘Automatisch registreren’, ‘Dynamische clientregistratie’ of ‘De gepubliceerde identiteit van Claude gebruiken’. FitnessSyncer ondersteunt geen automatische registratie, dus kies altijd de optie waarmee u de Client ID en Client Secret kunt invoeren die u hierboven hebt aangemaakt.

Je assistent kan je ook melden dat OpenID Connect, een client-metadatadocument of CIMD niet beschikbaar is omdat FitnessSyncer dit niet heeft aangekondigd. Dat is te verwachten en het belemmert de verbinding niet. FitnessSyncer houdt uw accountprofiel bewust buiten de integratie, en uw assistent heeft alleen de Client ID en Client Secret nodig.

Instructies voor je assistent

Elke assistent vraagt om dezelfde twee dingen: het serveradres en de sleutels die je zojuist hebt aangemaakt, en elk slaat deze op een andere plek op. Kies de jouwe:

• Claude, toegevoegd als een aangepaste connector die inlogt met je eigen OAuth-client.
• ChatGPT, toegevoegd als een aangepaste MCP-server vanuit ChatGPT op het web.
• Perplexity, toegevoegd als aangepaste connector via het Streamable HTTP-transport.
• Home Assistant, zodat de Assist-functie zowel via spraak als via chat kan antwoorden.
• Mistral Vibe, en alles wat een bearer-token vereist, inclusief een client die via een bestand is geconfigureerd.