Dokumentacja · 41 narzędzi w 7 obszarach

Wszystko, co potrafi Twoje AI

Nie wywołujesz tych narzędzi samodzielnie — po prostu rozmawiasz z Claude, ChatGPT albo innym klientem MCP, a on sam dobiera właściwe narzędzie. Oto wszystkie narzędzia, które serwer Nutrition MCP udostępnia do śledzenia posiłków, kalorii i makroskładników, wody i wagi — z opisem działania i przykładowym poleceniem, które je uruchamia.

Ta strona została przetłumaczona przez sztuczną inteligencję z języka angielskiego i nie została sprawdzona przez człowieka. Przeczytaj oryginał po angielsku

Zapisywanie posiłków

Podstawa wszystkiego — zapisuj, co jesz, opisując to własnymi słowami.

ZapisInteraktywny widok

`log_meal`

Zapisuj posiłki z kaloriami i makroskładnikami — a także z błonnikiem, cukrami ogółem i dodanymi, alkoholem i kofeiną, jeśli te wartości są znane. Opisz posiłek zwykłymi słowami: AI oszacuje wartości, dopyta o wielkość porcji, gdy nie jest jasna, a wcześniej może pobrać dane z etykiety po kodzie kreskowym albo z internetu.

Parametry

descriptionwymaganyCo zostało zjedzone
meal_typewymaganyśniadanie, obiad, kolacja lub przekąska
caloriesopcjonalnyŁączna liczba kalorii
protein_gopcjonalnyBiałko w gramach
carbs_gopcjonalnyWęglowodany w gramach
fat_gopcjonalnyTłuszcz w gramach
fiber_gopcjonalnyBłonnik pokarmowy w gramach. AI ma za zadanie uzupełniać tę wartość przy każdym posiłku i szacować ją ze składników, gdy etykieta jej nie podaje — bo puste pole to nie zero: wyklucza cały dzień z Twojej średniej błonnika
sugar_gopcjonalnyŁączna zawartość cukrów w gramach — wartość, którą etykieta podaje jako „w tym cukry”, obejmująca cukier naturalnie obecny w owocach i mleku, a nie tylko cukier dodany. Uzupełniana przy każdym posiłku na tych samych zasadach co błonnik
added_sugar_gopcjonalnyCukry dodane w gramach — cukier dodany podczas przetwarzania lub przygotowania (cukier stołowy, syropy, miód, cukier w słodzonych napojach i produktach). Część cukrów ogółem, nigdy więcej niż one. Cukier naturalnie obecny w całych owocach, warzywach i zwykłym mleku nie jest dodany, podobnie jak ten w soku owocowym 100%. Uzupełniane przy każdym posiłku na tych samych zasadach co błonnik: nieprzetworzona żywność ma 0, cukier w słodzonym napoju gazowanym jest w całości dodany, a amerykański wiersz etykiety „Includes Xg Added Sugars” jest używany, gdy występuje. Towarzyszy polu sugar_g: posiłek z cukrami ogółem, ale bez cukrów dodanych, może nie zostać zapisany
alcohol_gopcjonalnyGramy czystego etanolu, a nie objętość napoju ani jego zawartość alkoholu w procentach — AI wylicza je z ilości i mocy napoju (330 ml piwa 5% to 13 g)
caffeine_mgopcjonalnyKofeina w miligramach, nie w gramach — to jedyne pole, które nie jest podawane w gramach, bo tak podają ją wszystkie etykiety i zalecenia (kawa parzona to ok. 95 mg, espresso 63 mg, puszka coli 34 mg). Kofeina nie dodaje kalorii. W przeciwieństwie do błonnika i cukru jest wysyłana tylko dla produktów, które faktycznie zawierają kofeinę — zapisane 0 dodałoby do panelu wiersz kofeiny, choć wcale jej nie spożywasz
logged_atopcjonalnyKiedy posiłek został zjedzony, jeśli nie teraz — pozwala dopisać coś później
notesopcjonalnyDodatkowe notatki

Przykładowe polecenie „Zapisz na obiad burrito bowl z kurczakiem i dodatkowym guacamole”

…albo po prostu zrób zdjęcie talerza — AI rozpozna każde danie, oszacuje porcje w codziennych miarach (szklanka, garść), sprawdzi Twoje wcześniejsze wpisy tego dania i zapyta Cię o potwierdzenie, zanim cokolwiek zapisze.

Wyszukiwanie

`lookup_barcode`

Pobierz z Open Food Facts wartości odżywcze z etykiety produktu paczkowanego po jego kodzie kreskowym (EAN/UPC, 8–14 cyfr), a także Nutri-Score i grupę przetworzenia NOVA, jeśli Open Food Facts je podaje. Cukry dodane są pokazywane, gdy Open Food Facts je podaje, i oznaczane, gdy Open Food Facts oszacował je na podstawie składu. Cyfry możesz wpisać albo odczytać ze zdjęcia opakowania; wynik można potem zapisać, przeliczony na zjedzoną ilość.

Przykładowe polecenie „Zeskanuj ten kod kreskowy: 3017620422003”

…albo wyślij zdjęcie opakowania — AI odczyta z niego cyfry kodu kreskowego.

ImportInteraktywny widok

`start_meal_import`

