Propojení asistenta AI s klíčem API
Ne každý asistent AI se za vás může přihlásit do FitnessSyncer MCP Server. Mnozí nabízejí pouze adresu serveru a místo pro zadání tokenu, někteří čtou celou svou konfiguraci ze souboru na disku. Pro tyto případy FitnessSyncer vydává API klíč, což je jediný token s dlouhou platností, který nahrazuje celé přihlášení.
Takto se připojuje Mistral Vibe a jedná se také o řešení pro asistenta s vlastním hostováním, klienta pro příkazový řádek, rámec pro agenty nebo ChatGPT, který nabízí záhlaví namísto obrazovky OAuth. Claude, ChatGPT, Perplexity a Home Assistant mají každý vlastní způsob přihlášení, proto v příslušných případech upřednostňujte jejich vlastní pokyny.
Než začnete
- Účet FitnessSyncer s propojenými zdroji. Součástí každého účtu je MCP Server, takže není třeba nic dokupovat; pokud jste novým uživatelem, podívejte se na sekci „Jak začít“. Bezplatný účet zde nabízí kratší časový rozsah historie, stejně jako všude jinde na tomto webu.
- Asistent, který dokáže odeslat hlavičku „Authorization“, případně který tento prvek označuje jako „Bearer Token“ nebo „API token“. Pokud se váš asistent dokáže přihlásit pomocí OAuth, je to lepší řešení, protože oprávnění si vybíráte pokaždé, nikoli pouze jednou.
API klíč je heslo pro oprávnění, která mu udělíte, a jeho platnost sama o sobě nevyprší. Zadejte jej pouze do asistenta, kterému svěřujete své zdravotní údaje, a udělejte mu pouze ta oprávnění, která nezbytně potřebuje.
Krok 1: Vytvořte si API klíč na FitnessSyncer
- Přejděte na stránku „Účty vývojářů“.
- V dolní části stránky vyberte ze seznamu položku „MCP: API Key“ a klikněte na „Vytvořit“.
- FitnessSyncer se ptá, jaká oprávnění by měl tento klíč mít. Vyberte pouze to, co chcete, aby asistent dělal; pro zodpovídání otázek stačí oprávnění ke čtení a nic z toho, co nezaškrtnete, nelze později použít, aniž byste vytvořili nový klíč.
- Vyberte možnost „Vytvořit klíč API“ a na následující stránce si klíč API poznamenejte. Zobrazí se pouze jednou; pokud jej ztratíte, můžete si jej vygenerovat znovu, ale poté jej budete muset znovu zadat do svého asistenta.
Step 2: Mistral Vibe
Jakmile máte k dispozici svůj API klíč:
- V levém menu vyberte položku „Kontext“ a poté „Propojovače“.
- V pravém horním rohu obrazovky vyberte možnost „Přidat konektor“.
- Vyberte vlastní konektor MCP.
- Do pole „Název“ zadejte „FitnessSyncer“
- Jako název serveru zadejte „https://www.fitnesssyncer.com/services/mcp“
- Vyberte možnost „Ověření pomocí API tokenu“ a vložte svůj API klíč do pole „Bearer Token“.
Krok 2: Jakýkoli jiný asistent s obrazovkou nastavení
Názvy polí se u jednotlivých asistentů liší, ale vždy jsou jen tři:
- Do pole „Název“ zadejte „FitnessSyncer“
- Do pole „Server“ zadejte „https://www.fitnesssyncer.com/services/mcp“ – někteří asistenti tuto hodnotu označují jako URL vzdáleného MCP serveru
- Zadejte svůj API klíč do pole „Bearer Token“. Pokud asistent místo toho požaduje hlavičku, název hlavičky je „Authorization“ a její hodnota je slovo „Bearer“, mezera a váš API klíč.
Pokud vás asistent požádá také o výběr transportu, vyberte možnost „Streamable HTTP“. FitnessSyncer nepodporuje starší transport SSE.
Krok 2: Nastavení asistenta na základě souboru
Mnoho klientů pro příkazový řádek i pro pracovní plochu načítá údaje o svých serverech ze souboru JSON. Formát se liší, proto se řiďte dokumentací svého asistenta, ale obvykle vypadá takto:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Nahraďte YOUR_TOKEN_HERE svým klíčem API, přičemž zachovejte slovo „Bearer“ a mezeru před ním.
Vyzkoušejte to
Zahajte nový chat a vložte některý z následujících textů, abyste ověřili, zda vše funguje:
- Zobrazit seznam všech aplikací a zařízení, ke kterým je FitnessSyncer v současné době připojeno v rámci mého účtu, a uvést, kdy se naposledy synchronizovaly.
- Jak jsem spal tento týden ve srovnání s minulým týdnem?
- Jak se vyvíjela moje klidová srdeční frekvence za poslední měsíc?
Na stránce MCP Server najdete ještě spoustu dalších nápadů.
Váš asistent AI vám vysvětlí výsledky měření na základě veřejně dostupných pokynů; nejedná se o lékařskou radu.
Mám použít API klíč, nebo se přihlásit?
Přihlaste se tam, kde to váš asistent podporuje. Při přihlášení pomocí OAuth se vás systém v okamžiku připojení zeptá, jaká oprávnění chcete udělit, a tato oprávnění lze pro dané připojení zrušit; API klíč naopak zachovává oprávnění, která jste zvolili při jeho vytvoření, po celou dobu jeho existence.
Použijte klíč API, pokud se asistent nemůže přihlásit, což platí pro Mistral Vibe a pro většinu klientů nakonfigurovaných pomocí souboru.
Mohu změnit, k čemu je API klíč oprávněn?
Ne až dodatečně. Oprávnění se nastaví při vytvoření klíče, takže pokud je chcete rozšířit nebo omezit, smažte klíč v části „Konfigurace vývojáře“ a vytvořte nový s požadovanými oprávněními. Váš asistent pak bude potřebovat tento nový klíč.
Ztratil jsem svůj API klíč. Co teď?
Klíč se zobrazí pouze v okamžiku jeho vytvoření, takže není co vyhledávat. Znovu jej vygenerujte v nastavení pro vývojáře a nový klíč zadejte do svého asistenta. Starý klíč přestane fungovat ihned po jeho regeneraci – tímto způsobem také zablokujete asistenta, kterému již nedůvěřujete.
Jak mohu odpojit asistenta?
Odstraňte konektor v asistentovi a poté smažte klíč v části „Konfigurace vývojáře“. Důležité je právě smazání klíče, protože jinak by vše, co na něj stále odkazuje, nadále fungovalo.
