Een AI-assistent koppelen aan een API-sleutel
Niet elke AI-assistent kan namens jou inloggen op de FitnessSyncer MCP Server. Veel assistenten bieden alleen een serveradres en een veld om een token in te voeren, en sommige lezen hun volledige configuratie uit een bestand op de schijf. Voor die assistenten geeft FitnessSyncer een API-sleutel uit, een enkel token met een lange geldigheidsduur dat de volledige aanmelding vervangt.
Zo maakt Mistral Vibe verbinding, en dit is ook de oplossing voor een zelfgehoste assistent, een opdrachtregelclient, een agentframework of een ChatGPT die je een header biedt in plaats van een OAuth-scherm. Claude, ChatGPT, Perplexity en Home Assistant hebben elk hun eigen aanmeldingsprocedure, dus volg waar mogelijk hun eigen instructies.
Voordat je begint
- Een FitnessSyncer-account waarmee je bronnen zijn gekoppeld. De MCP Server is bij elk account inbegrepen, dus je hoeft niets extra’s aan te schaffen; zie ‘Aan de slag’ als je nieuw bent. Een gratis account biedt hier toegang tot een kortere geschiedenis, net zoals elders op de site.
- Een assistent die een Authorization-header kan verzenden, of die dit ook wel een Bearer-token of een API-token noemt. Als die van jou in plaats daarvan kan inloggen met OAuth, is dat de betere optie, omdat je dan elke keer zelf de machtigingen kiest in plaats van slechts één keer.
Een API-sleutel is een wachtwoord voor de rechten die je eraan toekent, en deze verloopt niet vanzelf. Gebruik er alleen een in een assistent die je vertrouwt met je gezondheidsgegevens, en geef hem zo min mogelijk rechten als nodig is.
Stap 1: Maak je API-sleutel aan op FitnessSyncer
- Ga naar de pagina ‘Ontwikkelaarsaccounts’.
- Selecteer onderaan de pagina “MCP: API-sleutel” uit de lijst en klik op “Aanmaken”.
- FitnessSyncer vraagt welke rechten deze sleutel moet hebben. Selecteer alleen wat je wilt dat de assistent doet; voor het beantwoorden van vragen zijn de leesrechten voldoende, en alles wat je niet aanvinkt, kan later niet worden gebruikt zonder een nieuwe sleutel aan te maken.
- Kies ‘API-sleutel aanmaken’ en noteer de API-sleutel op de volgende pagina. Deze wordt slechts één keer weergegeven; als je hem kwijtraakt, kun je hem opnieuw genereren, maar dan moet je hem opnieuw invoeren in je assistent.
Step 2: Mistral Vibe
Zodra je je API-sleutel hebt:
- Selecteer in het menu aan de linkerkant ‘Context’ en vervolgens ‘Connectors’.
- Kies ‘Connector toevoegen’ in de rechterbovenhoek van het scherm.
- Selecteer de aangepaste MCP-connector.
- Voer ‘FitnessSyncer’ in als naam
- Voer ‘https://www.fitnesssyncer.com/services/mcp’ in voor de server
- Selecteer ‘API-tokenverificatie’ en plak je API-sleutel in het veld ‘Bearer-token’.
Stap 2: Elke andere assistent met een instellingenscherm
De velden hebben bij elke assistent een andere naam, maar het zijn er altijd slechts drie:
- Voer ‘FitnessSyncer’ in als naam
- Voer https://www.fitnesssyncer.com/services/mcp in voor de server, die door sommige assistenten de URL van de externe MCP-server wordt genoemd
- Voer je API-sleutel in het veld ‘Bearer Token’ in. Als de assistent in plaats daarvan om een header vraagt, is de naam van de header ‘Authorization’ en is de waarde het woord ‘Bearer’, gevolgd door een spatie en je API-sleutel.
Als de assistent je ook vraagt om een transport te kiezen, selecteer dan ‘Streamable HTTP’. FitnessSyncer biedt het oudere SSE-transport niet aan.
Stap 2: Een assistent configureren op basis van een bestand
Veel opdrachtregel- en desktopclients lezen de gegevens van hun servers uit een JSON-bestand. De indeling varieert, dus raadpleeg de documentatie van je eigen assistent, maar meestal ziet het er als volgt uit:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Vervang YOUR_TOKEN_HERE door je API-sleutel, waarbij je het woord ‘Bearer’ en de spatie ervoor behoudt.
Probeer het eens
Begin een nieuw chatgesprek en plak een van deze teksten om te controleren of alles goed werkt:
- 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.
- Hoe heb ik deze week geslapen in vergelijking met vorige week?
- Hoe heeft mijn hartslag in rust zich de afgelopen maand ontwikkeld?
Op de MCP Server-pagina staan nog veel meer ideeën.
Uw AI-assistent geeft uitleg over uw meetresultaten aan de hand van officiële richtlijnen; dit is geen medisch advies.
Moet ik een API-sleutel gebruiken of inloggen?
Meld je aan via de methode die door je assistent wordt ondersteund. Bij een OAuth-aanmelding wordt je op het moment van verbinding gevraagd welke machtigingen je wilt verlenen, en deze kunnen voor die ene verbinding worden ingetrokken; een API-sleutel behoudt de instellingen die je bij het aanmaken hebt gekozen, zolang deze bestaat.
Gebruik een API-sleutel wanneer de assistent zich niet kan aanmelden, wat het geval is bij Mistral Vibe en bij de meeste clients die via een bestand zijn geconfigureerd.
Kan ik aanpassen wat een API-sleutel allemaal mag doen?
Niet achteraf. De machtigingen worden vastgelegd op het moment dat de sleutel wordt aangemaakt. Als je ze dus wilt uitbreiden of beperken, moet je de sleutel in ‘Developer Configuration’ verwijderen en een nieuwe aanmaken met de gewenste machtigingen. Je assistent heeft dan de nieuwe sleutel nodig.
Ik ben mijn API-sleutel kwijtgeraakt. Wat nu?
De sleutel wordt alleen weergegeven op het moment dat deze wordt aangemaakt, dus er valt niets op te zoeken. Genereer de sleutel opnieuw in de ontwikkelaarsconfiguratie en voer de nieuwe sleutel in bij je assistent. De oude sleutel werkt niet meer zodra je de sleutel opnieuw genereert; op die manier kun je ook een assistent uitsluiten die je niet langer vertrouwt.
Hoe kan ik een assistent uitschakelen?
Verwijder de connector in de assistent en verwijder vervolgens de sleutel in de ontwikkelaarsconfiguratie. Het verwijderen van de sleutel is het belangrijkste, want anders zou alles wat er nog aan gekoppeld is gewoon blijven werken.
