Довідник · 41 інструмент у 7 категоріях

Усе, що вміє твій ШІ

Викликати їх напряму не треба — ти просто говориш із Claude, ChatGPT чи іншим MCP-клієнтом, а він сам обирає потрібний інструмент. Нижче — усі інструменти сервера Nutrition MCP для прийомів їжі, калорій і макронутрієнтів, води та ваги: що робить кожен і якою фразою його запустити.

Цю сторінку перекладено за допомогою ШІ з англійської, і її не перевіряла людина. Читати оригінал англійською

Запис їжі та прийомів їжі

Головне: записуй усе, що з’їв, хоч як ти це опишеш.

ЗаписІнтерактивний віджет

log_meal

Запиши, що з’їв, із калоріями та макронутрієнтами, а коли цифри відомі — ще й із клітковиною, загальним і доданим цукром, алкоголем і кофеїном. Опиши все своїми словами: ШІ сам оцінить цифри, перепитає про розмір порції, якщо він неочевидний, і може спершу підтягнути дані з етикетки за штрихкодом або з інтернету.

Параметри
  • descriptionобов’язковийЩо ти з’їв
  • meal_typeобов’язковийсніданок, обід, вечеря або перекус
  • caloriesнеобов’язковийЗагальна калорійність
  • protein_gнеобов’язковийБілки в грамах
  • carbs_gнеобов’язковийВуглеводи в грамах
  • fat_gнеобов’язковийЖири в грамах
  • fiber_gнеобов’язковийКлітковина (харчові волокна) в грамах. ШІ має заповнювати це поле для кожного прийому їжі, а якщо на етикетці цифри немає — оцінювати її за складом, бо порожнє поле не дорівнює нулю: через нього весь день випадає з твого середнього показника клітковини
  • sugar_gнеобов’язковийЗагальна кількість цукру в грамах — цифра, яку на етикетці вказують у рядку «Цукри», включно з природним цукром у фруктах і молоці, а не лише доданим. Заповнюється для кожного прийому їжі так само, як і клітковина
  • added_sugar_gнеобов’язковийДоданий цукор у грамах — цукор, доданий під час виробництва чи приготування (столовий цукор, сиропи, мед, цукор у підсолоджених напоях і продуктах). Частина загального цукру, ніколи не більша за нього. Природний цукор у цілих фруктах, овочах і звичайному молоці не вважається доданим, як і цукор у 100% фруктовому соку. Заповнюється для кожного прийому їжі так само, як і клітковина: необроблені продукти мають 0, увесь цукор у солодкій газованці — доданий, а рядок американської етикетки «Includes Xg Added Sugars» береться, коли він є. Іде разом із sugar_g: прийом їжі із загальним цукром, але без доданого, може не зберегтися
  • alcohol_gнеобов’язковийГрами чистого етанолу, а не об’єм напою і не його міцність — ШІ рахує це з розміру порції та міцності (330 мл пива міцністю 5% — це 13 г)
  • caffeine_mgнеобов’язковийКофеїн у міліграмах, а не в грамах — це єдине поле тут не в грамах, бо саме так його вказують на всіх етикетках і в рекомендаціях (чашка завареної кави — приблизно 95 мг, еспресо — 63 мг, банка коли — 34 мг). Калорій кофеїн не додає. На відміну від клітковини й цукру, це поле надсилають лише для того, що справді містить кофеїн: записаний 0 додав би на твою панель рядок кофеїну, хоча ти його взагалі не вживаєш
  • logged_atнеобов’язковийКоли ти це з’їв, якщо не щойно, — так можна записати заднім числом
  • notesнеобов’язковийДодаткові нотатки

Спробуй сказати «Запиши на обід буріто-боул з куркою і подвійним гуакамоле»

…або просто сфотографуй тарілку — ШІ назве кожну страву, оцінить порції у звичних мірах (склянка, жменя), перевірить, як ти записував це раніше, і погодить із тобою, перш ніж записати.

Пошук

lookup_barcode

Дізнайся з Open Food Facts харчову цінність фасованого продукту за штрихкодом (EAN/UPC, 8–14 цифр) — дані з етикетки, а також Nutri-Score і групу обробки NOVA, якщо вони там є. Доданий цукор показується, коли Open Food Facts його вказує, з позначкою, якщо Open Food Facts оцінив його за складом. Цифри можна ввести вручну або зчитати з фото упаковки, а результат — записати, перерахувавши на ту кількість, яку ти з’їв.

