Łączenie aplikacji AI Assistant z kluczem API
Nie każdy asystent AI może zalogować się w imieniu użytkownika do FitnessSyncer MCP Server. Wiele z nich udostępnia jedynie adres serwera i miejsce na wprowadzenie tokenu, a niektóre odczytują całą swoją konfigurację z pliku na dysku. W takich przypadkach FitnessSyncer wydaje klucz API, który jest pojedynczym tokenem o długim okresie ważności, zastępującym cały proces logowania.
W ten sposób łączy się Mistral Vibe i jest to również rozwiązanie dla asystenta hostowanego na własnym serwerze, klienta wiersza poleceń, frameworka agenta lub ChatGPT, który udostępnia nagłówek zamiast ekranu OAuth. Claude, ChatGPT, Perplexity i Home Assistant mają własne procedury logowania, dlatego w stosownych przypadkach należy kierować się instrukcjami dotyczącymi poszczególnych usług.
Zanim zaczniesz
- Konto FitnessSyncer z podłączonymi źródłami. Funkcja MCP Server jest dostępna w ramach każdego konta, więc nie trzeba nic dodatkowo kupować; jeśli dopiero zaczynasz, zapoznaj się z sekcją „Pierwsze kroki”. Bezpłatne konto zapewnia dostęp do krótszego okresu historii, dokładnie tak samo jak w pozostałych częściach serwisu.
- Asystent, który może wysłać nagłówek „Authorization” lub który nazywa to samo „tokenem Bearer” albo „tokenem API”. Jeśli twój asystent może zamiast tego zalogować się za pomocą OAuth, to jest to lepsze rozwiązanie, ponieważ uprawnienia wybierasz za każdym razem, a nie tylko raz.
Klucz API to hasło uprawniające do korzystania z przyznanych mu uprawnień i nie traci on ważności z upływem czasu. Należy wprowadzić go wyłącznie do asystenta, któremu ufasz w kwestii swoich danych zdrowotnych, i przyznać mu tylko te uprawnienia, które są mu absolutnie niezbędne.
Krok 1: Utwórz swój klucz API na stronie FitnessSyncer
- Przejdź do strony „Konta deweloperów”.
- W dolnej części strony wybierz z listy pozycję „MCP: Klucz API” i kliknij „Utwórz”.
- FitnessSyncer pyta, jakie uprawnienia powinien posiadać ten klucz. Wybierz tylko te opcje, które chcesz, aby asystent wykonywał; do odpowiadania na pytania wystarczą uprawnienia do odczytu, a żadna z opcji, której nie zaznaczysz, nie będzie mogła zostać wykorzystana później bez utworzenia nowego klucza.
- Wybierz opcję „Utwórz klucz API” i zapisz klucz API wyświetlony na następnej stronie. Klucz ten jest wyświetlany tylko raz; jeśli go zgubisz, możesz wygenerować go ponownie, ale wtedy będziesz musiał wprowadzić go ponownie w swoim asystencie.
Step 2: Mistral Vibe
Mając już swój klucz API:
- W menu po lewej stronie wybierz opcję „Kontekst”, a następnie „Łączniki”.
- Wybierz opcję „Dodaj łącznik” w prawym górnym rogu ekranu.
- Wybierz złącze niestandardowe MCP.
- W polu „Nazwa” wpisz „FitnessSyncer”
- W polu „Serwer” wpisz „https://www.fitnesssyncer.com/services/mcp”
- Wybierz opcję „Uwierzytelnianie za pomocą tokenu API” i wklej swój klucz API w polu „Token Bearer”.
Krok 2: Każdy inny asystent z ekranem ustawień
Nazwy pól różnią się w zależności od asystenta, ale zawsze są tylko trzy:
- W polu „Nazwa” wpisz „FitnessSyncer”
- W polu „Serwer” wpisz „https://www.fitnesssyncer.com/services/mcp” – niektórzy asystenci nazywają to polem „Adres URL serwera zdalnego MCP”
- Wpisz swój klucz API w polu „Bearer Token”. Jeśli asystent poprosi zamiast tego o podanie nagłówka, nazwa tego nagłówka to „Authorization”, a jego wartość to słowo „Bearer”, spacja oraz Twój klucz API.
Jeśli asystent poprosi Cię również o wybranie protokołu, wybierz „Streamable HTTP”. FitnessSyncer nie obsługuje starszego protokołu SSE.
Krok 2: Asystent skonfigurowany na podstawie pliku
Wiele klientów działających w wierszu poleceń i na pulpicie odczytuje dane o swoich serwerach z pliku JSON. Format tego pliku może się różnić, więc należy kierować się dokumentacją własnego asystenta, ale zazwyczaj wygląda on następująco:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Zastąp wyrażenie YOUR_TOKEN_HERE swoim kluczem API, zachowując słowo „Bearer” oraz spację przed nim.
Wypróbuj to
Rozpocznij nową rozmowę i wklej dowolny z poniższych tekstów, aby sprawdzić, czy wszystko działa poprawnie:
- Wyświetl listę wszystkich aplikacji i urządzeń, z którymi FitnessSyncer jest obecnie połączone w ramach mojego konta, oraz pokaż, kiedy ostatnio nastąpiła synchronizacja.
- Jak spałem w tym tygodniu w porównaniu z poprzednim?
- Jak zmieniało się moje tętno spoczynkowe w ciągu ostatniego miesiąca?
Na stronie MCP Server znajdziesz o wiele więcej pomysłów.
Twój asystent AI wyjaśnia wyniki badań w oparciu o ogólnodostępne wytyczne; nie stanowi to porady medycznej.
Czy powinienem użyć klucza API, czy się zalogować?
Zaloguj się tam, gdzie obsługuje to Twoja aplikacja. Logowanie typu OAuth wymaga podania uprawnień, które chcesz przyznać w momencie nawiązania połączenia, i można je cofnąć dla tego konkretnego połączenia; klucz API zachowuje uprawnienia wybrane podczas jego tworzenia przez cały okres jego istnienia.
Użyj klucza API, gdy asystent nie może się zalogować, co ma miejsce w przypadku Mistral Vibe oraz większości klientów konfigurowanych na podstawie pliku.
Czy mogę zmienić zakres uprawnień klucza API?
Nie po fakcie. Uprawnienia są ustalane w momencie utworzenia klucza, więc aby je rozszerzyć lub zawęzić, należy usunąć klucz w sekcji „Konfiguracja programisty” i utworzyć nowy z żądanymi uprawnieniami. Twój asystent będzie wtedy potrzebował nowego klucza.
Zgubiłem swój klucz API. Co teraz?
Klucz jest wyświetlany tylko w momencie jego utworzenia, więc nie ma czego sprawdzać. Wygeneruj go ponownie w sekcji „Konfiguracja programisty” i wprowadź nowy klucz w swoim asystencie. Stary klucz przestaje działać natychmiast po ponownym wygenerowaniu — w ten sam sposób można zablokować dostęp asystentowi, któremu już nie ufasz.
Jak odłączyć asystenta?
Odłącz złącze w asystencie, a następnie usuń klucz w sekcji „Konfiguracja programisty”. Usunięcie klucza jest kluczowe, ponieważ w przeciwnym razie wszystko, co nadal go wykorzystuje, będzie nadal działać.