Otwórz w czacie importer, który przeniesie Twoją historię z innej aplikacji — wybierz plik CSV wyeksportowany z MyFitnessPal, Cronometer, Lose It!, MacroFactor lub innego licznika kalorii, dopasuj jego kolumny do kalorii, makroskładników, błonnika, cukrów ogółem i dodanych oraz kofeiny (a także alkoholu, jeśli masz włączone jego śledzenie) i przed potwierdzeniem sprawdź, co zostanie dodane. Plik jest odczytywany w Twojej przeglądarce, nic nie zostaje zapisane, dopóki nie zaakceptujesz podglądu, a ponowny import tego samego pliku nie tworzy duplikatów.

Przykładowe polecenie „Zaimportuj moją historię posiłków z MyFitnessPal”

Import

`bulk_import_meals`

Dodaj za jednym razem do 50 wcześniejszych posiłków, zamiast zapisywać je po kolei. Korzysta z tego narzędzia opisany wyżej importer, a AI może go użyć bezpośrednio do danych posiłków wklejonych do czatu. Każdy wiersz jest najpierw sprawdzany, a wszystko, co nie pasuje, zostaje zgłoszone osobno dla każdego wiersza, więc ponowne wysłanie tych samych wierszy jest bezpieczne i nie zduplikuje już zapisanych posiłków — o ile w międzyczasie nie zmieniła się Twoja strefa czasowa.

Parametry

mealswymaganyWiersze do zaimportowania, w kolejności z pliku źródłowego (1–50 na wywołanie). Każdy wiersz może zawierać czas, typ posiłku, opis, notatki i te same wartości co zapisany posiłek: calories, protein_g, carbs_g, fat_g, fiber_g, sugar_g (cukry ogółem), added_sugar_g (cukry dodane, część cukrów ogółem), alcohol_g (gramy czystego etanolu) i caffeine_mg (miligramy, nie gramy)
expected_row_countwymaganyLiczba wierszy w tym wywołaniu, policzona w pliku źródłowym, żeby wychwycić pominięty wiersz
expected_total_kcalopcjonalnySuma kalorii z pliku źródłowego, porównywana z tym, co faktycznie dotarło
dry_runopcjonalnyPokaż, co by się stało, niczego nie zapisując
on_erroropcjonalnyZaimportuj poprawne wiersze i zgłoś pozostałe albo nie zapisuj niczego, jeśli którykolwiek wiersz jest błędny
source_appopcjonalnyZ jakiej aplikacji pochodzi plik

Przykładowe polecenie „Wklejam posiłki z zeszłego tygodnia z mojej starej aplikacji — dodaj je wszystkie”

EdycjaInteraktywny widok

`update_meal`

Zmień szczegóły zapisanego już posiłku — opis, dowolny makroskładnik, błonnik, cukry ogółem lub dodane, alkohol lub kofeinę, godzinę albo notatki. W ten sposób uzupełnia się też luki: jeśli posiłek trafił do dziennika bez błonnika, cukru lub cukrów dodanych, serwer to zgłasza, a AI uzupełnia brakujące dane tutaj, gdy się zgodzisz.

Parametry

idwymaganyUUID posiłku do zaktualizowania
descriptionopcjonalny
caloriesopcjonalny
protein_gopcjonalny
carbs_gopcjonalny
fat_gopcjonalny
fiber_gopcjonalny
sugar_gopcjonalnyCukry ogółem, nie cukry dodane
added_sugar_gopcjonalnyTylko cukry dodane, nigdy więcej niż cukry ogółem. Towarzyszy polu sugar_g: zmiana cukrów ogółem w posiłku bez zapisanych cukrów dodanych może nie zostać zapisana bez tej wartości
alcohol_gopcjonalnyGramy czystego etanolu, nie objętość napoju
caffeine_mgopcjonalnyMiligramy, nie gramy
logged_atopcjonalny
notesopcjonalny

Przykładowe polecenie „Ten obiad miał jednak 600 kalorii, a nie 500 — popraw to”

Usuwanie

`delete_meal`

Usuń posiłek zapisany przez pomyłkę.

Parametry

idwymaganyUUID posiłku do usunięcia

Przykładowe polecenie „Usuń przekąskę zapisaną dziś po południu”

Przegląd posiłków

Przeglądaj zapisane posiłki — z jednego dnia albo z całego zakresu dat naraz.

Podgląd

`search_meals`

Wyszukaj wcześniejsze posiłki po słowie kluczowym i zobacz je pogrupowane według Twoich powtarzających się wariantów — jak często każdy był zapisywany, kiedy ostatnio i ile zwykle ma kalorii. To dzięki temu AI porównuje zdjęcie Twojego talerza z tym, jak naprawdę zapisywano ten posiłek wcześniej — i to również sprawia, że działa polecenie „zapisz moje zwykłe śniadanie”.

Parametry

querieswymaganyAlternatywne nazwy jedzenia do wyszukania, w dowolnym języku, w którym zapisujesz posiłki
daysopcjonalnyJak daleko wstecz szukać (domyślnie rok)
limitopcjonalnyMaksymalna liczba wpisów do przeanalizowania

Przykładowe polecenie „Zapisz moje zwykłe śniadanie”

Podgląd

`get_meals_today`

Zobacz wszystkie posiłki zapisane dzisiaj.

Parametry