Спробуй сказати «Заскануй цей штрихкод: 3017620422003»

…або надішли фото упаковки — ШІ сам зчитає з нього цифри штрихкоду.

ІмпортІнтерактивний віджет

start_meal_import

Відкрий імпортер просто в чаті й перенеси історію з іншого застосунку: обери CSV, який ти експортував з MyFitnessPal, Cronometer, Lose It!, MacroFactor чи іншого трекера, зістав його колонки з калоріями, макронутрієнтами, клітковиною, загальним і доданим цукром і кофеїном (а також з алкоголем, якщо ти ввімкнув його відстеження) і перевір, що буде додано, перш ніж підтвердити. Файл читається у твоєму браузері, нічого не зберігається, доки ти не схвалиш попередній перегляд, а повторний імпорт того самого файлу не створить дублікатів.

Спробуй сказати «Імпортуй мою історію прийомів їжі з MyFitnessPal»

Імпорт

bulk_import_meals

Додай одразу багато минулих прийомів їжі — до 50 за раз — замість того, щоб записувати їх по одному. Саме через нього записує дані імпортер, описаний вище, а ШІ може викликати його й напряму для даних, які ти вставив у чат. Кожен рядок спершу перевіряється, а про все, що не підходить, ти дізнаєшся окремо по кожному рядку, тож надіслати ті самі рядки ще раз безпечно: уже записане не продублюється, якщо тим часом не змінився твій часовий пояс.

Параметри
  • mealsобов’язковийРядки для імпорту в тому самому порядку, що й у вихідному файлі (1–50 за виклик). Кожен рядок може містити час, тип прийому їжі, опис, нотатки й ті самі показники, що й записаний прийом їжі: calories, protein_g, carbs_g, fat_g, fiber_g, sugar_g (загальний цукор), added_sugar_g (доданий цукор, частина загального), alcohol_g (грами чистого етанолу) і caffeine_mg (міліграми, а не грами)
  • expected_row_countобов’язковийСкільки рядків у цьому виклику за підрахунком у вихідному файлі — щоб помітити, якщо якийсь рядок загубився
  • expected_total_kcalнеобов’язковийСума калорій за вихідним файлом; її звіряють із тим, що надійшло
  • dry_runнеобов’язковийПоказати, що станеться, нічого не записуючи
  • on_errorнеобов’язковийІмпортувати коректні рядки й повідомити про решту або нічого не записувати, якщо хоч один рядок не пройде перевірку
  • source_appнеобов’язковийЗ якого застосунку файл

Спробуй сказати «Ось мої прийоми їжі за минулий тиждень, скопіював зі старого застосунку — додай усі»

РедагуванняІнтерактивний віджет

update_meal

Зміни дані вже записаного прийому їжі: опис, будь-який макронутрієнт, клітковину, загальний чи доданий цукор, алкоголь чи кофеїн, час або нотатки. Так само заповнюються й прогалини: якщо прийом їжі записали без клітковини, цукру чи доданого цукру, сервер про це скаже, і ШІ допише їх тут, щойно ти погодишся.

Параметри
  • idобов’язковийUUID прийому їжі, який треба оновити
  • descriptionнеобов’язковий
  • caloriesнеобов’язковий
  • protein_gнеобов’язковий
  • carbs_gнеобов’язковий
  • fat_gнеобов’язковий
  • fiber_gнеобов’язковий
  • sugar_gнеобов’язковийЗагальний цукор, а не доданий
  • added_sugar_gнеобов’язковийЛише доданий цукор, ніколи не більше за загальний. Іде разом із sugar_g: зміна загального цукру в прийомі їжі, де доданий цукор не записано, без цього значення може не зберегтися
  • alcohol_gнеобов’язковийГрами чистого етанолу, а не об’єм напою
  • caffeine_mgнеобов’язковийМіліграми, а не грами
  • logged_atнеобов’язковий
  • notesнеобов’язковий

Спробуй сказати «Взагалі-то той обід був на 600 калорій, а не на 500 — виправ»

Видалення

delete_meal

Видали прийом їжі, який записав помилково.

Параметри
  • idобов’язковийUUID прийому їжі, який треба видалити

Спробуй сказати «Видали перекус, який я записав сьогодні по обіді»

Перегляд прийомів їжі

Переглядай усе, що вже записав, — за один день чи за цілий період.

Перегляд

search_meals

