Tilslutning af en AI-assistent med en API-nøgle
Det er ikke alle AI-assistenter, der kan logge ind på FitnessSyncer MCP Server på dine vegne. Mange tilbyder kun en serveradresse og et felt til indtastning af et token, og nogle henter hele deres konfiguration fra en fil på disken. Til disse udsteder FitnessSyncer en API-nøgle, som er et enkelt token med lang levetid, der fungerer som erstatning for hele log-in-processen.
Sådan opretter Mistral Vibe forbindelse, og det er også løsningen til en selvhostet assistent, en kommandolinjeklient, et agent-framework eller en ChatGPT, der viser en overskrift i stedet for en OAuth-skærm. Claude, ChatGPT, Perplexity og Home Assistant har hver deres egen login-procedure, så følg de respektive instruktioner, hvor det er relevant.
Før du går i gang
- En FitnessSyncer-konto, hvor dine kilder er tilknyttet. MCP Server følger med hver konto, så der er ikke noget ekstra, du skal købe; se »Kom godt i gang«, hvis du er ny bruger. En gratis konto giver her adgang til en kortere historik, præcis som det er tilfældet alle andre steder på siden.
- En assistent, der kan sende en »Authorization«-header, eller som kalder det samme for et »Bearer Token« eller et »API-token«. Hvis din i stedet kan logge ind med OAuth, er det den bedste løsning, fordi du så vælger tilladelserne hver gang i stedet for kun én gang.
En API-nøgle er en adgangskode til de tilladelser, du giver den, og den udløber ikke af sig selv. Indtast kun en sådan nøgle i en assistent, som du stoler på med dine sundhedsdata, og giv den kun de minimalt nødvendige tilladelser.
Trin 1: Opret din API-nøgle på FitnessSyncer
- Gå til siden »Udviklerkonti«.
- Nederst på siden skal du vælge »MCP: API-nøgle« fra listen og klikke på »Opret«.
- FitnessSyncer spørger, hvilke tilladelser denne nøgle skal have. Vælg kun det, du ønsker, at assistenten skal udføre; til at besvare spørgsmål er læsetilladelserne tilstrækkelige, og intet af det, du ikke markerer, kan bruges senere uden at oprette en ny nøgle.
- Vælg »Opret API-nøgle«, og noter API-nøglen på den næste side. Den vises kun én gang; hvis du mister den, kan du generere en ny, men du bliver så nødt til at indtaste den i din assistent igen.
Step 2: Mistral Vibe
Når du har din API-nøgle klar:
- Vælg »Context« i menuen til venstre og derefter »Connectors«.
- Vælg »Tilføj forbindelse« i skærmens øverste højre hjørne.
- Vælg brugerdefineret MCP-stik.
- Indtast »FitnessSyncer« som navn
- Indtast »https://www.fitnesssyncer.com/services/mcp« som server
- Vælg »API-token-godkendelse«, og indsæt din API-nøgle i feltet »Bearer-token«.
Trin 2: Enhver anden assistent med en indstillingsskærm
Felterne har forskellige navne fra den ene assistent til den næste, men der er altid kun tre:
- Indtast »FitnessSyncer« som navn
- Indtast https://www.fitnesssyncer.com/services/mcp som server, hvilket nogle assistenter kalder URL’en til den eksterne MCP-server
- Indtast din API-nøgle i feltet »Bearer Token«. Hvis assistenten i stedet beder om en header, skal navnet på headeren være »Authorization«, og værdien skal være ordet »Bearer«, et mellemrum og din API-nøgle.
Hvis assistenten også beder dig om at vælge en transportform, skal du vælge »Streamable HTTP«. FitnessSyncer understøtter ikke den ældre SSE-transportform.
Trin 2: En assistent, der er konfigureret ud fra en fil
Mange kommandolinje- og desktop-klienter henter oplysninger om deres servere fra en JSON-fil. Formatet varierer, så følg vejledningen til netop din assistent, men det ser normalt sådan ud:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Erstat YOUR_TOKEN_HERE med din API-nøgle, og sørg for at beholde ordet »Bearer« og mellemrummet foran det.
Prøv det
Start en ny chat, og indsæt et af følgende for at kontrollere, at alt fungerer:
- Vis en liste over alle de apps og enheder, som FitnessSyncer i øjeblikket er forbundet med på min konto, og angiv, hvornår de sidst blev synkroniseret.
- Hvordan har jeg sovet i denne uge sammenlignet med sidste uge?
- Hvordan har min hvilepuls udviklet sig i løbet af den sidste måned?
Der er mange flere ideer på MCP Server-siden.
Din AI-assistent forklarer dine måleresultater ud fra de offentlige retningslinjer; dette er ikke lægelig rådgivning.
Skal jeg bruge en API-nøgle eller logge ind?
Log ind, hvor din assistent understøtter det. Ved en OAuth-login bliver du spurgt, hvilke tilladelser du vil give, i det øjeblik du opretter forbindelse, og disse kan tilbagekaldes for netop den forbindelse; en API-nøgle beholder de indstillinger, du valgte, da du oprettede den, så længe den eksisterer.
Brug en API-nøgle, når assistenten ikke kan logge ind, hvilket er tilfældet for Mistral Vibe og for de fleste klienter, der er konfigureret via en fil.
Kan jeg ændre, hvad en API-nøgle må gøre?
Ikke efterfølgende. Rettighederne fastlægges, når nøglen oprettes, så hvis du vil udvide eller indskrænke dem, skal du slette nøglen i »Developer Configuration« og oprette en ny med de ønskede rettigheder. Din assistent skal derefter have den nye nøgle.
Jeg har mistet min API-nøgle. Hvad skal jeg nu gøre?
Nøglen vises kun, når den oprettes, så der er ikke noget at slå op. Generer den på ny under »Udviklerkonfiguration«, og indtast den nye nøgle i din assistent. Den gamle nøgle holder op med at virke, så snart du genererer den på ny – og det er også sådan, du spærrer en assistent, som du ikke længere stoler på.
Hvordan afmelder jeg en assistent?
Fjern stikket i assistenten, og slet derefter nøglen i »Developer Configuration«. Det er sletningen af nøglen, der er afgørende, da alt, der stadig har forbindelse til den, ellers vil fortsætte med at fungere.
