supp.fit przez Model Context Protocol

Ten serwer daje asystentowi AI dostęp do odczytu dowodów na temat suplementów pochodzących z opublikowanych badań, katalogu prawdziwych produktów oraz — jeśli na to pozwolisz — twojego własnego zestawu i dziennika przyjmowania. To jeden punkt końcowy, działa tylko do odczytu, a każde narzędzie wymaga zalogowanego konta supp.fit.

Czym to jest

Model Context Protocol, w skrócie MCP, to sposób, w jaki asystent AI sięga po dane, których nie ma w swoim zbiorze treningowym. Klient taki jak Claude czy ChatGPT łączy się z serwerem MCP, odczytuje listę oferowanych narzędzi i wywołuje jedno z nich, gdy wymaga tego pytanie. Ten serwer jest stroną supp.fit w takim połączeniu.

Bez niego asystent odpowiadający na pytanie o suplement pisze z pamięci: bez badania, bez roku, bez liczby uczestników i bez możliwości sprawdzenia tego przez ciebie. Z nim asystent czyta tę samą bazę dowodów, na której zbudowana jest strona supp.fit, a każde powtórzone twierdzenie da się prześledzić aż do pracy, z której pochodzi.

O co można zapytać

Oto pytania, na które narzędzia poniżej potrafią odpowiedzieć. Sformułowanie należy do ciebie; narzędzie wybiera asystent.

Co mówią dowody o ashwagandzie na lęk i na ilu badaniach to się opiera?
Jak mocne są dowody dotyczące kreatyny i siły mięśniowej?
Pokaż mi pojedyncze badania nad magnezem i snem, z liczbą uczestników i rokiem.
Co mam teraz w swoim zestawie suplementów i jakie są dowody dla każdej pozycji?
Które suplementy odstawiłem i kiedy?
Czy faktycznie przyjmowałem witaminę D przez ostatnie trzydzieści dni?
Ile kapsułek każdej pozycji przyjąłem w lipcu?
Znajdź produkty zawierające diglicynian magnezu i pokaż mi tabelę składu.

Jak to podłączyć

Wskaż swojemu klientowi MCP ten punkt końcowy i przejdź logowanie, które zaproponuje. Nie ma nic do zainstalowania ani klucza API do skopiowania.

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

Niektórzy klienci pytają tylko o host. Sam host też działa — POST na katalog główny to ten sam punkt końcowy. https://mcp.supp.fit

W kliencie konfigurowanym z pliku wpis wygląda tak:

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

Co robi każde narzędzie

Lista jest celowo krótka. API supp.fit ma znacznie ponad czterdzieści punktów końcowych; narzędzie dla każdego z nich dałoby asystentowi listę, z której nie da się wybrać i w której dwie pozycje różnią się jednym słowem.

Dowody, produkty i marki — `evidence.read`

Narzędzie	Co zwraca
`search_supplements` Szukaj suplementów	Znajduje suplementy po nazwie lub znanym synonimie, wraz z liczbą działań i liczbą badań, które supp.fit ma dla każdego z nich. Użyj tego najpierw, gdy pytanie wymienia suplement, aby uzyskać jego slug dla pozostałych narzędzi.
`get_supplement` Pobierz jeden suplement	Wszystko, co supp.fit ma o jednym suplemencie: każde działanie, dla którego ma dowody, jak mocne są te dowody, ile badań je wspiera i zmierzone efekty. Przyjmuje slug z search_supplements.
`get_benefit_evidence` Pobierz badania stojące za jednym działaniem	Pojedyncze badania dla pary suplement–działanie: identyfikator PubMed, tytuł, rok, liczba uczestników, ocena zaufania i własne streszczenie supp.fit. To jest duża odpowiedź; wywołuj ją tylko wtedy, gdy pytanie dotyczy siły dowodów, a nie tego, co dowody mówią.
`get_article` Pobierz jedno badanie	Jedno badanie po jego identyfikatorze PubMed: tytuł, rok i streszczenie supp.fit tego, co znaleziono dla każdego omawianego suplementu. Pełny tekst pracy nigdy nie jest zwracany — jest objęty licencją. Podążaj za `url` do PubMed, aby przeczytać pracę.
`search_products` Szukaj w katalogu produktów	Szuka prawdziwych produktów po nazwie, marce lub składniku. Zapytanie jest wymagane: nie da się wylistować całego katalogu, ponieważ żadna kolumna w nim nie może uczciwie postawić jednego produktu nad drugim.
`get_product` Pobierz jeden produkt	Jeden produkt: jego marka, kategoria, cena i tabela składu. WAŻNE: tabela jest obecna tylko wtedy, gdy kod kreskowy produktu dopasowano do zarejestrowanej etykiety I marka się zgadzała. Gdy `has_confirmed_label` jest fałszem, tabeli nie ma, i to znaczy, że dopasowania nie udało się potwierdzić — to NIE znaczy, że produkt nie ma składników. Nigdy nie mów czytelnikowi, że produkt niczego nie zawiera.

Twoje własne dane — `me.read`