Шукай минулі прийоми їжі за ключовим словом і дивись, як вони групуються за повторюваними варіантами: як часто ти записував кожен, коли востаннє і скільки в ньому зазвичай калорій. Саме так ШІ звіряє фото твоєї тарілки з тим, як ти насправді записував цю страву раніше, і саме так працює «запиши мій звичний сніданок».

Параметри
  • queriesобов’язковийВаріанти ключових слів для страви — будь-якою мовою, якою ти робив записи
  • daysнеобов’язковийЯк далеко в минуле шукати (за замовчуванням — рік)
  • limitнеобов’язковийМаксимальна кількість записів для аналізу

Спробуй сказати «Запиши мій звичний сніданок»

Перегляд

get_meals_today

Переглянь усі прийоми їжі, записані сьогодні.

Параметри
  • detailнеобов’язковийcompact (за замовчуванням) — по рядку на кожен прийом їжі з його ідентифікатором, або full — ще й із нотатками та точним часом

Спробуй сказати «Що я сьогодні їв?»

Перегляд

get_meals_by_date

Переглянь усі прийоми їжі, записані за певний день.

Параметри
  • dateобов’язковийДата у форматі YYYY-MM-DD
  • detailнеобов’язковийcompact (за замовчуванням) — по рядку на кожен прийом їжі з його ідентифікатором, або full — ще й із нотатками та точним часом

Спробуй сказати «Покажи все, що я їв 4 липня»

Перегляд

get_meals_by_date_range

Отримай усі прийоми їжі між двома датами одним запитом — зручно, щоб переглянути тиждень чи місяць. Один запит охоплює до 31 дня; для довших періодів є тренди та зведення з денними підсумками.

Параметри
  • start_dateобов’язковийДата початку (YYYY-MM-DD)
  • end_dateобов’язковийДата закінчення (YYYY-MM-DD), щонайбільше 31 день разом із початковою датою
  • detailнеобов’язковийcompact (за замовчуванням) — по рядку на кожен прийом їжі з його ідентифікатором, або full — ще й із нотатками та точним часом

Спробуй сказати «Покажи мої прийоми їжі з понеділка по п’ятницю»

Експорт

export_all_data

Експортуй усе, що сервіс зберігає про тебе, одним ZIP-архівом: meals.csv, water.csv, weight.csv, body_measurements.csv, goals.csv, goals_history.csv (кожна зміна твоїх цілей із датою), profile.csv, account.csv (твій акаунт для входу), telemetry.csv (записи про використання інструментів), connections.csv (твої підключені ШІ-застосунки й синхронізація з Apple Health, без жодних токенів), health_sync.csv (що синхронізація з Apple Health надіслала за останні 8 днів) і README.txt, де пояснено колонки, одиниці виміру та що до архіву не входить. Інструмент повертає приватне посилання для завантаження, яке діє 60 хвилин. Поки що назад можна імпортувати лише прийоми їжі.

Спробуй сказати «Експортуй усі мої дані — прийоми їжі, воду, вагу й цілі»

Відстеження води

Відстежуй, скільки п’єш води, разом з їжею.

Запис

log_water

Запиши, скільки ти випив води. Вказуй у будь-яких одиницях — склянках, унціях, літрах, — а в мілілітри все переведеться автоматично.

Параметри
  • amount_mlобов’язковийКількість у мілілітрах (ціле число, > 0).

Спробуй сказати «Я щойно випив пляшку води на 500 мл»

Перегляд

get_water_today

Переглянь, скільки води випито сьогодні загалом, і кожен запис окремо.

Спробуй сказати «Скільки води я сьогодні випив?»

Перегляд

get_water_by_date

Переглянь загальну кількість води та записи за певний день.

Параметри
  • dateобов’язковийДата у форматі YYYY-MM-DD

Спробуй сказати «Скільки я випив учора?»

Видалення

delete_water

Видали запис про воду, доданий помилково.

Параметри
  • idобов’язковийUUID запису про воду, який треба видалити

Спробуй сказати «Видали останній запис про воду»

Вага та заміри тіла

Записуй зважування й заміри тіла, переглядай їх і стеж, як вага наближається до цільової.

Запис

log_weight

Запиши вагу тіла в кг або фунтах. Кілька зважувань на день — це нормально, а сервер зберігає значення в єдиному стандартному форматі, тож обрана одиниця виміру ніколи не спотворить число.

Параметри
  • weightобов’язковийВага тіла в одиницях unit (> 0).

Спробуй сказати «Запиши мою вагу — 74,2 кг сьогодні зранку»

