Підключення помічника AI за допомогою ключа API
Не кожен помічник AI може увійти в FitnessSyncer MCP Server від вашого імені. Багато з них надають лише адресу сервера та поле для введення токена, а деякі зчитують усі налаштування з файлу на диску. Для таких FitnessSyncer видає API-ключ — єдиний токен з тривалим терміном дії, який замінює весь процес входу.
Ось так здійснюється підключення Mistral Vibe, і це також рішення для самостійно розгорнутого помічника, клієнта командного рядка, фреймворку агентів або ChatGPT, який надає вам заголовок замість екрана OAuth. Claude, ChatGPT, Perplexity та Home Assistant мають власні способи входу, тому, якщо це доречно, краще дотримуватися їхніх інструкцій.
Перш ніж почати
- Обліковий запис FitnessSyncer із підключеними джерелами. MCP Server входить до кожного облікового запису, тож нічого додатково купувати не потрібно; якщо ви новачок, ознайомтеся з розділом «Початок роботи». Безкоштовний обліковий запис надає доступ до меншого обсягу історичних даних, так само, як і в інших розділах сайту.
- Асистент, який може надсилати заголовок «Authorization» або називає це «Bearer Token» чи «API token». Якщо ваш асистент може замість цього входити в систему за допомогою OAuth, це кращий варіант, оскільки ви обираєте дозволи щоразу, а не лише один раз.
Ключ API — це пароль для доступу до тих повноважень, які ви йому надаєте, і він не втрачає чинності самостійно. Вводьте його лише в той помічник, якому ви довіряєте свої медичні дані, і надавайте йому лише ті повноваження, які йому необхідні.
Крок 1: Створіть свій ключ API на FitnessSyncer
- Перейдіть на сторінку «Облікові записи розробників».
- У нижній частині сторінки виберіть зі списку «MCP: API Key» і натисніть «Створити».
- FitnessSyncer запитує, які права доступу повинен мати цей ключ. Виберіть лише ті функції, які ви хочете доручити помічнику; для відповідей на запитання достатньо прав на читання, а ті функції, які ви не позначили, не можна буде використовувати пізніше без створення нового ключа.
- Виберіть «Створити ключ API» і запишіть ключ API на наступній сторінці. Він відображається лише один раз; якщо ви його загубите, ви зможете згенерувати його заново, але тоді вам доведеться знову ввести його в асистенті.
Step 2: Mistral Vibe
Маючи під рукою свій ключ API:
- У меню ліворуч виберіть «Контекст», а потім — «З’єднувачі».
- Виберіть «Додати з’єднувач» у правому верхньому куті екрана.
- Виберіть роз'єм MCP «Налаштований».
- Введіть «FitnessSyncer» у полі «Ім’я»
- Введіть «https://www.fitnesssyncer.com/services/mcp» як ім’я сервера
- Виберіть «Аутентифікація за допомогою токена API» та вставте свій ключ API у поле «Токен Bearer».
Крок 2: Будь-який інший помічник із екраном налаштувань
Назви полів у різних помічників відрізняються, але їх завжди лише три:
- Введіть «FitnessSyncer» у полі «Ім’я»
- Введіть «https://www.fitnesssyncer.com/services/mcp» у полі «Сервер», яке деякі помічники називають URL-адресою віддаленого MCP сервера
- Введіть свій ключ API у поле «Bearer Token». Якщо помічник замість цього попросить вказати заголовок, його назва — «Authorization», а значення — слово «Bearer», пробіл та ваш ключ API.
Якщо помічник також попросить вас вибрати транспортний протокол, виберіть «Streamable HTTP». FitnessSyncer не підтримує старий транспортний протокол SSE.
Крок 2: Налаштування помічника на основі файлу
Багато клієнтів командного рядка та настільних програм зчитують дані про свої сервери з файлу JSON. Формат цього файлу може відрізнятися, тому слід керуватися документацією до вашого асистента, але зазвичай він виглядає так:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Замініть YOUR_TOKEN_HERE на свій ключ API, зберігши слово «Bearer» та пробіл перед ним.
Спробуйте
Створіть новий чат і вставте будь-яке з наведених нижче повідомлень, щоб перевірити, чи все працює:
- Перелічити всі додатки та пристрої, до яких FitnessSyncer наразі підключено в моєму обліковому записі, та показати, коли вони востаннє синхронізувалися.
- Як я спав цього тижня порівняно з минулим?
- Як змінювалася моя частота серцебиття у стані спокою протягом останнього місяця?
На сторінці MCP Server наведено ще багато інших ідей.
Ваш помічник AI роз’яснює результати ваших аналізів, спираючись на загальнодоступні рекомендації; це не є медичною порадою.
Мені слід використовувати ключ API чи увійти в систему?
Увійдіть у систему там, де це підтримує ваш помічник. При вході за допомогою OAuth система запитує, які дозволи надати під час підключення, і їх можна скасувати для цього конкретного підключення; ключ API зберігає ті дозволи, які ви вибрали під час його створення, доти, доки він існує.
Використовуйте ключ API, коли помічник не може увійти в систему, що характерно для Mistral Vibe та для більшості клієнтів, налаштованих за допомогою файлу.
Чи можна змінити повноваження API-ключа?
Не після того, як все вже зроблено. Права доступу встановлюються під час створення ключа, тому щоб розширити або звузити їх, видаліть ключ у розділі «Конфігурація розробника» та створіть новий із потрібними правами доступу. Після цього вашому помічнику знадобиться цей новий ключ.
Я загубив свій ключ API. Що тепер робити?
Ключ відображається лише під час його створення, тому шукати його ніде. Створіть його заново в розділі «Налаштування розробника» та введіть новий ключ у своєму помічнику. Старий ключ перестає діяти одразу після його перегенерації — саме таким чином ви також можете заблокувати помічника, якому більше не довіряєте.
Як відключити помічника?
Видаліть з’єднувач у помічнику, а потім видаліть ключ у розділі «Конфігурація розробника». Саме видалення ключа є найважливішим, оскільки в іншому разі все, що досі пов’язане з ним, продовжуватиме працювати.