detailopcjonalnycompact (domyślnie): jeden wiersz na posiłek z jego identyfikatorem; full: także notatki i dokładne godziny

Przykładowe polecenie „Pokaż moje dzisiejsze posiłki”

Podgląd

`get_meals_by_date`

Zobacz wszystkie posiłki zapisane w wybranym dniu.

Parametry

datewymaganyData w formacie RRRR-MM-DD
detailopcjonalnycompact (domyślnie): jeden wiersz na posiłek z jego identyfikatorem; full: także notatki i dokładne godziny

Przykładowe polecenie „Pokaż wszystkie moje posiłki z 4 lipca”

Podgląd

`get_meals_by_date_range`

Pobierz za jednym razem wszystkie posiłki z wybranego zakresu dat — przydatne przy przeglądzie tygodnia albo miesiąca. Jedno wywołanie obejmuje do 31 dni; sumy dzienne z dłuższych okresów znajdziesz w trendach i podsumowaniach.

Parametry

start_datewymaganyData początkowa (RRRR-MM-DD)
end_datewymaganyData końcowa (RRRR-MM-DD), maksymalnie 31 dni wraz z dniem początkowym
detailopcjonalnycompact (domyślnie): jeden wiersz na posiłek z jego identyfikatorem; full: także notatki i dokładne godziny

Przykładowe polecenie „Pokaż moje posiłki od poniedziałku do piątku”

Eksport

`export_all_data`

Wyeksportuj wszystko, co usługa o Tobie przechowuje, w jednym pliku ZIP — meals.csv, water.csv, weight.csv, body_measurements.csv, goals.csv, goals_history.csv (każda zmiana Twoich celów z datą), profile.csv, account.csv (Twoje konto logowania), telemetry.csv (rejestr użycia narzędzi), connections.csv (Twoje połączone aplikacje AI i synchronizacja z Apple Health, bez żadnych tokenów), health_sync.csv (to, co synchronizacja z Apple Health wysłała w ciągu ostatnich 8 dni) oraz README.txt z objaśnieniem kolumn, jednostek i tego, czego eksport nie obejmuje — i otrzymaj prywatny link do pobrania, ważny przez 60 minut. Na razie z powrotem można zaimportować tylko posiłki.

Przykładowe polecenie „Wyeksportuj wszystkie moje dane — posiłki, wodę, wagę i cele”

Śledzenie nawodnienia

Śledź, ile pijesz, obok tego, co jesz.

Zapis

`log_water`

Zapisz wypitą wodę. Podaj ilość w dowolnej jednostce — w szklankach, uncjach czy litrach — a zostanie przeliczona na mililitry.

Parametry

amount_mlwymaganyIlość w mililitrach (liczba całkowita, > 0).

Przykładowe polecenie „Właśnie wypiłem/am butelkę wody 500 ml”

Podgląd

`get_water_today`

Zobacz łączną ilość wypitej dziś wody i wszystkie dzisiejsze wpisy.

Przykładowe polecenie „Ile wody dziś wypiłem/am?”

Podgląd

`get_water_by_date`

Zobacz łączną ilość wody i wpisy z wybranego dnia.

Parametry

datewymaganyData w formacie RRRR-MM-DD

Przykładowe polecenie „Ile wody wypiłem/am wczoraj?”

Usuwanie

`delete_water`

Usuń wpis wody dodany przez pomyłkę.

Parametry

idwymaganyUUID wpisu wody do usunięcia

Przykładowe polecenie „Usuń ostatni wpis wody”

Waga i wymiary ciała

Zapisuj pomiary wagi i obwodów ciała, przeglądaj je i śledź, jak Twoja waga zbliża się do wagi docelowej.

Zapis

`log_weight`

Zapisz pomiar masy ciała w kg lub lb. Kilka pomiarów dziennie to żaden problem, a serwer przechowuje wartość w jednej, stałej jednostce, więc wybrana przez Ciebie jednostka nigdy nie zniekształca liczby.

Parametry

weightwymaganyMasa ciała w jednostce unit (> 0).

Przykładowe polecenie „Zapisz wagę: dziś rano 74,2 kg”

Edycja

`update_weight`

Popraw zapisany pomiar wagi — wartość, datę i godzinę albo notatki.

Parametry

idwymaganyUUID pomiaru wagi do zaktualizowania
weightopcjonalnyNowa wartość wagi w jednostce unit.
logged_atopcjonalnyZnacznik czasu w formacie ISO 8601
notesopcjonalny

Przykładowe polecenie „Popraw dzisiejszy poranny pomiar na 73,8 kg”

Usuwanie

`delete_weight`

Usuń pomiar wagi.

Parametry

idwymaganyUUID pomiaru wagi do usunięcia

Przykładowe polecenie „Usuń dzisiejszy pomiar wagi”

Podgląd

`get_weight_today`

Zobacz dzisiejsze pomiary wagi w preferowanej przez Ciebie jednostce.

Przykładowe polecenie „Ile dziś ważę?”

Podgląd

`get_weight_by_date`

Zobacz pomiary wagi z wybranego dnia.

Parametry

datewymaganyData w formacie RRRR-MM-DD

Przykładowe polecenie „Jaka była moja waga pierwszego dnia miesiąca?”

Podgląd

`get_weight_by_date_range`