Редагування

update_weight

Виправ наявне зважування: значення, час запису або нотатки.

Параметри
  • idобов’язковийUUID запису ваги, який треба оновити
  • weightнеобов’язковийНове значення ваги в одиницях unit.
  • logged_atнеобов’язковийЧасова мітка у форматі ISO 8601
  • notesнеобов’язковий

Спробуй сказати «Виправ ранкове зважування на 73,8 кг»

Видалення

delete_weight

Видали запис ваги.

Параметри
  • idобов’язковийUUID запису ваги, який треба видалити

Спробуй сказати «Видали сьогоднішній запис ваги»

Перегляд

get_weight_today

Переглянь сьогоднішні зважування в обраній одиниці виміру.

Спробуй сказати «Скільки я сьогодні важив?»

Перегляд

get_weight_by_date

Переглянь зважування за певний день.

Параметри
  • dateобов’язковийДата у форматі YYYY-MM-DD

Спробуй сказати «Скільки я важив 1-го числа?»

Перегляд

get_weight_by_date_range

Отримай усі зважування між двома датами, згруповані за днями, із середнім значенням за кожен день.

Параметри
  • start_dateобов’язковийДата початку (YYYY-MM-DD)
  • end_dateобов’язковийДата закінчення (YYYY-MM-DD)

Спробуй сказати «Покажи мої зважування за останні два тижні»

Налаштування

set_weight_unit

Обери, у чому показувати й вводити вагу: у кг чи фунтах. Збережені значення не змінюються — змінюється лише відображення і те, як розуміти число без одиниці.

Спробуй сказати «Відтепер показуй мою вагу у фунтах»

Запис

log_body_measurement

Запиши замір однієї ділянки тіла сантиметровою стрічкою — талії, обхвату стегон, шиї, грудей, плечей, верхньої частини руки, передпліччя, стегна чи литки — у сантиметрах або дюймах. Значення зберігається саме так, як ти його ввів, разом зі стандартизованим, тож зміна одиниць ніколи не зрушить число. Числа, що далеко виходять за реалістичний діапазон для цієї ділянки, відхиляються як імовірні помилки введення.

Параметри
  • kindобов’язковийЯка ділянка: waist, hips, neck, chest, shoulders, upper_arm, forearm, thigh або calf. Одне значення на ділянку; бік (лівий чи правий) можна вказати в нотатках.
  • valueобов’язковийЗамір в одиницях unit (> 0).
  • unitнеобов’язковийcm або in; за замовчуванням — твоя збережена одиниця довжини.
  • logged_atнеобов’язковийКоли зроблено замір, якщо не щойно
  • notesнеобов’язковийДодаткові нотатки

Спробуй сказати «Запиши обхват талії — 82 см сьогодні зранку»

Перегляд

get_body_measurements

Переглянь свої заміри тіла за днями, від найстаріших, за бажанням — лише для однієї ділянки. Без дат охоплює останні 30 днів, а за один виклик — до 366 днів.

Параметри
  • kindнеобов’язковийЛише ця ділянка (наприклад, waist)
  • start_dateнеобов’язковийДата початку (YYYY-MM-DD)
  • end_dateнеобов’язковийДата закінчення (YYYY-MM-DD), до 366 днів разом із днем початку

Спробуй сказати «Покажи мої заміри талії за останні три місяці»

Редагування

update_body_measurement

Виправ наявний замір: значення, його одиницю, час або нотатки. Саму ділянку змінити не можна — замір іншої ділянки є новим записом.

Параметри
  • idобов’язковийUUID заміру, який треба оновити
  • valueнеобов’язковийНове значення в одиницях unit.
  • unitнеобов’язковийЗа замовчуванням — одиниця, у якій записано замір.
  • logged_atнеобов’язковийЧасова мітка у форматі ISO 8601
  • notesнеобов’язковийНові нотатки замість попередніх

Спробуй сказати «Обхват стегон був 98 см, а не 89»

Видалення

delete_body_measurement

Видали запис заміру тіла.

Параметри
  • idобов’язковийUUID заміру, який треба видалити

Спробуй сказати «Видали сьогоднішній замір шиї»

Налаштування

set_length_unit

Обери, у чому показувати й вводити заміри тіла: у сантиметрах чи дюймах. Це налаштування окреме від одиниці ваги. Збережені значення не змінюються — змінюється лише відображення і те, як розуміти число без одиниці.

Спробуй сказати «Показуй мої заміри в дюймах»

