Koble en AI-assistent til en API-nøkkel
Ikke alle AI-assistenter kan logge deg inn på FitnessSyncer MCP Server for deg. Mange tilbyr bare en serveradresse og et sted å legge inn et token, og noen henter hele konfigurasjonen fra en fil på disken. For disse utsteder FitnessSyncer en API-nøkkel, som er et enkelt token med lang levetid som erstatter hele påloggingen.
Slik kobler Mistral Vibe seg til, og dette er også løsningen for en selvhostet assistent, en kommandolinjeklient, et agentrammeverk eller en ChatGPT som gir deg en overskrift i stedet for en OAuth-skjerm. Claude, ChatGPT, Perplexity og Home Assistant har hver sin egen påloggingsprosess, så følg de respektive instruksjonene der det er aktuelt.
Før du begynner
- En FitnessSyncer-konto med kildene dine tilknyttet. MCP Server følger med hver konto, så du trenger ikke å kjøpe noe ekstra; se «Kom i gang» hvis du er ny bruker. En gratis konto gir tilgang til en kortere historikk her, akkurat som ellers på nettstedet.
- En assistent som kan sende en «Authorization»-overskrift, eller som kaller det samme for et «Bearer Token» eller et «API-token». Hvis din assistent i stedet kan logge inn med OAuth, er det den beste løsningen, fordi du da velger tillatelsene hver gang i stedet for bare én gang.
En API-nøkkel er et passord for de tillatelsene du gir den, og den utløper ikke av seg selv. Bruk den kun i en assistent du stoler på når det gjelder helsedataene dine, og gi den bare de minste nødvendige tillatelsene.
Trinn 1: Opprett API-nøkkelen din på FitnessSyncer
- Gå til siden «Utviklerkontoer».
- Nederst på siden velger du «MCP: API-nøkkel» fra listen og klikker på «Opprett».
- FitnessSyncer spør om hvilke tillatelser denne nøkkelen skal ha. Velg bare det du ønsker at assistenten skal gjøre; for å svare på spørsmål er lesetillatelsene tilstrekkelige, og ingenting du lar være avmerket, kan brukes senere uten at du oppretter en ny nøkkel.
- Velg «Opprett API-nøkkel», og noter deg API-nøkkelen på neste side. Den vises bare én gang; hvis du mister den, kan du generere en ny, men da må du legge den inn i assistenten din på nytt.
Step 2: Mistral Vibe
Når du har API-nøkkelen din klar:
- Velg «Kontekst» og deretter «Koblinger» fra menyen til venstre.
- Velg «Legg til kobling» øverst til høyre på skjermen.
- Velg «Egendefinert MCP-kontakt».
- Skriv inn «FitnessSyncer» som navn
- Skriv inn «https://www.fitnesssyncer.com/services/mcp» for serveren
- Velg «API-token-autentisering» og lim inn API-nøkkelen din i «Bearer-token».
Trinn 2: Enhver annen assistent med et innstillingsvindu
Feltene har forskjellige navn fra assistent til assistent, men det er alltid bare tre:
- Skriv inn «FitnessSyncer» som navn
- Skriv inn «https://www.fitnesssyncer.com/services/mcp» som server, noe som noen assistenter kaller URL-en til den eksterne MCP-serveren
- Skriv inn API-nøkkelen din i feltet «Bearer Token». Hvis assistenten i stedet ber om en header, er navnet på headeren «Authorization», og verdien er ordet «Bearer», et mellomrom og API-nøkkelen din.
Hvis assistenten også ber deg om å velge en transporttype, velger du «Streamable HTTP». FitnessSyncer tilbyr ikke den eldre SSE-transporttypen.
Trinn 2: En assistent konfigurert fra en fil
Mange kommandolinje- og skrivebordsklienter henter informasjon om serverne sine fra en JSON-fil. Oppsettet varierer, så sjekk dokumentasjonen til din egen assistent, men det ser vanligvis slik ut:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Erstatt YOUR_TOKEN_HERE med din API-nøkkel, og behold ordet «Bearer» og mellomrommet foran det.
Prøv det
Start en ny chat og lim inn et av disse for å sjekke at alt fungerer:
- Vis en liste over alle appene og enhetene som FitnessSyncer for øyeblikket er koblet til på min konto, og vis når de sist ble synkronisert.
- Hvordan har jeg sovet denne uken sammenlignet med forrige uke?
- Hvordan har hvilepulsen min utviklet seg den siste måneden?
Det finnes mange flere ideer på MCP Server-siden.
Din AI-assistent forklarer målingene dine ut fra offentlige retningslinjer; dette er ikke medisinsk rådgivning.
Skal jeg bruke en API-nøkkel eller logge inn?
Logg inn der assistenten din støtter dette. Ved en OAuth-pålogging blir du spurt om hvilke tillatelser du vil gi i det øyeblikket du kobler deg til, og disse kan trekkes tilbake for akkurat den forbindelsen; en API-nøkkel beholder de innstillingene du valgte da du opprettet den, så lenge den eksisterer.
Bruk en API-nøkkel når assistenten ikke kan logge seg på, noe som er tilfellet for Mistral Vibe og for de fleste klienter som er konfigurert via en fil.
Kan jeg endre hva en API-nøkkel har lov til å gjøre?
Ikke i etterkant. Tilgangstillatelsene fastsettes når nøkkelen opprettes, så hvis du vil utvide eller begrense dem, må du slette nøkkelen i «Developer Configuration» og opprette en ny med de tilgangstillatelsene du ønsker. Assistenten din trenger da den nye nøkkelen.
Jeg har mistet API-nøkkelen min. Hva skal jeg gjøre nå?
Nøkkelen vises bare når den opprettes, så det er ingenting å slå opp. Generer den på nytt i «Utviklerkonfigurasjon» og skriv inn den nye nøkkelen i assistenten din. Den gamle nøkkelen slutter å fungere så snart du genererer den på nytt, og det er også slik du sperrer en assistent du ikke lenger stoler på.
Hvordan kobler jeg fra en assistent?
Fjern koblingen i assistenten, og slett deretter nøkkelen i «Developer Configuration». Det er selve slettingen av nøkkelen som er avgjørende, fordi alt som fremdeles er koblet til den, ellers vil fortsette å fungere.