Pobierz wszystkie pomiary wagi z wybranego zakresu dat, pogrupowane według dni, ze średnią dla każdego dnia.

Parametry

start_datewymaganyData początkowa (RRRR-MM-DD)
end_datewymaganyData końcowa (RRRR-MM-DD)

Przykładowe polecenie „Pokaż moje pomiary wagi z ostatnich dwóch tygodni”

PodglądInteraktywny widok

`get_weight_trends`

Zobacz trend wagi w wybranym okresie: wygładzoną wagę trendu, która niweluje codzienne wahania, tempo zmian w skali tygodnia, ostatni pomiar, łączną zmianę, minimum i maksimum oraz postęp w drodze do wagi docelowej. Wykres może też pokazać 90 dni, rok lub całą historię.

Parametry

daysopcjonalnyDługość okresu w dniach (domyślnie 30, maks. 365).

Przykładowe polecenie „Jak zmienia się moja waga w tym miesiącu?”

Ustawienie

`set_weight_unit`

Wybierz, czy waga ma być wyświetlana i wpisywana w kg czy w lb. Zapisane wartości się nie zmieniają — zmienia się tylko sposób wyświetlania i domyślna jednostka wpisywanych liczb.

Przykładowe polecenie „Od teraz pokazuj moją wagę w funtach”

Zapis

`log_body_measurement`

Zapisz pomiar obwodu jednej partii ciała — talii, bioder, szyi, klatki piersiowej, barków, ramienia, przedramienia, uda lub łydki — w cm albo calach. Wartość jest przechowywana dokładnie tak, jak ją podasz, obok wartości w stałej jednostce, więc zmiana jednostki nigdy nie przesuwa liczby. Liczby daleko poza realnym zakresem dla danej partii ciała są odrzucane jako prawdopodobne literówki.

Parametry

kindwymaganyKtóra partia ciała: waist, hips, neck, chest, shoulders, upper_arm, forearm, thigh lub calf. Jedna wartość na partię ciała; stronę (lewa/prawa) można podać w notatkach.
valuewymaganyWynik pomiaru w jednostce unit (> 0).
unitopcjonalnycm lub in; domyślnie zapisana jednostka długości.
logged_atopcjonalnyKiedy wykonano pomiar, jeśli nie teraz
notesopcjonalnyDodatkowe notatki

Przykładowe polecenie „Zapisz obwód talii: dziś rano 82 cm”

Podgląd

`get_body_measurements`

Zobacz swoje wymiary ciała pogrupowane według dni, od najstarszych, opcjonalnie tylko dla jednej partii ciała. Bez podanych dat obejmuje ostatnie 30 dni, maksymalnie 366 dni na jedno wywołanie.

Parametry

kindopcjonalnyTylko ta partia ciała (np. waist)
start_dateopcjonalnyData początkowa (RRRR-MM-DD)
end_dateopcjonalnyData końcowa (RRRR-MM-DD), maksymalnie 366 dni wraz z dniem początkowym

Przykładowe polecenie „Pokaż moje pomiary talii z ostatnich trzech miesięcy”

Edycja

`update_body_measurement`

Popraw zapisany pomiar — wartość, jednostkę, datę i godzinę albo notatki. Partii ciała nie da się zmienić; pomiar innej partii to nowy wpis.

Parametry

idwymaganyUUID pomiaru do zaktualizowania
valueopcjonalnyNowa wartość w jednostce unit.
unitopcjonalnyDomyślnie jednostka, w której zapisano pomiar.
logged_atopcjonalnyZnacznik czasu w formacie ISO 8601
notesopcjonalnyNowe notatki

Przykładowe polecenie „Obwód bioder to było 98 cm, a nie 89”

Usuwanie

`delete_body_measurement`

Usuń pomiar wymiaru ciała.

Parametry

idwymaganyUUID pomiaru do usunięcia

Przykładowe polecenie „Usuń dzisiejszy pomiar obwodu szyi”

Ustawienie

`set_length_unit`

Wybierz, czy wymiary ciała mają być wyświetlane i wpisywane w centymetrach czy w calach. To ustawienie jest niezależne od jednostki wagi. Zapisane wartości się nie zmieniają — zmienia się tylko sposób wyświetlania i domyślna jednostka wpisywanych liczb.

Przykładowe polecenie „Pokazuj moje wymiary w calach”

Cele i postępy

Ustaw cele i sprawdzaj, jak wypada na ich tle każdy dzień.

Ustawienie

`set_nutrition_goals`

Ustaw dzienne cele dla kalorii, makroskładników, błonnika, cukru, cukrów dodanych, alkoholu, kofeiny i wody, a także opcjonalną wagę docelową. Kalorie, białko, węglowodany, tłuszcz, błonnik i woda to cele do osiągnięcia; cukry ogółem, cukry dodane, alkohol i kofeina to limity, których nie należy przekraczać — i tak też opisywany jest postęp. Zmieniają się tylko pola, które wskażesz; reszta pozostaje bez zmian.

Parametry