Цілі та прогрес

Задай цілі й дивись, як кожен день до них дотягує.

Налаштування

set_nutrition_goals

Задай денні цілі щодо калорій, макронутрієнтів, клітковини, цукру, доданого цукру, алкоголю, кофеїну й води, а також, за бажанням, цільову вагу тіла. Калорії, білки, вуглеводи, жири, клітковина й вода — це цілі, яких треба досягти; загальний цукор, доданий цукор, алкоголь і кофеїн — ліміти, яких не варто перевищувати, і прогрес описується відповідно. Оновлюються лише ті поля, які ти назвеш; решта лишається як є.

Параметри
  • daily_caloriesнеобов’язковийДенна ціль за калоріями (ккал). null — щоб скинути.
  • daily_protein_gнеобов’язковийДенна ціль за білками (грами). null — щоб скинути.
  • daily_carbs_gнеобов’язковийДенна ціль за вуглеводами (грами). null — щоб скинути.
  • daily_fat_gнеобов’язковийДенна ціль за жирами (грами). null — щоб скинути.
  • daily_fiber_gнеобов’язковийДенна ціль за клітковиною (грами) — мінімум, якого треба досягти. null — щоб скинути.
  • daily_sugar_gнеобов’язковийДенний ліміт загального цукру (грами) — максимум, якого не варто перевищувати. Загальний цукор включає природний цукор із фруктів і молока, тому офіційні рекомендації щодо доданого цукру називають значно меншу цифру. null — щоб скинути.
  • daily_added_sugar_gнеобов’язковийДенний ліміт доданого цукру (грами) — максимум, якого не варто перевищувати. Враховує лише доданий цукор, а не природний цукор із фруктів і молока; офіційні рекомендації щодо цукру зазвичай стосуються саме цієї величини (American Heart Association радить не більше 25 г на день для жінок і 36 г для чоловіків). 0 — справжній ліміт, що означає зовсім без доданого цукру. null — щоб скинути.
  • daily_alcohol_gнеобов’язковийДенний ліміт алкоголю в грамах чистого етанолу — максимум, якого не варто перевищувати. Одна стандартна порція (США) — 14 г, одна британська одиниця — 7,9 г. null — щоб скинути.
  • daily_caffeine_mgнеобов’язковийДенний ліміт кофеїну в міліграмах — максимум, якого не варто перевищувати. Верхня межа за EFSA та FDA для здорових дорослих — 400 мг на день (приблизно чотири чашки завареної кави), а для вагітних EFSA називає 200 мг. 0 — це справжній ліміт, тобто зовсім без кофеїну. null — щоб скинути.
  • daily_water_mlнеобов’язковий
  • target_weightнеобов’язковий

Спробуй сказати «Постав мені цілі: 2 200 калорій, 160 г білка і цільову вагу 75 кг»

Перегляд

get_nutrition_goals

Переглянь поточні денні цілі за калоріями й макронутрієнтами, ціль за клітковиною та ліміти цукру чи кофеїну, якщо вони є, а якщо відстежуєш алкоголь, — і ліміт алкоголю.

Спробуй сказати «Які в мене денні цілі?»

ПереглядІнтерактивний віджет

get_goal_progress

Переглянь, як сьогоднішнє харчування співвідноситься з твоїми цілями: кільця, що порівнюють спожите з цілями, і прогрес щодо ваги тіла. Торкнися кільця макронутрієнта, щоб побачити, з яких прийомів їжі воно склалося.

Спробуй сказати «Як у мене сьогодні з цілями?»

ПереглядІнтерактивний віджет

get_nutrition_summary

Отримай денні підсумки харчування за період у вигляді інтерактивної панелі: плитки макронутрієнтів порівняно з цілями й розбивка за днями. Один запит охоплює до 92 днів; для довших періодів тренди дають ковзні середні.

Параметри
  • start_dateобов’язковийДата початку (YYYY-MM-DD)
  • end_dateобов’язковийДата закінчення (YYYY-MM-DD), щонайбільше 92 дні разом із початковою датою

Спробуй сказати «Зроби зведення за минулий тиждень»

Налаштування та акаунт

Налаштування, завдяки яким усе рахується точно, і повний контроль над твоїми даними.

Перегляд

get_profile

Переглянь усі поточні налаштування разом: часовий пояс (а також місцеві дату й час), мову віджетів, одиниці виміру ваги й довжини, чи показуються віджети в чаті та чи ввімкнено відстеження алкоголю.

