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 замінює підключення старого.
14Посилання на завантаження експорту не працює
Посилання на експорт діє 60 хвилин, а кожен новий експорт замінює попередній файл. Попроси зробити новий експорт (export_all_data) і завантаж його одразу. Якщо в експорті 0 прийомів їжі, хоча ти очікував побачити свою історію, імовірно, ти увійшов з іншою адресою пошти — див. пункт «Я перепідключився, і моя історія зникла».
15Як видалити акаунт?
Попроси ШІ видалити твій акаунт Nutrition MCP (delete_account). Він попросить підтвердження, а тоді остаточно видалить твої прийоми їжі, воду, вагу, заміри тіла, цілі, налаштування, записи про те, якими інструментами користувався твій ШІ-застосунок, файл експорту, якщо він є, дані для входу й сам акаунт. Скасувати це не можна, тож, якщо хочеш зберегти копію, спершу експортуй дані. Потім видали конектор зі свого застосунку. Якщо пізніше знову увійдеш з тією самою адресою, буде створено новий, порожній акаунт.
16Як повідомити про помилку чи проблему безпеки?
Про помилки пиши в GitHub Issues: вкажи, яким застосунком користуєшся (Claude, ChatGPT, …), про що просив, що сталося і приблизно коли. Ніколи не додавай свій пароль. Будь ласка, не повідомляй про проблеми безпеки публічно: надсилай їх через приватне повідомлення про вразливість на GitHub або електронною поштою, як описано в політиці безпеки. З усіх інших питань пиши на anton@nutrition-mcp.com.