AI-avustajan yhdistäminen API-avaimeen
Kaikki AI-avustajat eivät voi kirjautua FitnessSyncer MCP Server:een puolestasi. Monet tarjoavat vain palvelimen osoitteen ja paikan tunnuksen syöttämiselle, ja jotkut lukevat koko konfiguraationsa levyllä olevasta tiedostosta. Näille FitnessSyncer myöntää API-avaimen, joka on yksi pitkäkestoinen tunnus, joka korvaa koko kirjautumisen.
Näin Mistral Vibe muodostaa yhteyden, ja tämä on myös ratkaisu itse isännöityyn avustajaan, komentoriviohjelmaan, agenttikehykseen tai ChatGPT:een, joka tarjoaa otsikon OAuth-näytön sijaan. Claude, ChatGPT, Perplexity ja Home Assistant:lla on kullakin oma kirjautumistapansa, joten noudata niiden omia ohjeita, kun ne ovat sovellettavissa.
Ennen kuin aloitat
- FitnessSyncer-tili, johon lähteesi on liitetty. MCP Server sisältyy jokaiseen tiliin, joten mitään ylimääräistä ei tarvitse ostaa; katso ohjeet aloittelijoille, jos olet uusi käyttäjä. Ilmaistilin historiatiedot ulottuvat täällä vähemmän taaksepäin, aivan kuten muuallakin sivustolla.
- Apuohjelma, joka voi lähettää Authorization-otsikon tai joka käyttää siitä samaa termiä kuin Bearer-tunnus tai API-tunnus. Jos omalla sovelluksellasi voi kirjautua sisään OAuth:n avulla, se on parempi vaihtoehto, koska silloin valitset käyttöoikeudet joka kerta erikseen sen sijaan, että valitsisit ne vain kerran.
API-avain on salasana, jolla myönnät sille käyttöoikeudet, eikä se vanhene itsestään. Anna avain vain sellaiselle avustajalle, jolle uskot terveystietosi, ja myönnä sille vain välttämättömät oikeudet.
Vaihe 1: Luo API-avain FitnessSyncer:ssa
- Siirry Kehittäjätilit-sivulle.
- Valitse sivun alaosasta luettelosta ”MCP: API-avain” ja napsauta ”Luo”.
- FitnessSyncer kysyy, mitkä käyttöoikeudet tälle avaimelle tulisi myöntää. Valitse vain ne toiminnot, joita haluat avustajan suorittavan; kysymyksiin vastaamiseen riittävät lukuoikeudet, eikä mitään valitsematta jätettyä toimintoa voida käyttää myöhemmin ilman uuden avaimen luomista.
- Valitse ”Luo API-avain” ja kirjoita API-avain muistiin seuraavalla sivulla. Se näkyy vain tämän kerran; jos kadotat sen, voit luoda uuden, mutta sinun on sitten syötettävä se uudelleen avustajaasi.
Step 2: Mistral Vibe
Kun sinulla on API-avain:
- Valitse vasemmanpuoleisesta valikosta ”Context” ja sen jälkeen ”Connectors”.
- Valitse näytön oikeassa yläkulmassa oleva Lisää liitin -painike.
- Valitse mukautettu MCP-liitin.
- Kirjoita kenttään ”Name” arvo FitnessSyncer
- Syötä palvelimelle arvo ”https://www.fitnesssyncer.com/services/mcp”
- Valitse ”API-tunnuksen todennus” ja liitä API-avaimesi ”Bearer-tunnukseen”.
Vaihe 2: Mikä tahansa muu laite, jossa on asetusnäyttö
Kenttien nimet vaihtelevat avustajasta toiseen, mutta niitä on aina vain kolme:
- Kirjoita kenttään ”Name” arvo FitnessSyncer
- Kirjoita palvelimeksi https://www.fitnesssyncer.com/services/mcp, jota jotkut avustajat kutsuvat etäpalvelimen MCP URL-osoitteeksi
- Syötä API-avaimesi Bearer Token -kenttään. Jos avustaja pyytää sen sijaan otsikkoa, otsikon nimi on Authorization ja sen arvona on sana Bearer, välilyönti sekä API-avaimesi.
Jos avustaja pyytää sinua valitsemaan myös siirtoyhteyden, valitse Streamable HTTP. FitnessSyncer ei tue vanhempaa SSE-siirtoyhteyttä.
Vaihe 2: Tiedostosta määritetty avustaja
Monet komentorivi- ja työpöytäasiakasohjelmat lukevat palvelimensa tiedot JSON-tiedostosta. Rakenne vaihtelee, joten tarkista asia oman avustajasi ohjeista, mutta yleensä se näyttää tältä:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Korvaa YOUR_TOKEN_HERE omalla API-avaimellasi, mutta säilytä sana ”Bearer” ja sen edessä oleva välilyönti.
Kokeile sitä
Aloita uusi keskustelu ja liitä joku näistä viesteistä tarkistaaksesi, että kaikki toimii:
- Luettele kaikki sovellukset ja laitteet, joihin FitnessSyncer on tällä hetkellä kytketty tililläni, ja näytä, milloin ne synkronoitiin viimeksi.
- Miten nukuin tällä viikolla verrattuna viime viikkoon?
- Miten leposykkeeni on kehittynyt viimeisen kuukauden aikana?
MCP Server-sivulla on paljon muita ideoita.
AI-avustajasi selittää mittaustuloksesi yleisten ohjeiden perusteella; tämä ei ole lääketieteellistä neuvontaa.
Pitäisikö minun käyttää API-avainta vai kirjautua sisään?
Kirjaudu sisään siellä, missä avustajasi tukee sitä. OAuth-kirjautumisessa sinulta kysytään, mitkä käyttöoikeudet haluat myöntää juuri kyseisen yhteyden muodostamisen yhteydessä, ja ne voidaan peruuttaa kyseisen yhteyden osalta; API-avain puolestaan sisältää ne oikeudet, jotka valitsit sen luomisen yhteydessä, niin kauan kuin avain on voimassa.
Käytä API-avainta, kun avustaja ei voi kirjautua sisään. Näin on esimerkiksi Mistral Viben tapauksessa sekä useimpien tiedostosta määritettyjen asiakkaiden kohdalla.
Voinko muuttaa sitä, mihin API-avainta saa käyttää?
Ei jälkikäteen. Käyttöoikeudet määritetään avaimen luomisen yhteydessä, joten jos haluat laajentaa tai supistaa niitä, poista avain Kehittäjän asetuksista ja luo uusi avain, jolla on haluamasi käyttöoikeudet. Avustajasi tarvitsee tämän jälkeen uuden avaimen.
Kadotin API-avaimeni. Mitä teen nyt?
Avain näkyy vain sen luomisen yhteydessä, joten sitä ei voi etsiä mistään. Luo se uudelleen Kehittäjän asetuksissa ja syötä uusi avain avustajaasi. Vanha avain lakkaa toimimasta heti, kun olet luonut uuden, ja tällä tavalla voit myös estää pääsyn avustajalta, johon et enää luota.
Miten irrotan avustajan?
Poista liitin avustajasta ja poista sitten avain kohdasta ”Developer Configuration”. Avaimen poistaminen on tärkein vaihe, sillä muuten kaikki, mikä vielä käyttää sitä, jatkaisi toimintaansa.