Спробуй сказати «Які в мене зараз налаштування?»

Налаштування

set_timezone

Вкажи свій часовий пояс IANA, щоб новий день починався опівночі за твоїм місцевим часом: прийом їжі, записаний о 23:00, зарахується на цей день, а не на наступний за UTC.

Спробуй сказати «Я в Берліні — встанови мій часовий пояс»

Налаштування

set_language

Встанови мову інтерфейсу віджетів у чаті — панелей і графіків, а не мову, якою тобі відповідає ШІ.

Параметри
  • localeобов’язковийКод ISO 639-1, наприклад de, ja. Підтримуються: англійська, німецька, іспанська, французька, нідерландська, польська, італійська, українська, японська.

Спробуй сказати «Покажи мої віджети українською»

Перегляд

get_current_time

Дізнайся поточну дату й час у твоєму часовому поясі, а також точний момент за UTC. Деякі застосунки не повідомляють асистентові, котра година, тож саме так він розуміє, що означає «сьогодні вранці» чи «сьогодні», не питаючи тебе (якщо часовий пояс не встановлено, за замовчуванням береться UTC).

Спробуй сказати «Котра в мене зараз година?»

Налаштування

set_widget_display

Увімкни або вимкни візуальні віджети в чаті — панелі, кільця цілей і графіки трендів. Коли вони вимкнені, ті самі інструменти відповідають лише текстом і даними. За замовчуванням віджети ввімкнені; зміна діє в нових розмовах.

Параметри
  • enabledобов’язковийtrue — показувати віджети, false — відповідати лише текстом

Спробуй сказати «Вимкни віджети»

Налаштування

set_alcohol_tracking

Увімкни або вимкни відстеження алкоголю й обери, як рахувати напої: у стандартних порціях (США) чи в британських одиницях. За замовчуванням воно вимкнене, тож про нього треба попросити. Якщо знову вимкнеш відстеження, алкоголь зникне з прийомів їжі, цілей і прогресу, а імпортер файлів перестане читати колонку алкоголю. Із записаного нічого не видаляється: CSV-експорт і далі його містить, а коли ввімкнеш відстеження назад, алкоголь повернеться. Зміна діє з наступного повідомлення, нічого перезапускати не треба.

Параметри
  • enabledобов’язковийtrue — показувати алкоголь у прийомах їжі, цілях і прогресі, false — приховати
  • drink_unitнеобов’язковийЯку стандартну порцію показувати поруч із грамами: us (14 г на порцію) або uk (7,9 г на одиницю). За замовчуванням us; насправді зберігаються грами чистого етанолу.

Спробуй сказати «Почни рахувати, скільки я п’ю, у британських одиницях»

Видалення

delete_account

Остаточно видали свій акаунт Nutrition MCP і всі дані про тебе, що в ньому зберігаються. Це незворотно, тож без явного підтвердження інструмент нічого не робить, а ШІ має спершу перепитати тебе.

Спробуй сказати «Видали мій акаунт і всі мої дані»

Усунення проблем

Щось не працює? Більшість проблем легко виправити.

Не допомогло? anton@nutrition-mcp.com

01Конектор не підключається або постійно просить увійти

Видали конектор і додай його знову саме з адресою https://nutrition-mcp.com/mcp — частина /mcp обов’язкова. У Claude відкрий Customize → Connectors, від’єднай Nutrition і підключи знову; у ChatGPT — Settings → Apps. Увійди з тією самою адресою пошти й паролем або з тим самим акаунтом Google, що й раніше: твої дані належать акаунту, а не підключенню, тож після перепідключення нічого не зникне. Підключення тримається, доки ти користуєшся ним хоча б раз на 90 днів; якщо воно перестало працювати, просто підключися знову так само.

02Сторінка входу показує {"error":"session_expired"}

Сторінка входу діє лише 10 хвилин, а ще скидається щоразу, коли сервер перезапускається для оновлення. Повернися на сторінку входу й онови її або почни підключення заново зі свого ШІ-застосунку, а тоді увійди без довгих пауз. Якщо натомість бачиш session_mismatch, вхід завершили не в тому браузері, де його почали: почни заново зі свого ШІ-застосунку й заверши вхід у тому самому браузері.

03Не можу увійти або забув пароль