Narzędzie	Co zwraca
`whoami` Do kogo należy to połączenie	Konto supp.fit, które autoryzowało to połączenie. Użyj tego, aby potwierdzić, czyje dane zwrócą narzędzia osobiste.
`get_my_favourites` Zapisane suplementy i produkty	Co ta osoba zapisała na supp.fit: suplementy i produkty.
`get_my_stack` Co ta osoba przyjmuje teraz	Suplementy i produkty, które ta osoba obecnie przyjmuje, wraz z dawką, jednostką i harmonogramem dla każdego.
`get_my_stack_history` Co ta osoba przyjmowała wcześniej	Zakończone okresy, od najnowszego. Odstawienie czegoś nie usuwa wpisu, więc suplement przyjmowany dwa razy pojawia się jako dwa okresy.
`get_my_log` Czy ta osoba faktycznie to przyjęła	Dzienne odpowiedzi o przyjęciu w oknie dat, ograniczonym do 400 dni. WAŻNE: data bez odpowiedzi oznacza, że nikt nic nie powiedział, co NIE jest tym samym co pominięta dawka. Nie licz milczenia jako pominięcia.
`get_my_consumption` Ile każdej pozycji zostało przyjęte	Ile każdej pozycji ta osoba przyjęła w danym oknie, pogrupowane według pozycji ORAZ według jednostki. WAŻNE: nie dodawaj tych liczb do siebie między pozycjami ani między jednostkami i nie przeliczaj ich na miligramy składnika odżywczego. Kapsułki, kapsułki miękkie i mililitry to różne rzeczy, a tabeli przeliczania związku na pierwiastek tutaj nie ma — zgadywanie zawyża zwykle siedmiokrotnie, i to w kierunku, który ukrywa ostrzeżenie o górnym limicie. Podawaj liczby w takiej postaci, w jakiej przychodzą.

Co może odczytać, a czego nie

Dwa uprawnienia, zaznaczane osobno na stronie zgody, więc część dotyczącą dowodów można przyznać bez części osobistej.

Uprawnienie	Obejmuje
`evidence.read`	suplementy, działania, wyniki, streszczenia badań, produkty, marki. Nic o tobie.
`me.read`	twoje ulubione, twój obecny zestaw, zakończone okresy i twój dziennik przyjmowania.

Wszystko działa tylko do odczytu. Żadne narzędzie niczego nie zapisuje, nie zmienia ani nie usuwa, a serwer nie ma ścieżki zapisu do bazy danych. Nie przechowuje też własnego sekretu: niesie token wydany twojemu klientowi i nic więcej, a każdą decyzję o tym, co ten token może odczytać, podejmuje API, a nie ten serwer.

Pełny tekst pracy nigdy nie jest zwracany. Jest objęty licencją, więc narzędzia zwracają własne streszczenie supp.fit i odnośnik do pracy w PubMed.

Częste pytania

Czy potrzebuję konta supp.fit, żeby korzystać z tego serwera MCP?

Tak. Każde narzędzie wymaga zalogowanego konta supp.fit, także te, które odczytują dowody pokazywane na stronie każdemu. Twój klient MCP wysyła cię na stronę zgody, logujesz się przez Google i wybierasz, czym się dzielisz.

Dlaczego publiczne dowody wymagają logowania?

Asystent działa w pętli, a prawie każde użyteczne pytanie miesza część publiczną z prywatną: co mówią badania i co naprawdę przyjmujesz. Jedna zasada dla wszystkich narzędzi to zasada, którą da się sprawdzić. Osobna ocena dla każdego narzędzia to coś, o czym ktoś w końcu zapomni.

Czy może coś zmienić na moim koncie?

Nie. Każde narzędzie działa tylko do odczytu. Nie ma narzędzia, które dodaje suplement do twojego zestawu, zapisuje dawkę, zmienia dziennik albo cokolwiek usuwa, a serwer w ogóle nie ma ścieżki zapisu do bazy danych.

Co może odczytać o mnie?

Tylko to, co obejmuje przyznane przez ciebie uprawnienie. Uprawnienie evidence.read obejmuje suplementy, działania, badania, produkty i marki, i nie mówi nic o tobie. Uprawnienie me.read obejmuje twoje ulubione, twój obecny zestaw, zakończone okresy i twój dziennik przyjmowania. To osobne pola wyboru, więc możesz przyznać część dotyczącą dowodów i zatrzymać osobistą.

Którzy klienci mogą się połączyć?

Każdy, kto mówi w Model Context Protocol po Streamable HTTP i potrafi przejść przepływ OAuth 2.1. Należą do nich Claude, konektory ChatGPT i narzędzia MCP z wiersza poleceń. Serwer nie przechowuje stanu, więc nie wydaje identyfikatora sesji i nie otwiera strumienia zdarzeń.

Skąd pochodzą dowody?

Z opublikowanych badań w PubMed, przeczytanych i streszczonych na supp.fit. Każdy wynik niesie ze sobą badanie, z którego pochodzi, więc asystent może wskazać pracę, rok i liczbę uczestników zamiast twierdzić coś z własnej mocy. Pełny tekst pracy nigdy nie jest zwracany, ponieważ jest objęty licencją.

Co oznacza brak tabeli składu?

Że kodu kreskowego produktu nie udało się dopasować do zarejestrowanej etykiety, a nie że produkt nie ma składników. W danych obie sytuacje wyglądają identycznie, a znaczą coś przeciwnego, dlatego opis narzędzia mówi o tym wprost, a asystentowi nakazano nigdy nie informować, że produkt niczego nie zawiera.

Punkty końcowe

URL	Czym jest
`POST https://mcp.supp.fit/mcp`	rozmowa MCP. POST na katalog główny to to samo.
`GET https://mcp.supp.fit/.well-known/oauth-protected-resource`	gdzie zdobyć token, tak jak opisuje to RFC 9728.
`https://api.supp.fit`	serwer autoryzacji. Wydaje każdy token, który wydaje ten serwer.
`GET https://mcp.supp.fit/llms.txt`	ta strona jako zwykły tekst, dla agenta, który czyta, a nie przegląda.