Povezivanje AI asistenta s API ključem
Ne može svaki AI asistent prijaviti se u FitnessSyncer MCP Server za vas. Mnogi nude samo adresu poslužitelja i mjesto za unos tokena, a neki čitaju cijelu svoju konfiguraciju iz datoteke na disku. Za njih FitnessSyncer izdaje API ključ, koji je jedan dugovječni token koji zamjenjuje cijeli postupak prijave.
Ovo je način na koji se Mistral Vibe povezuje, a to je također odgovor za samostalno hostanog asistenta, klijenta naredbenog retka, okvir za agente ili ChatGPT koji vam nudi zaglavlje umjesto OAuth zaslona. Claude, ChatGPT, Gemini, Perplexity, Grok, Le Chat i Home Assistant svaki imaju vlastiti postupak prijave, stoga je poželjno koristiti njihove upute gdje je to primjenjivo.
Prije nego što počnete
- FitnessSyncer račun s povezanim izvorima. MCP Server je uključen uz svaki račun, pa nema dodatnih kupnji; pogledajte Getting Started ako ste novi. Besplatan račun ovdje obuhvaća manje povijesti, točno kao i svugdje drugdje na stranici.
- Asistent koji može poslati Authorization header ili koji isto naziva Bearer tokenom ili API tokenom. Ako se vaš može umjesto toga prijaviti s OAuth, to je bolja opcija, jer dozvole birate svaki put umjesto jednom.
API ključ je lozinka za dozvole koje mu odobrite i sam po sebi ne istječe. Stavite ga samo u asistenta kojemu povjeravate svoje zdravstvene podatke i dodijelite mu najmanje dozvole koje su mu potrebne.
Korak 1: Kreirajte svoj API ključ na FitnessSyncer
- Idite na stranicu programerskih računa.
- Na dnu stranice odaberite "MCP: API ključ" iz popisa i kliknite "Stvori".
- FitnessSyncer pita koje dozvole ovaj ključ treba imati. Odaberite samo ono što želite da asistent učini; za odgovaranje na pitanja dovoljne su dozvole za čitanje, a ništa što ostavite neoznačeno ne može se kasnije koristiti bez izrade novog ključa.
- Odaberite Stvori API ključ i zabilježite API ključ na sljedećoj stranici. Prikazuje se samo jednom; ako ga izgubite, možete ga ponovno generirati, ali ćete ga tada morati ponovno unijeti u svog asistenta.
Step 2: Mistral Vibe
Sa svojim API ključem pri ruci:
- Iz lijevog izbornika odaberite Kontekst, a zatim Konektori.
- Odaberite Dodaj konektor u gornjem desnom kutu zaslona.
- Odaberite prilagođeni MCP konektor.
- Unesite FitnessSyncer za Naziv
- Unesite https://www.fitnesssyncer.com/services/mcp za poslužitelj
- Odaberite autentifikaciju API tokenom i zalijepite svoj API ključ u Bearer token.
Korak 2: Bilo koji drugi asistent s zaslonom postavki
Polja se nazivaju različito od jednog asistenta do drugog, ali ih je uvijek samo tri:
- Unesite FitnessSyncer za Naziv
- Unesite https://www.fitnesssyncer.com/services/mcp za poslužitelj, koji neki asistenti nazivaju URL-om udaljenog MCP poslužitelja.
- Unesite svoj API ključ u polje Bearer Token. Ako asistent umjesto toga zatraži zaglavlje, naziv zaglavlja je Authorization, a njegova vrijednost je riječ Bearer, razmak i vaš API ključ.
Ako vas asistent također pita da odaberete transport, odaberite Streamable HTTP. FitnessSyncer ne nudi stariji SSE transport.
Korak 2: Asistent konfiguriran iz datoteke
Mnogi klijenti naredbenog retka i radne površinečitaju svoje poslužitelje iz JSON datoteke. Oblik varira, pa ga prilagodite dokumentaciji vašeg asistenta, ali obično izgleda ovako:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Zamijenite YOUR_TOKEN_HERE svojim API ključem, zadržavajući riječ Bearer i razmak ispred nje.
Isprobajte
Pokrenite novi chat i zalijepite bilo koji od ovih tekstova kako biste provjerili radi li sve ispravno:
- Prikaži sve aplikacije i uređaje FitnessSyncer koji su trenutno povezani s mojim računom i pokaži kada su se zadnji put sinkronizirali.
- Kako sam spavao ovaj tjedan u usporedbi s prošlim tjednom?
- Što je moja mirovna srčana frekvencija radila tijekom posljednjeg mjeseca?
Na stranici MCP Server nalazi se još mnogo ideja.
Vaš AI asistent objašnjava vaša očitanja koristeći javne smjernice; ovo nije medicinski savjet.
Trebam li koristiti API ključ ili se prijaviti?
Prijavite se tamo gdje vaš asistent to podržava. Prijava OAuth pita vas koja dopuštenja želite dodijeliti u trenutku povezivanja i ona se može opozvati samo za to jedno povezivanje; API ključ nosi ona dopuštenja koja ste odabrali prilikom stvaranja, sve dok postoji.
Koristite API ključ kada se asistent ne može prijaviti, što je slučaj za Mistral Vibe i za većinu klijenata konfiguriranih iz datoteke.
Mogu li promijeniti što API ključ smije raditi?
Ne nakon činjenice. Ovlasti se fiksiraju pri stvaranju ključa, pa da biste ih proširili ili suzili, izbrišite ključ u Developer Configuration i stvorite novi s željenim ovlastima. Vašem asistentu tada treba novi ključ.
Izgubio sam svoj API ključ. Što sad?
Ključ se prikazuje samo prilikom stvaranja, pa nema ničega što biste mogli pronaći. Ponovno ga generirajte u Developer Configuration i unesite novi u svog asistenta. Stari ključ prestaje raditi čim ponovno generirate, što je također način da zaključate asistenta kojem više ne vjerujete.
Kako mogu isključiti asistenta?
Uklonite konektor u asistentu, zatim izbrišite ključ u Developer Configuration. Brisanje ključa je ono što je važno, jer bi inače sve što ga i dalje drži nastavilo raditi.