Для акаунта, який у тебе вже є, натискай Увійти: якщо адреса чи пароль неправильні, там з’явиться «Неправильна електронна пошта або пароль», а новий акаунт ніколи не створюється. Створити акаунт — лише для першого візиту. Перевір, чи немає в адресі пошти помилок. Якщо ти створював акаунт через Продовжити через Google, скористайся цією кнопкою знову. Самостійно скинути пароль поки не можна: напиши на anton@nutrition-mcp.com з адреси, прив’язаної до акаунта, і я його скину.

04Я перепідключився, і моя історія зникла

Кожна адреса пошти — це окремий акаунт, тож вхід з іншою адресою відкриває новий, порожній акаунт; нічого не видалено. Від’єднайся й увійди знову з адресою, якою користувався спочатку. Якщо не впевнений, яка саме це була, напиши на anton@nutrition-mcp.com.

05ШІ відповідає, але нічого не записує

Перевір, чи конектор увімкнено для цієї розмови (у Claude — у меню інструментів у полі повідомлення), і попроси прямо, наприклад: «запиши мій сніданок у Nutrition». Якщо застосунок просить дозволу на використання інструмента, дозволь.

06Прийоми їжі записуються не на той день

Дні рахуються за твоїм часовим поясом, а якщо ти його ніколи не встановлював, — за UTC. Запитай «який часовий пояс у мене встановлено?» (get_profile) і, якщо він неправильний, скажи «встанови мій часовий пояс Europe/Berlin» (set_timezone). Після цього все записане групується за твоїми місцевими днями, зокрема й старі записи. Єдиний виняток — запис, для якого ти вказав конкретну годину, поки часовий пояс був неправильний: він зберігає той момент, на який його записали, тож може й далі бути зсунутим на годину чи на день. Попроси ШІ перенести його на правильні дату й час (update_meal). І встанови часовий пояс ще до імпорту історії: імпортовані прийоми їжі зберігають той момент, на який їх записали, а якщо після зміни часового поясу ще раз імпортувати файл з іншого застосунку, вони додадуться вдруге. Експорт із Nutrition MCP розпізнається, і дублікатів не буде.

07Я бачу лише текст, без графіків і карток

Для візуальних карток потрібен застосунок, що підтримує інтерактивні панелі MCP Apps, як-от Claude чи ChatGPT; інші клієнти отримують ту саму інформацію текстом. Якщо ти вимкнув віджети, попроси ввімкнути їх знову (set_widget_display) і почни нову розмову: відкритий чат зберігає старе налаштування, доки не перепідключиться. Маленька картка після запису прийому їжі з’являється лише тоді, коли ти задав денні цілі (set_nutrition_goals).

08Імпортер не відкривається або пише, що не може зберегти

Панелі імпортера потрібен застосунок, який показує інтерактивні панелі, з увімкненими віджетами. Якщо вона пише Цей застосунок не дає віджету записувати дані у твій щоденник або взагалі не з’являється, попроси ШІ імпортувати файл самостійно: прикріпи або встав CSV, і він скористається bulk_import_meals, який перевіряє кожен рядок і пропускає дублікати, тож надсилати ще раз безпечно, якщо тим часом не змінився твій часовий пояс. Встанови часовий пояс ще до першого імпорту: якщо після його зміни знову імпортувати файл з іншого застосунку, рядки додадуться ще раз. Якщо користуєшся панеллю імпортера й хочеш зберегти колонку алкоголю, спершу ввімкни відстеження алкоголю: поки воно вимкнене, панель пропускає цю колонку, а повторний імпорт пізніше її не заповнить.

09Я бачу «Rate limit exceeded» або «Too many failed authentication attempts»

Кожен акаунт може надсилати 60 запитів на хвилину, і кожен виклик інструмента рахується щонайменше як один запит. Зачекай стільки секунд, скільки вказано в повідомленні, і продовжуй. Щоб внести заднім числом багато прийомів їжі, користуйся імпортером, а не записуй їх по одному. Сторінки входу приймають 30 запитів на хвилину з однієї мережі. Після 20 відхилених спроб підключення поспіль з однієї мережі (зазвичай це старий від’єднаний конектор, який досі пробує підключитися) підключення з цієї мережі призупиняються на 5 хвилин, а кожна наступна пауза довша — щонайбільше до години. Якщо видалити старий конектор і додати його знову, ці спроби припиняться.

10За штрихкодом нічого не знаходиться або цифри здаються хибними