daily_caloriesopcjonalnyDzienny cel kalorii (kcal). Null usuwa cel.
daily_protein_gopcjonalnyDzienny cel białka (w gramach). Null usuwa cel.
daily_carbs_gopcjonalnyDzienny cel węglowodanów (w gramach). Null usuwa cel.
daily_fat_gopcjonalnyDzienny cel tłuszczu (w gramach). Null usuwa cel.
daily_fiber_gopcjonalnyDzienny cel błonnika (w gramach) — minimum do osiągnięcia. Null usuwa cel.
daily_sugar_gopcjonalnyDzienny limit cukrów ogółem (w gramach) — maksimum, którego nie należy przekraczać. Cukry ogółem obejmują też cukier naturalnie obecny w owocach i mleku, dlatego oficjalne zalecenia dotyczące cukrów dodanych podają znacznie niższą wartość. Null usuwa limit.
daily_added_sugar_gopcjonalnyDzienny limit cukrów dodanych (w gramach) — maksimum, którego nie należy przekraczać. Obejmuje tylko cukry dodane, a nie cukier naturalnie obecny w owocach i mleku; oficjalne zalecenia dotyczące cukru zwykle odnoszą się właśnie do tej wartości (American Heart Association zaleca najwyżej 25 g dziennie dla kobiet i 36 g dla mężczyzn). 0 to prawdziwy limit oznaczający zero. Null usuwa limit.
daily_alcohol_gopcjonalnyDzienny limit alkoholu w gramach czystego etanolu — maksimum, którego nie należy przekraczać. Jedna amerykańska porcja standardowa to 14 g, jedna jednostka brytyjska 7,9 g. Null usuwa limit.
daily_caffeine_mgopcjonalnyDzienny limit kofeiny w miligramach — maksimum, którego nie należy przekraczać. EFSA i FDA przyjmują 400 mg dziennie jako górną granicę dla zdrowych dorosłych (mniej więcej cztery kawy parzone); według EFSA w ciąży jest to 200 mg. 0 też jest limitem i oznacza całkowity brak kofeiny. Null usuwa limit.
daily_water_mlopcjonalny
target_weightopcjonalny

Przykładowe polecenie „Ustaw moje cele: 2200 kalorii, 160 g białka, waga docelowa 75 kg”

Podgląd

`get_nutrition_goals`

Zobacz aktualne dzienne cele kalorii i makroskładników, ewentualny cel błonnika, limit cukru lub kofeiny oraz — jeśli śledzisz alkohol — limit alkoholu.

Przykładowe polecenie „Jakie mam dzienne cele?”

PodglądInteraktywny widok

`get_goal_progress`

Zobacz, jak dzisiejsze spożycie wypada na tle Twoich celów — pierścienie spożycia względem celu i postęp wagi. Dotknij pierścienia makroskładnika, by zobaczyć, które posiłki się na niego złożyły.

Przykładowe polecenie „Jak mi dziś idzie z celami?”

PodglądInteraktywny widok

`get_nutrition_summary`

Pobierz dzienne sumy wartości odżywczych z wybranego zakresu dat jako interaktywny panel: kafelki makroskładników na tle celów i zestawienie dzień po dniu. Jedno wywołanie obejmuje do 92 dni; średnie kroczące z dłuższych okresów znajdziesz w trendach.

Parametry

start_datewymaganyData początkowa (RRRR-MM-DD)
end_datewymaganyData końcowa (RRRR-MM-DD), maksymalnie 92 dni wraz z dniem początkowym

Przykładowe polecenie „Podsumuj mój ostatni tydzień”

Analizy i trendy

Gotowe zestawienia, dzięki którym AI dostrzega wzorce bez samodzielnych obliczeń.

PodglądInteraktywny widok

`get_trends`

Średnie kroczące 7-, 14- i 30-dniowe, zmienność, serie dni z wpisami, średnie kalorie według dni tygodnia oraz Twoje najlepsze i najgorsze dni pod względem kalorii — policzone z góry, więc AI może je po prostu opisać. Z group_by podaje też średnie dla tygodni, miesięcy, kwartałów lub lat — na dzień z wpisami, więc dni bez posiłków się nie liczą — w porównaniu z celami obowiązującymi w danym czasie, wraz z liczbą dni w celu i dni, które mogą być niepełne.

Parametry

daysopcjonalnyDługość okresu w dniach (domyślnie 30, maks. 365).
group_byopcjonalnyweek, month, quarter lub year: 26 tygodni, 24 miesiące, 12 kwartałów lub 5 lat, kończąc na okresie zawierającym datę końcową (domyślnie dziś). Zakres jest stały; days nadal ustala średnie kroczące.

Przykładowe polecenie „Jak wypadły moje miesiące w porównaniu z celami?”

Podgląd

`get_meal_patterns`

Pokaż nawyki żywieniowe: jak często jesz każdy typ posiłku, wpływ śniadania, wysokokaloryczne obiady, późne kolacje, dni robocze a weekend oraz nietypowe dni.

Parametry

daysopcjonalnyDługość okresu w dniach (domyślnie 30, min. 7, maks. 365).

Przykładowe polecenie „Czy widać jakieś wzorce w tym, jak jem — np. późne kolacje albo pomijanie śniadań?”

Ustawienia i konto

Preferencje, dzięki którym wszystko się zgadza, a do tego pełna kontrola nad Twoimi danymi.

Podgląd

`get_profile`

Zobacz wszystkie aktualne ustawienia naraz: strefę czasową (wraz z lokalną datą i godziną), język widżetów, preferowane jednostki wagi i długości oraz to, czy widżety w czacie i śledzenie alkoholu są włączone.

