Ansluta en AI-assistent med en API-nyckel
Det är inte alla AI-assistenter som kan logga in på FitnessSyncer MCP Server åt dig. Många erbjuder endast en serveradress och ett fält där man kan ange en token, och vissa läser in hela sin konfiguration från en fil på disken. För dessa utfärdar FitnessSyncer en API-nyckel, vilket är en enda långvarig token som ersätter hela inloggningen.
Så här ansluter Mistral Vibe, och det är också lösningen för en egenhostad assistent, en kommandoradsklient, ett agentramverk eller en ChatGPT som visar en rubrik istället för en OAuth-skärm. Claude, ChatGPT, Perplexity och Home Assistant har var och en sin egen inloggning, så följ gärna deras egna instruktioner där det är tillämpligt.
Innan du börjar
- Ett FitnessSyncer-konto med dina källor kopplade. MCP Server ingår i varje konto, så du behöver inte köpa något extra; se ”Komma igång” om du är ny här. Ett gratiskonto har en kortare historik här, precis som på alla andra delar av webbplatsen.
- En assistent som kan skicka en Authorization-rubrik, eller som kallar samma sak för ett Bearer-token eller ett API-token. Om din istället kan logga in med OAuth, är det det bättre alternativet, eftersom du då väljer behörigheterna varje gång istället för en gång.
En API-nyckel är ett lösenord för de behörigheter du beviljar den, och den upphör inte att gälla av sig själv. Använd den endast i en assistent som du litar på när det gäller dina hälsouppgifter, och bevilja den endast de behörigheter som den absolut behöver.
Steg 1: Skapa din API-nyckel på FitnessSyncer
- Gå till sidan ”Utvecklarkonton”.
- Längst ner på sidan väljer du ”MCP: API-nyckel” i listan och klickar på ”Skapa”.
- FitnessSyncer frågar vilka behörigheter den här nyckeln ska ha. Välj endast de funktioner som du vill att assistenten ska utföra; för att besvara frågor räcker det med läsbehörigheter, och inga av de alternativ som du inte markerar kan användas senare utan att du skapar en ny nyckel.
- Välj ”Skapa API-nyckel” och anteckna API-nyckeln på nästa sida. Den visas bara en gång; om du tappar bort den kan du skapa en ny, men då måste du ange den i din assistent igen.
Step 2: Mistral Vibe
När du har din API-nyckel till hands:
- Välj ”Context” och sedan ”Connectors” i menyn till vänster.
- Välj ”Lägg till anslutning” i skärmens övre högra hörn.
- Välj anpassad MCP-kontakt.
- Ange ”FitnessSyncer” som namn
- Ange ”https://www.fitnesssyncer.com/services/mcp” som server
- Välj ”API-token-autentisering” och klistra in din API-nyckel i fältet ”Bearer-token”.
Steg 2: Alla andra assistenter med en inställningsskärm
Fälten har olika namn beroende på vilken assistent det gäller, men det finns alltid bara tre:
- Ange ”FitnessSyncer” som namn
- Ange https://www.fitnesssyncer.com/services/mcp som server, vilket vissa assistenter kallar URL:en för fjärrservern MCP
- Ange din API-nyckel i fältet ”Bearer Token”. Om assistenten istället ber om en rubrik ska rubriknamnet vara ”Authorization” och värdet ska bestå av ordet ”Bearer”, ett mellanslag och din API-nyckel.
Om assistenten dessutom ber dig att välja en transport, välj då ”Streamable HTTP”. FitnessSyncer erbjuder inte den äldre SSE-transporten.
Steg 2: En assistent som konfigureras utifrån en fil
Många kommandorads- och skrivbords klienter läser in sina servrar från en JSON-fil. Uppbyggnaden varierar, så följ dokumentationen för just din assistent, men vanligtvis ser den ut så här:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Ersätt YOUR_TOKEN_HERE med din API-nyckel, men behåll ordet ”Bearer” och mellanslaget framför det.
Prova det
Starta en ny chatt och klistra in något av följande för att kontrollera att allt fungerar:
- Visa en lista över alla appar och enheter som FitnessSyncer för närvarande är anslutna till mitt konto och ange när de senast synkroniserades.
- Hur sov jag den här veckan jämfört med förra veckan?
- Hur har min vilopuls utvecklats under den senaste månaden?
Det finns många fler idéer på sidan MCP Server.
Din AI-assistent förklarar dina mätvärden utifrån allmänna riktlinjer; detta utgör inte medicinsk rådgivning.
Ska jag använda en API-nyckel eller logga in?
Logga in där din assistent stöder det. Vid en OAuth-inloggning frågas du vilka behörigheter du vill bevilja just när du ansluter, och dessa kan återkallas för just den anslutningen; en API-nyckel behåller de behörigheter du valde när du skapade den, så länge den finns kvar.
Använd en API-nyckel när assistenten inte kan logga in, vilket är fallet för Mistral Vibe och för de flesta klienter som konfigureras via en fil.
Kan jag ändra vad en API-nyckel får göra?
Inte i efterhand. Behörigheterna fastställs när nyckeln skapas, så om du vill utvidga eller begränsa dem måste du ta bort nyckeln i utvecklarkonfigurationen och skapa en ny med de behörigheter du vill ha. Din assistent behöver då den nya nyckeln.
Jag har tappat bort min API-nyckel. Vad ska jag göra nu?
Nyckeln visas endast när den skapas, så det finns inget att slå upp. Skapa en ny nyckel i utvecklarkonfigurationen och ange den nya nyckeln i din assistent. Den gamla nyckeln slutar fungera så fort du skapar en ny, vilket också är sättet att spärra en assistent som du inte längre litar på.
Hur kopplar jag bort en assistent?
Ta bort anslutningen i assistenten och radera sedan nyckeln i utvecklarkonfigurationen. Det är just raderingen av nyckeln som är avgörande, eftersom allt som fortfarande är kopplat till den annars skulle fortsätta att fungera.