Дані за штрихкодами беруться з Open Food Facts — бази, яку наповнює спільнота, тож деяких продуктів там немає, а деякі записи застаріли. Перевір, чи правильно зчитано всі 8–14 цифр під штрихкодом. Якщо продукту там немає, ШІ може оцінити значення за назвою або за фото етикетки з харчовою цінністю, а будь-яку цифру ти потім зможеш виправити. Додавши продукт на openfoodfacts.org, ти допоможеш усім. В Open Food Facts немає даних про кофеїн, тож кофеїн береться з етикетки або з типових значень.

11Вчорашнього дня ще немає в Apple Health

Синхронізація з Apple Health надсилає лише завершені дні. День вважається завершеним о 05:00 наступного ранку за твоїм часовим поясом, тож учорашній день з’явиться після першої синхронізації після 05:00 сьогодні, а сьогоднішній — лише завтра. Синхронізація запускається, коли спрацьовує одна з автоматизацій швидкої команди (відкриття програми «Здоров’я», вимкнення будильника), або коли ти запускаєш Nutrition MCP Health у програмі «Швидкі команди» й обираєш Sync now. Пропущений ранок надолужується сам: кожна синхронізація переглядає останні 7 днів. Дні рахуються за часовим поясом у твоєму профілі (get_profile), а якщо ти його ніколи не встановлював, — за тим, який повідомив твій iPhone під час підключення (записи не на той день). Дні до підключення надсилаються, лише якщо під час підключення ти вибрав надолужити до 7 попередніх днів.

12Apple Health показує більше, ніж мій чат

Apple Health може додати до значення, але ніколи не зменшить те, що вже має. Прийом їжі, який ти додаєш до вже надісланого дня, надходить як невеликий додатковий запис о 12:01, 12:02 і так далі, якщо цей день у межах останніх 7 днів. Якщо ти видалиш або зменшиш прийом їжі після того, як його день надіслано, у програмі «Здоров’я» лишиться більше значення, а швидка команда покаже сповіщення з різницею. Щоб виправити, відкрий програму «Здоров’я», перейди в Огляд → Харчування, відкрий потрібний тип, торкнись Показати всі дані, видали записи цього дня від програми «Швидкі команди» і введи правильну суму вручну. Ніколи не використовуй Видалити всі дані з «Швидкі команди»: це видалить і те, що записали інші твої швидкі команди. Якщо кожен день виглядає подвоєним, інша програма записує ті самі типи, а програма «Здоров’я» їх додає: вимкни одну з них у Поширення → Програми в програмі «Здоров’я».

13Синхронізація з Apple Health зупинилася

Відкрий програму «Швидкі команди» й запусти Nutrition MCP Health вручну: вона скаже, що пішло не так. Якщо вона просить підключитися знову, підключення завершилося (після 90 днів без синхронізації, через 365 днів після підключення або після Disconnect): запусти її, увійди на сторінці, яку вона відкриє, у той самий обліковий запис, що й у твоїй програмі ШІ, і заверши протягом 30 хвилин. Якщо вона синхронізує, коли ти запускаєш її сам, але не автоматично, перевір, що її автоматизації на вкладці Автоматизація програми «Швидкі команди» увімкнені й налаштовані на Запускати відразу. Якщо сповіщення каже, що день не дійшов до Apple Health, дозволь програмі «Швидкі команди» записувати кожен тип харчування в Поширення → Програми → Швидкі команди у програмі «Здоров’я», а потім запусти її знову. Підключення нового iPhone замінює підключення старого.

15Як видалити акаунт?

Попроси ШІ видалити твій акаунт Nutrition MCP (delete_account). Він попросить підтвердження, а тоді остаточно видалить твої прийоми їжі, воду, вагу, заміри тіла, цілі, налаштування, записи про те, якими інструментами користувався твій ШІ-застосунок, файл експорту, якщо він є, дані для входу й сам акаунт. Скасувати це не можна, тож, якщо хочеш зберегти копію, спершу експортуй дані. Потім видали конектор зі свого застосунку. Якщо пізніше знову увійдеш з тією самою адресою, буде створено новий, порожній акаунт.

16Як повідомити про помилку чи проблему безпеки?

Про помилки пиши в GitHub Issues: вкажи, яким застосунком користуєшся (Claude, ChatGPT, …), про що просив, що сталося і приблизно коли. Ніколи не додавай свій пароль. Будь ласка, не повідомляй про проблеми безпеки публічно: надсилай їх через приватне повідомлення про вразливість на GitHub або електронною поштою, як описано в політиці безпеки. З усіх інших питань пиши на anton@nutrition-mcp.com.