Przykładowe polecenie „Jakie mam teraz ustawienia?”

Ustawienie

`set_timezone`

Ustaw strefę czasową IANA, żeby dzień zmieniał się o Twojej lokalnej północy — posiłek zapisany o 23:00 liczy się do tego dnia, a nie do następnego dnia według UTC.

Przykładowe polecenie „Jestem w Berlinie — ustaw mi strefę czasową”

Ustawienie

`set_language`

Ustaw język widżetów w czacie — paneli i wykresów, a nie odpowiedzi, które pisze do Ciebie AI.

Parametry

localewymaganyKod ISO 639-1, np. de, ja. Obsługiwane języki: angielski, niemiecki, hiszpański, francuski, niderlandzki, polski, włoski, ukraiński, japoński.

Przykładowe polecenie „Pokazuj moje widżety po niemiecku”

Podgląd

`get_current_time`

Sprawdź aktualną datę i godzinę w Twojej strefie czasowej oraz bieżący czas UTC. Niektóre aplikacje nie podają asystentowi aktualnej godziny, więc dzięki temu narzędziu wie on, co znaczy „dziś rano” albo „dzisiaj”, bez dopytywania Cię (jeśli strefa czasowa nie jest ustawiona, domyślnie przyjmowany jest UTC).

Przykładowe polecenie „Która jest teraz u mnie godzina?”

Ustawienie

`set_widget_display`

Włącz lub wyłącz widżety wizualne w czacie — panele, pierścienie celów i wykresy trendów. Gdy są wyłączone, te same narzędzia odpowiadają tylko tekstem i danymi. Domyślnie są włączone; zmiana obowiązuje w nowych rozmowach.

Parametry

enabledwymaganytrue — widżety są widoczne, false — odpowiedzi tylko tekstowe

Przykładowe polecenie „Wyłącz widżety”

Ustawienie

`set_alcohol_tracking`

Włącz lub wyłącz śledzenie alkoholu i wybierz, czy napoje mają być liczone w amerykańskich porcjach standardowych czy w jednostkach brytyjskich. Domyślnie jest wyłączone, więc trzeba o nie poprosić. Ponowne wyłączenie ukrywa alkohol w posiłkach, celach i postępach, a importer plików przestaje odczytywać kolumnę alkoholu — nic, co już zapisano, nie zostaje usunięte, Twój eksport CSV nadal to zawiera, a wszystko wraca po ponownym włączeniu. Zmiana obowiązuje od następnej wiadomości i nie trzeba niczego restartować.

Parametry

enabledwymaganytrue pokazuje alkohol w posiłkach, celach i postępach, false go ukrywa
drink_unitopcjonalnyKtóra porcja standardowa ma być pokazywana obok gramów: us (14 g na porcję) lub uk (7,9 g na jednostkę). Domyślnie us; w bazie zawsze zapisywane są gramy czystego etanolu.

Przykładowe polecenie „Włącz śledzenie alkoholu w jednostkach brytyjskich”

Usuwanie

`delete_account`

Trwale usuń konto Nutrition MCP i wszystkie dane, które usługa o Tobie przechowuje. Tej operacji nie da się cofnąć, więc narzędzie nic nie zrobi bez wyraźnego potwierdzenia, a AI ma przed jego wysłaniem zapytać Cię o zgodę.

Przykładowe polecenie „Usuń moje konto i wszystkie moje dane”

Rozwiązywanie problemów

Coś nie działa? Większość problemów da się szybko rozwiązać.

Nadal masz problem? anton@nutrition-mcp.com

01Konektor nie chce się połączyć albo ciągle każe mi się logować

Usuń konektor i dodaj go ponownie z dokładnie tym adresem: https://nutrition-mcp.com/mcp — końcówka /mcp jest wymagana. W Claude otwórz Customize → Connectors, rozłącz Nutrition i połącz go ponownie; w ChatGPT użyj Settings → Apps. Zaloguj się tym samym adresem e-mail i hasłem albo tym samym kontem Google co wcześniej: dane należą do Twojego konta, a nie do połączenia, więc po ponownym połączeniu niczego nie stracisz. Połączony konektor działa, dopóki korzystasz z niego przynajmniej raz na 90 dni; jeśli przestanie działać, wystarczy połączyć go ponownie w ten sam sposób.

02Strona logowania pokazuje {"error":"session_expired"}

Strona logowania jest ważna tylko przez 10 minut i resetuje się też przy każdym restarcie serwera po aktualizacji. Wróć na stronę logowania i odśwież ją albo zacznij łączenie od nowa w aplikacji AI, a potem zaloguj się bez dłuższej przerwy. Jeśli zamiast tego widzisz session_mismatch, logowanie zostało dokończone w innej przeglądarce niż ta, w której się zaczęło: zacznij od nowa w aplikacji AI i dokończ w tej samej przeglądarce.

03Nie mogę się zalogować albo nie pamiętam hasła

