supp.fit через Model Context Protocol

Этот сервер даёт ИИ-ассистенту доступ на чтение к доказательствам о пищевых добавках из опубликованных исследований, к каталогу реальных продуктов и — если вы разрешите — к вашему набору добавок и дневнику приёма. Это одна точка входа, она работает только на чтение, и каждый инструмент требует вошедшего аккаунта supp.fit.

Что это

Model Context Protocol, или MCP, — это способ, которым ИИ-ассистент добирается до данных, которых нет в его обучающей выборке. Клиент вроде Claude или ChatGPT подключается к MCP-серверу, читает список предлагаемых инструментов и вызывает один из них, когда этого требует вопрос. Этот сервер — сторона supp.fit в такой связке.

Без него ассистент отвечает на вопрос о добавке по памяти: без исследования, без года, без числа участников и без возможности для вас это проверить. С ним ассистент читает ту же базу доказательств, на которой построен сайт supp.fit, и любое утверждение, которое он повторяет, можно проследить до статьи, откуда оно взято.

О чём можно спросить

Вот вопросы, на которые инструменты ниже умеют отвечать. Формулировка ваша; инструмент выбирает ассистент.

Что говорят исследования об ашваганде при тревожности и на скольких работах это основано?
Насколько убедительны доказательства по креатину и мышечной силе?
Покажи отдельные исследования по магнию и сну, с числом участников и годом.
Что сейчас в моём наборе добавок и какие доказательства есть по каждому пункту?
Какие добавки я перестал принимать и когда?
Принимал ли я витамин D за последние тридцать дней на самом деле?
Сколько капсул каждого средства я принял в июле?
Найди продукты с бисглицинатом магния и покажи таблицу состава.

Как подключить

Укажите вашему MCP-клиенту эту точку входа и пройдите вход, который он предложит. Ничего устанавливать не нужно, ключ API копировать тоже не нужно.

POST https://mcp.supp.fit/mcp

Некоторые клиенты спрашивают только хост. Голый хост тоже работает: POST в корень — та же самая точка входа. https://mcp.supp.fit

В клиенте, который настраивается файлом, запись выглядит так:

{
  "mcpServers": {
    "supp-fit": {
      "type": "http",
      "url": "https://mcp.supp.fit/mcp"
    }
  }
}

Что делает каждый инструмент

Список намеренно короткий. В API supp.fit заметно больше сорока эндпоинтов; отдельный инструмент на каждый дал бы ассистенту список, из которого невозможно выбрать и в котором две записи отличаются одним словом.

Доказательства, продукты и бренды — `evidence.read`

Инструмент	Что возвращает
`search_supplements` Поиск добавок	Находит добавки по названию или известному синониму, с числом эффектов и числом исследований, которые supp.fit хранит по каждой. Используйте это первым, когда в вопросе названа добавка, чтобы получить её slug для остальных инструментов.
`get_supplement` Получить одну добавку	Всё, что supp.fit хранит об одной добавке: каждый эффект, для которого есть доказательства, насколько они сильны, сколько исследований их поддерживает и измеренные величины. Принимает slug из search_supplements.
`get_benefit_evidence` Получить исследования по одному эффекту	Отдельные исследования по паре «добавка — эффект»: идентификатор PubMed, заголовок, год, число участников, оценка доверия и собственное изложение supp.fit. Это большой ответ; вызывайте его только когда вопрос о силе доказательств, а не о том, что доказательства говорят.
`get_article` Получить одно исследование	Одно исследование по его идентификатору PubMed: заголовок, год и изложение supp.fit того, что оно нашло по каждой упомянутой добавке. Полный текст статьи никогда не возвращается — он лицензирован. Перейдите по `url` в PubMed, чтобы прочитать саму работу.
`search_products` Поиск по каталогу продуктов	Ищет реальные продукты по названию, бренду или ингредиенту. Запрос обязателен: перечислить весь каталог нельзя, потому что ни одна колонка в нём не может честно поставить один продукт выше другого.
`get_product` Получить один продукт	Один продукт: бренд, категория, цена и таблица состава. ВАЖНО: таблица есть только тогда, когда штрихкод продукта сопоставлен с зарегистрированной этикеткой И бренд совпал. Если `has_confirmed_label` равно false, таблицы нет, и это значит, что сопоставление не подтвердилось, — это НЕ значит, что у продукта нет состава. Никогда не сообщайте читателю, что продукт ничего не содержит.

Ваши собственные данные — `me.read`

