FitnessSyncer

  Подключение помощника 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

  1. Перейдите на страницу «Учетные записи разработчиков».
  2. Внизу страницы выберите из списка пункт «MCP: API-ключ» и нажмите «Создать».
  3. FitnessSyncer запрашивает, какие права доступа должны быть присвоены данному ключу. Выберите только те действия, которые вы хотите, чтобы помощник выполнял; для ответов на вопросы достаточно прав на чтение, а те права, которые вы не отметили, не смогут быть использованы в дальнейшем без создания нового ключа.
  4. Выберите «Создать ключ API» и запишите ключ API на следующей странице. Он отображается только один раз; если вы его утеряете, вы сможете сгенерировать новый, но тогда вам потребуется ввести его в помощнике заново.

  Step 2: Mistral Vibe

Имея на руках свой ключ API:

  1. В левом меню выберите пункт «Контекст», а затем — «Соединители».
  2. Выберите пункт «Добавить соединитель» в правом верхнем углу экрана.
  3. Выберите «Пользовательский разъем MCP».
  4. Введите «FitnessSyncer» в поле «Имя»
  5. Введите «https://www.fitnesssyncer.com/services/mcp» в поле «Сервер»
  6. Выберите «Аутентификация с помощью токена API» и вставьте свой ключ API в поле «Bearer Token».

Шаг 2: Любой другой помощник с экраном настроек

Названия полей могут различаться в зависимости от помощника, однако их всегда всего три:

  1. Введите «FitnessSyncer» в поле «Имя»
  2. Введите «https://www.fitnesssyncer.com/services/mcp» в поле «Сервер», которое в некоторых помощниках называется «URL удаленного MCP сервера»
  3. Введите свой ключ 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. Что теперь делать?

Ключ отображается только при его создании, поэтому искать его нечего. Сгенерируйте его заново в разделе «Настройки разработчика» и введите новый ключ в вашем помощнике. Старый ключ перестанет действовать сразу после повторной генерации — именно таким образом вы также можете заблокировать доступ помощнику, которому больше не доверяете.

Как отключить помощника?

Отсоедините разъем в помощнике, а затем удалите ключ в разделе «Настройки разработчика». Удаление ключа является ключевым моментом, поскольку в противном случае все, что по-прежнему использует этот ключ, будет продолжать работать.

FitnessSyncer использует необходимые файлы cookie для входа в систему и сохранения ваших настроек. С вашего разрешения мы также используем аналитические файлы cookie, чтобы понять, как пользователи используют данный веб-сайт. Узнать больше