Jeśli masz już konto, użyj przycisku Zaloguj się: błędny e-mail lub hasło pokaże tam komunikat „Nieprawidłowy e-mail lub hasło” i nigdy nie założy nowego konta. Opcję Załóż konto wybierz tylko przy pierwszej wizycie. Sprawdź, czy w adresie e-mail nie ma literówki. Jeśli konto zostało założone przez Kontynuuj z Google, użyj ponownie tego przycisku. Samodzielnego resetu hasła jeszcze nie ma: napisz na anton@nutrition-mcp.com z adresu przypisanego do konta, a zresetuję je.

04Po ponownym połączeniu zniknęła moja historia

Każdy adres e-mail to osobne konto, więc logowanie innym adresem otwiera puste konto — nic nie zostało usunięte. Rozłącz się i zaloguj ponownie tym samym adresem co na początku. Jeśli nie masz pewności, który to był, napisz na anton@nutrition-mcp.com.

05AI odpowiada, ale niczego nie zapisuje

Upewnij się, że konektor jest włączony w tej rozmowie (w Claude sprawdź menu narzędzi w polu wiadomości), i poproś wprost, na przykład „zapisz moje śniadanie w Nutrition”. Jeśli aplikacja poprosi o zgodę na użycie narzędzia, zatwierdź ją.

06Moje posiłki trafiają pod zły dzień

Dni są liczone w Twojej strefie czasowej, a jeśli nigdy jej nie ustawiono, obowiązuje UTC. Zapytaj „jaką mam ustawioną strefę czasową?” (get_profile), a jeśli jest błędna, poproś „ustaw moją strefę czasową na Europe/Berlin” (set_timezone). Wtedy wszystkie Twoje wpisy, także wcześniejsze, są grupowane według Twojego lokalnego dnia. Jedyny wyjątek to wpis z podaną konkretną godziną, dodany, gdy strefa czasowa była błędna: zachowuje datę i godzinę, z jaką został wtedy zapisany, więc nadal może być przesunięty o godzinę lub dzień — poproś AI o przeniesienie go na właściwą datę i godzinę (update_meal). Strefę czasową ustaw też przed importem historii: zaimportowane posiłki zachowują datę i godzinę, z jaką zostały zapisane, a ponowny import pliku z innej aplikacji po zmianie strefy czasowej doda je po raz drugi. Eksport z Nutrition MCP zostanie rozpoznany i nie utworzy duplikatów.

07Widzę tylko tekst, bez wykresów i kart

Karty wizualne wymagają aplikacji obsługującej interaktywne panele MCP Apps, takiej jak Claude lub ChatGPT; pozostałe aplikacje dostają te same informacje w formie tekstu. Jeśli widżety zostały wyłączone, poproś o ich ponowne włączenie (set_widget_display) i zacznij nową rozmowę — otwarty czat zachowuje stare ustawienie, dopóki nie połączy się ponownie. Mała karta po zapisaniu posiłku pojawia się dopiero wtedy, gdy ustawisz dzienne cele (set_nutrition_goals).

08Importer się nie otwiera albo pisze, że nie może zapisać danych

Panel importera wymaga aplikacji, która wyświetla interaktywne panele i ma włączone widżety. Jeśli pokazuje komunikat Ta aplikacja nie pozwala temu widokowi zapisywać w Twoim dzienniku albo w ogóle się nie pojawia, poproś AI, żeby samo zaimportowało plik: załącz lub wklej CSV, a AI użyje narzędzia bulk_import_meals, które sprawdza każdy wiersz i pomija duplikaty, więc ponowne wysłanie jest bezpieczne, o ile w międzyczasie nie zmieniła się Twoja strefa czasowa. Strefę czasową ustaw przed pierwszym importem: ponowny import pliku z innej aplikacji po jej zmianie doda wiersze jeszcze raz. Jeśli korzystasz z panelu importera i chcesz zachować kolumnę z alkoholem, najpierw włącz śledzenie alkoholu — panel pomija tę kolumnę, dopóki śledzenie jest wyłączone, a późniejszy ponowny import jej nie uzupełni.

09Widzę „Rate limit exceeded” albo „Too many failed authentication attempts”

Każde konto może wysłać 60 żądań na minutę, a każde wywołanie narzędzia to co najmniej jedno żądanie. Odczekaj tyle sekund, ile podaje komunikat, i kontynuuj. Jeśli chcesz uzupełnić wiele wcześniejszych posiłków, użyj importera zamiast zapisywać je po kolei. Strony logowania przyjmują 30 żądań na minutę z jednej sieci. Po 20 odrzuconych z rzędu próbach połączenia z jednej sieci — zwykle to stary, odłączony konektor, który wciąż ponawia próby — połączenia z tej sieci są wstrzymywane na 5 minut, a kolejne blokady wydłużają się maksymalnie do godziny. Usunięcie starego konektora i dodanie go ponownie kończy te próby.

10Kod kreskowy nie zostaje znaleziony albo jego wartości wyglądają na błędne

Dane kodów kreskowych pochodzą z Open Food Facts, bazy tworzonej przez społeczność, więc niektórych produktów brakuje, a niektóre wpisy są nieaktualne. Upewnij się, że wszystkie cyfry pod kodem kreskowym (od 8 do 14) zostały odczytane poprawnie. Jeśli produktu nie ma w bazie, AI może oszacować wartości na podstawie nazwy albo zdjęcia tabeli wartości odżywczych, a Ty możesz później poprawić dowolną liczbę. Dodanie produktu na openfoodfacts.org pomaga wszystkim. Open Food Facts nie ma danych o kofeinie, więc jej ilość pochodzi z etykiety albo z typowych wartości.