Инструмент	Что возвращает
`whoami` Кому принадлежит это подключение	Аккаунт supp.fit, которым авторизовано это подключение. Позволяет убедиться, чьи данные вернут личные инструменты.
`get_my_favourites` Сохранённые добавки и продукты	Что этот человек сохранил на supp.fit: добавки и продукты.
`get_my_stack` Что этот человек принимает сейчас	Добавки и продукты, которые человек принимает сейчас, с дозой, единицей измерения и расписанием по каждому.
`get_my_stack_history` Что этот человек принимал раньше	Завершённые периоды, новые сверху. Отмена приёма не удаляет запись, поэтому добавка, которую принимали дважды, выглядит как два периода.
`get_my_log` Принимал ли человек это на самом деле	Ежедневные ответы о приёме внутри интервала дат, не длиннее 400 дней. ВАЖНО: дата без ответа означает, что никто ничего не сказал, и это НЕ то же самое, что пропущенная доза. Не считайте молчание пропуском.
`get_my_consumption` Сколько каждого средства было принято	Сколько каждого средства человек принял за интервал, сгруппировано по средству И по единице измерения. ВАЖНО: не складывайте эти числа между средствами или между единицами и не переводите их в миллиграммы нутриента. Капсулы, мягкие капсулы и миллилитры — разные вещи, и таблицы пересчёта соединения в элемент здесь нет: догадка обычно завышает примерно в семь раз, причём в ту сторону, которая прячет предупреждение о верхнем пределе. Сообщайте числа в том виде, в каком они пришли.

Что он может читать, а что нет

Два разрешения, отмечаются на странице согласия по отдельности, так что половину с доказательствами можно выдать без личной.

Разрешение	Охватывает
`evidence.read`	добавки, эффекты, находки, краткие изложения исследований, продукты, бренды. Ничего о вас.
`me.read`	ваше избранное, ваш текущий набор, завершённые периоды и ваш дневник приёма.

Всё работает только на чтение. Ни один инструмент ничего не записывает, не меняет и не удаляет, и у сервера нет пути записи в базу данных. Своего секрета он тоже не хранит: он несёт токен, выданный вашему клиенту, и больше ничего, а каждое решение о том, что этот токен может прочитать, принимает API, а не этот сервер.

Полный текст статьи никогда не возвращается. Он лицензирован, поэтому инструменты отдают собственное изложение supp.fit и ссылку на статью в PubMed.

Частые вопросы

Нужен ли аккаунт supp.fit, чтобы пользоваться этим MCP-сервером?

Да. Каждый инструмент требует вошедшего аккаунта supp.fit, включая те, что читают данные, которые сайт показывает кому угодно. Ваш MCP-клиент отправляет вас на страницу согласия, вы входите через Google и выбираете, чем поделиться.

Почему для публичных данных нужен вход?

Ассистент работает циклом, и почти любой полезный вопрос смешивает публичную половину с личной: что говорят исследования и что вы на самом деле принимаете. Одно правило для всех инструментов — правило, которое можно проверить. Решение по каждому инструменту отдельно — то, о чём кто-нибудь однажды забудет.

Может ли он что-то изменить в моём аккаунте?

Нет. Каждый инструмент работает только на чтение. Нет инструмента, который добавит средство в ваш набор, запишет дозу, отредактирует дневник или что-нибудь удалит, и у сервера вообще нет пути записи в базу данных.

Что он может прочитать обо мне?

Только то, что охватывает выданное вами разрешение. Разрешение evidence.read охватывает добавки, эффекты, исследования, продукты и бренды и ничего не говорит о вас. Разрешение me.read охватывает ваше избранное, ваш текущий набор, завершённые периоды и ваш дневник приёма. Это отдельные галочки, так что можно выдать половину с доказательствами и удержать личную.

Какие клиенты могут подключиться?

Любой, кто говорит на Model Context Protocol поверх Streamable HTTP и умеет пройти поток OAuth 2.1. Это Claude, коннекторы ChatGPT и консольные инструменты MCP. Сервер не хранит состояние, поэтому не выдаёт идентификатор сессии и не открывает поток событий.

Откуда берутся доказательства?

Из опубликованных исследований в PubMed, прочитанных и кратко изложенных на supp.fit. Каждая находка несёт с собой исследование, из которого она взята, поэтому ассистент может назвать статью, год и число участников, а не утверждать что-то от себя. Полный текст статьи никогда не возвращается, потому что он лицензирован.

Что означает отсутствующая таблица состава?

Что штрихкод продукта не удалось сопоставить с зарегистрированной этикеткой, а не то, что у продукта нет состава. В данных это выглядит одинаково, а означает противоположное, поэтому описание инструмента говорит об этом словами, а ассистенту велено никогда не сообщать, что продукт ничего не содержит.

Точки входа

URL	Что это
`POST https://mcp.supp.fit/mcp`	разговор по MCP. POST в корень — то же самое.
`GET https://mcp.supp.fit/.well-known/oauth-protected-resource`	где получить токен, как описывает RFC 9728.
`https://api.supp.fit`	сервер авторизации. Он выпускает каждый токен, который тратит этот сервер.
`GET https://mcp.supp.fit/llms.txt`	эта страница простым текстом, для агента, который читает, а не просматривает.