AI Assistant csatlakoztatása API-kulccsal
Nem minden AI asszisztens tud bejelentkezni a FitnessSyncer MCP Server-be az Ön nevében. Sokuk csak egy szervercímet és egy helyet kínál a token elhelyezésére, míg mások a teljes konfigurációjukat egy lemezen található fájlból olvassák be. Ezek számára a FitnessSyncer kiad egy API-kulcsot, amely egy hosszú élettartamú token, amely az egész bejelentkezés helyett szolgál.
Így kapcsolódik be a Mistral Vibe, és ez a megoldás egy saját szerveren futtatott asszisztens, egy parancssori kliens, egy ügynök-keretrendszer vagy egy olyan ChatGPT esetében is, amely OAuth képernyő helyett fejlécet jelenít meg. A Claude, a ChatGPT, a Perplexity és a Home Assistant mindegyike rendelkezik saját bejelentkezési eljárással, ezért ahol lehetséges, kövesse az azokhoz tartozó utasításokat.
Mielőtt elkezdenéd
- Egy FitnessSyncer fiók, amelyhez a források már hozzá vannak kapcsolva. A MCP Server minden fiókhoz tartozik, így nem kell semmit külön vásárolni; ha új felhasználó vagy, olvasd el az „Első lépések” című részt. Az ingyenes fiókok itt is kevesebb előzményt jelenítenek meg, pontosan úgy, mint a webhely többi részén.
- Olyan segédprogram, amely képes „Authorization” fejlécet küldeni, vagy amely ezt „Bearer Token”-nek vagy „API token”-nek nevezi. Ha a te programod helyette a OAuth-val tud bejelentkezni, az a jobb megoldás, mert így minden alkalommal magad választhatod ki a jogosultságokat, nem pedig csak egyszer.
Az API-kulcs az általa megadott jogosultságokhoz tartozó jelszó, és önmagában nem jár le. Csak olyan asszisztensbe írja be, amelynek megbízza az egészségügyi adatait, és csak a szükséges minimum jogosultságokat adja meg neki.
1. lépés: Hozzon létre API-kulcsot a FitnessSyncer oldalon
- Lépjen a „Fejlesztői fiókok” oldalra.
- Az oldal alján válassza ki a listából a „MCP: API-kulcs” elemet, majd kattintson a „Létrehozás” gombra.
- FitnessSyncer azt kérdezi, hogy milyen jogosultságokkal rendelkezzen ez a kulcs. Csak azokat a lehetőségeket jelölje be, amelyeket az asszisztensnek elvégeznie szeretne; a kérdések megválaszolásához elegendő az olvasási jogosultság, és az, amit bejelölés nélkül hagy, később új kulcs létrehozása nélkül nem használható fel.
- Válaszd az „API-kulcs létrehozása” lehetőséget, és jegyezd meg az API-kulcsot a következő oldalon. Ez csak egyszer jelenik meg; ha elveszted, újra létrehozhatod, de aztán újra be kell írnod az asszisztensedbe.
Step 2: Mistral Vibe
Ha már megvan az API-kulcsod:
- A bal oldali menüből válassza ki a „Context” (Kontextus), majd a „Connectors” (Összekötők) menüpontot.
- Válassza ki a „Csatlakozó hozzáadása” lehetőséget a képernyő jobb felső sarkában.
- Válassza ki az „Egyéni MCP csatlakozó” lehetőséget.
- Írja be az „FitnessSyncer” nevet
- A szerverhez adja meg az „https://www.fitnesssyncer.com/services/mcp” értéket
- Válassza ki az „API-tokenes hitelesítés” lehetőséget, majd illessze be az API-kulcsát a „Bearer token” mezőbe.
2. lépés: Bármely más segédprogram, amelynek beállítási képernyője van
A mezők neve asszisztensenként eltérő, de mindig csak három van:
- Írja be az „FitnessSyncer” nevet
- Írja be az https://www.fitnesssyncer.com/services/mcp értéket a szerver mezőbe, amelyet egyes asszisztensek távoli MCP szerver URL-ként emlegetnek
- Írd be az API-kulcsodat a „Bearer Token” mezőbe. Ha az asszisztens ehelyett fejlécet kér, a fejléc neve „Authorization”, értéke pedig a „Bearer” szó, egy szóköz, majd az API-kulcsod.
Ha az asszisztens azt is kéri, hogy válasszon átviteli módot, válassza a „Streamable HTTP” lehetőséget. A FitnessSyncer nem támogatja a régebbi SSE átviteli módot.
2. lépés: Fájlból konfigurált asszisztens
Számos parancssori és asztali kliens a JSON fájlból olvassa be a szervereit. A formátum változó, ezért érdemes a saját segédprogramod dokumentációjához igazodni, de általában így néz ki:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Cseréld ki a YOUR_TOKEN_HERE szöveget a saját API-kulcsodra, ügyelve arra, hogy a „Bearer” szó és az azt megelőző szóköz is megmaradjon.
Próbáld ki!
Indíts el egy új csevegést, és illessz be bármelyiket az alábbiak közül, hogy ellenőrizd, minden rendben működik-e:
- Sorold fel az összes olyan alkalmazást és eszközt, amelyhez a FitnessSyncer jelenleg csatlakozik a fiókomhoz, és mutasd meg, mikor szinkronizálódtak utoljára.
- Hogyan aludtam ezen a héten a múlt héthez képest?
- Hogyan alakult a nyugalmi pulzusom az elmúlt hónapban?
A MCP Server oldalon még rengeteg további ötlet található.
A AI asszisztensed a nyilvánosan elérhető irányelvek alapján magyarázza el a mérési eredményeidet; ez nem minősül orvosi tanácsadásnak.
API-kulcsot használjak, vagy jelentkezzek be?
Jelentkezz be ott, ahol az asszisztensed támogatja ezt. A OAuth bejelentkezésnél a rendszer a csatlakozás pillanatában megkérdezi, milyen jogosultságokat szeretnél megadni, és ezeket az adott kapcsolatra vonatkozóan visszavonhatod; az API-kulcs viszont a létrehozáskor választott jogosultságokat hordozza, amíg létezik.
Használjon API-kulcsot, ha az asszisztens nem tud bejelentkezni – ez a helyzet a Mistral Vibe esetében, valamint a legtöbb, fájlból konfigurált kliensnél.
Megváltoztathatom, hogy egy API-kulcs milyen műveleteket hajthat végre?
Nem utólag. A jogosultságok a kulcs létrehozásakor rögzülnek, így azok kiterjesztéséhez vagy szűkítéséhez törölje a kulcsot a „Fejlesztői beállítások” menüpontban, majd hozzon létre egy újat a kívánt jogosultságokkal. Az asszisztensének ezután az új kulcsra lesz szüksége.
Elvesztettem az API-kulcsomat. Most mi legyen?
A kulcs csak létrehozásakor jelenik meg, így nincs mit megkeresni. Állítsd elő újra a Fejlesztői beállítások menüpontban, majd írd be az újat az asszisztensedbe. A régi kulcs az újrateremtés pillanatában már nem működik tovább; így zárhatod ki azt az asszisztenst is, akiben már nem bízol.
Hogyan lehet leválasztani egy asszisztenst?
Távolítsa el a csatlakozót az asszisztensből, majd törölje a kulcsot a Fejlesztői beállítások menüpontban. A kulcs törlése a legfontosabb lépés, mert ellenkező esetben minden, ami még mindig ehhez kapcsolódik, továbbra is működne.