11Wczorajszego dnia jeszcze nie ma w Apple Health

Synchronizacja z Apple Health wysyła tylko zakończone dni. Dzień uznaje się za zakończony o 05:00 następnego ranka w Twojej strefie czasowej, więc wczorajszy dzień trafia tam przy pierwszej synchronizacji po 05:00 dzisiaj, a dzisiejszy pojawi się w aplikacji Zdrowie dopiero jutro. Synchronizacja uruchamia się, gdy zadziała jedna z automatyzacji skrótu (otwarcie aplikacji Zdrowie, wyłączenie budzika), albo gdy uruchomisz Nutrition MCP Health w aplikacji Skróty i wybierzesz Sync now. Pominięty poranek nadrabia się sam: każda synchronizacja sięga 7 ostatnich dni. Dni liczone są w strefie czasowej z Twojego profilu (get_profile), a jeśli nigdy jej nie ustawiono, w tej, którą Twój telefon iPhone zgłosił przy łączeniu (posiłki pod złym dniem). Dni sprzed połączenia są wysyłane tylko wtedy, gdy przy łączeniu wybrano nadrobienie do 7 wcześniejszych dni.

12Apple Health pokazuje więcej niż mój czat

Apple Health może dodać coś do wartości, ale nigdy nie obniży wartości, którą już ma. Posiłek dodany do dnia, który został już wysłany, trafia tam jako mały dodatkowy wpis o 12:01, 12:02 i tak dalej, o ile ten dzień mieści się w 7 ostatnich dniach. Jeśli usuniesz lub zmniejszysz posiłek po wysłaniu jego dnia, w aplikacji Zdrowie zostanie wyższa wartość, a skrót pokaże powiadomienie o różnicy. Aby to poprawić, otwórz aplikację Zdrowie, przejdź do Przeglądaj → Odżywianie, otwórz dany typ, stuknij Pokaż wszystkie dane, usuń wpisy z tego dnia pochodzące z aplikacji Skróty i wpisz poprawną sumę ręcznie. Nigdy nie używaj opcji Usuń wszystkie dane z „Skróty”: usuwa ona także to, co zapisały Twoje inne skróty. Jeśli każdy dzień wygląda na podwojony, inna aplikacja zapisuje te same typy, a aplikacja Zdrowie je sumuje: wyłącz jedną z nich w Udostępnianie → Aplikacje w aplikacji Zdrowie.

13Synchronizacja z Apple Health przestała działać

Otwórz aplikację Skróty i uruchom Nutrition MCP Health ręcznie: skrót powie, co poszło nie tak. Jeśli prosi o ponowne połączenie, połączenie wygasło (po 90 dniach bez synchronizacji, 365 dniach od połączenia albo po wybraniu Disconnect): uruchom go, zaloguj się na otwartej stronie na to samo konto co w aplikacji AI i dokończ w ciągu 30 minut. Jeśli synchronizuje po ręcznym uruchomieniu, ale nie sam, sprawdź, czy jego automatyzacje na karcie Automatyzacja w aplikacji Skróty są włączone i ustawione na Uruchom natychmiast. Jeśli powiadomienie mówi, że dzień nie dotarł do Apple Health, pozwól aplikacji Skróty zapisywać każdy typ odżywiania w Udostępnianie → Aplikacje → Skróty w aplikacji Zdrowie, a potem uruchom skrót ponownie. Połączenie nowego telefonu iPhone zastępuje połączenie poprzedniego.

14Link do pobrania eksportu nie działa

Linki do eksportu wygasają po 60 minutach, a każdy nowy eksport zastępuje poprzedni plik. Poproś o nowy eksport (export_all_data) i od razu go pobierz. Jeśli eksport pokazuje 0 posiłków, choć powinna tam być Twoja historia, prawdopodobnie logujesz się innym adresem e-mail — zajrzyj do punktu o zniknięciu historii.

15Jak usunąć konto?

Poproś AI o usunięcie Twojego konta Nutrition MCP (delete_account). AI poprosi o potwierdzenie, a następnie trwale usunie Twoje posiłki, wodę, wagę, wymiary ciała, cele, ustawienia, rejestr narzędzi, z których korzystała Twoja aplikacja AI, ewentualny plik eksportu, dane logowania i samo konto. Tego nie da się cofnąć, więc jeśli chcesz mieć kopię, najpierw wyeksportuj dane. Potem usuń konektor ze swojej aplikacji. Jeśli w przyszłości zalogujesz się ponownie tym samym adresem e-mail, powstanie nowe, puste konto.

16Jak zgłosić błąd lub problem z bezpieczeństwem?

Błędy zgłaszaj w GitHub Issues: napisz, z jakiej aplikacji korzystasz (Claude, ChatGPT, …), jaka była Twoja prośba, co się stało i mniej więcej kiedy. Nigdy nie podawaj swojego hasła. Nie zgłaszaj problemów z bezpieczeństwem publicznie: zgłoś je prywatnie przez prywatne zgłaszanie podatności w GitHubie albo e-mailem, zgodnie z polityką bezpieczeństwa. We wszystkich innych sprawach napisz na anton@nutrition-mcp.com.