Подключение помощника AI с помощью ключа API
Не каждый помощник AI может войти в систему FitnessSyncer MCP Server от вашего имени. Многие из них предоставляют лишь адрес сервера и поле для ввода токена, а некоторые загружают всю свою конфигурацию из файла на диске. Для таких помощников FitnessSyncer выдает API-ключ — это единый токен с длительным сроком действия, который заменяет собой весь процесс входа в систему.
Именно так осуществляется подключение к Mistral Vibe, и это также решение для самостоятельно развернутого помощника, клиента командной строки, инфраструктуры агентов или ChatGPT, который предоставляет вам заголовок вместо экрана OAuth. Claude, ChatGPT, Perplexity и Home Assistant имеют собственные процедуры входа в систему, поэтому, если это применимо, следуйте их инструкциям.
Прежде чем приступить к работе
- Учетная запись FitnessSyncer с подключенными источниками. Функция MCP Server входит в каждую учетную запись, поэтому ничего дополнительно покупать не нужно; если вы новичок, ознакомьтесь с разделом «Начало работы». Бесплатная учетная запись предоставляет доступ к более ограниченному объему исторических данных, точно так же, как и во всех других разделах сайта.
- Сервис, который может отправлять заголовок «Authorization» или называет его «Bearer Token» либо «API-токен». Если ваш сервис может вместо этого входить в систему с помощью OAuth, это будет более предпочтительным вариантом, поскольку в этом случае вы выбираете права доступа каждый раз, а не один раз.
API-ключ представляет собой пароль, обеспечивающий доступ к предоставленным вами правам, и срок его действия не истекает сам по себе. Вводите его только в тот помощник, которому вы доверяете свои медицинские данные, и предоставляйте ему только те права, которые ему необходимы.
Шаг 1: Создайте свой ключ API на FitnessSyncer
- Перейдите на страницу «Учетные записи разработчиков».
- Внизу страницы выберите из списка пункт «MCP: API-ключ» и нажмите «Создать».
- FitnessSyncer запрашивает, какие права доступа должны быть присвоены данному ключу. Выберите только те действия, которые вы хотите, чтобы помощник выполнял; для ответов на вопросы достаточно прав на чтение, а те права, которые вы не отметили, не смогут быть использованы в дальнейшем без создания нового ключа.
- Выберите «Создать ключ API» и запишите ключ API на следующей странице. Он отображается только один раз; если вы его утеряете, вы сможете сгенерировать новый, но тогда вам потребуется ввести его в помощнике заново.
Step 2: Mistral Vibe
Имея на руках свой ключ API:
- В левом меню выберите пункт «Контекст», а затем — «Соединители».
- Выберите пункт «Добавить соединитель» в правом верхнем углу экрана.
- Выберите «Пользовательский разъем MCP».
- Введите «FitnessSyncer» в поле «Имя»
- Введите «https://www.fitnesssyncer.com/services/mcp» в поле «Сервер»
- Выберите «Аутентификация с помощью токена API» и вставьте свой ключ API в поле «Bearer Token».
Шаг 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. Что теперь делать?
Ключ отображается только при его создании, поэтому искать его нечего. Сгенерируйте его заново в разделе «Настройки разработчика» и введите новый ключ в вашем помощнике. Старый ключ перестанет действовать сразу после повторной генерации — именно таким образом вы также можете заблокировать доступ помощнику, которому больше не доверяете.
Как отключить помощника?
Отсоедините разъем в помощнике, а затем удалите ключ в разделе «Настройки разработчика». Удаление ключа является ключевым моментом, поскольку в противном случае все, что по-прежнему использует этот ключ, будет продолжать работать.
