Guida di riferimento · 48 strumenti in 7 aree

Tutto quello che la tua IA può fare

Non devi mai usarli direttamente: parli con Claude, ChatGPT o un altro client MCP e l'assistente sceglie lo strumento giusto. Ecco tutti gli strumenti che il server Nutrition MCP offre per pasti e pasti salvati, calorie e macro, acqua e peso, con cosa fa ciascuno e una frase che lo attiva.

Questa pagina è stata tradotta con l'IA dall'inglese e non è stata rivista da una persona. Leggi l'originale in inglese

Registrare cibo e pasti

La funzione principale: registra ciò che hai mangiato, comunque tu lo descriva, e salva i pasti che mangi spesso per registrarli di nuovo in una riga.

RegistraUI interattiva

log_meal

Registra cosa hai mangiato con calorie e macro, più grassi saturi e trans, fibre, zuccheri totali e aggiunti, alcol e caffeina quando i valori sono disponibili. Descrivilo a parole tue: l'IA stima i valori, ti chiede la porzione quando non è chiara e può prima recuperare i dati dell'etichetta da un codice a barre o dal web. Può anche ricevere gli ingredienti uno per uno, e in quel caso i totali sono la somma di quegli ingredienti.

Parametri
  • descriptionobbligatorioCosa hai mangiato
  • meal_typeobbligatoriocolazione, pranzo, cena o spuntino
  • caloriesfacoltativoCalorie totali
  • protein_gfacoltativoProteine in grammi
  • carbs_gfacoltativoCarboidrati in grammi
  • fat_gfacoltativoGrassi in grammi
  • saturated_fat_gfacoltativoFacoltativo. Grassi saturi in grammi, parte di fat_g e mai superiori a essa. Un valore vuoto viene salvato come non misurato e lascia quel giorno fuori dalla media e dal limite dei grassi saturi; 0 è il valore corretto per un alimento che non ne contiene.
  • trans_fat_gfacoltativoFacoltativo. Grassi trans in grammi, un tipo di grasso a sé, non controllato rispetto a fat_g. Non hanno un limite e vengono mostrati solo dove sono stati registrati; 0 è il valore corretto per un alimento che non ne contiene.
  • fiber_gfacoltativoFibre alimentari in grammi. All'IA viene chiesto di compilarlo per ogni pasto, stimandolo dagli ingredienti quando manca il valore in etichetta, perché un campo vuoto non vale zero: esclude l'intera giornata dalla tua media di fibre
  • sugar_gfacoltativoZuccheri totali in grammi: il valore che l'etichetta riporta alla voce “Zuccheri”, compresi quelli naturalmente presenti in frutta e latte, non solo gli zuccheri aggiunti. Si compila per ogni pasto, alle stesse condizioni delle fibre
  • added_sugar_gfacoltativoZuccheri aggiunti in grammi: lo zucchero aggiunto durante la lavorazione o la preparazione (zucchero da tavola, sciroppi, miele, lo zucchero di bevande e alimenti zuccherati). Fanno parte degli zuccheri totali e non li superano mai. Lo zucchero naturalmente presente nella frutta intera, nella verdura e nel latte semplice non è aggiunto, e nemmeno quello del succo 100% frutta. Si compila per ogni pasto, alle stesse condizioni delle fibre: gli alimenti non lavorati valgono 0, lo zucchero di una bibita è tutto aggiunto e si usa la riga “Includes Xg Added Sugars” delle etichette statunitensi quando c'è. Accompagna sugar_g: un pasto con zuccheri totali ma senza zuccheri aggiunti potrebbe non essere salvato
  • alcohol_gfacoltativoGrammi di etanolo puro, non il volume della bevanda né la sua gradazione: l'IA li calcola dalla quantità servita e dalla gradazione (una birra da 330 ml al 5% contiene 13 g)
  • caffeine_mgfacoltativoCaffeina in milligrammi, non grammi: è l'unico campo qui che non è in grammi, perché è così che la riportano tutte le etichette e le linee guida (un caffè filtro ne contiene circa 95 mg, un espresso 63 mg, una lattina di cola 34 mg). La caffeina non apporta calorie. A differenza di fibre e zuccheri, viene inviata solo per ciò che contiene davvero caffeina: uno 0 registrato aggiungerebbe alla tua dashboard una riga della caffeina per un nutriente che non assumi mai
  • logged_atfacoltativoQuando l'hai mangiato, se non è adesso: ti permette di registrare qualcosa a posteriori
  • notesfacoltativoNote aggiuntive
  • itemsfacoltativoIngredienti, una riga per ciascuno, con quantità e valori nutrizionali: calories, protein_g, carbs_g e fat_g su ogni ingrediente; fiber_g, sugar_g e added_sugar_g su tutti gli ingredienti o su nessuno; alcohol_g e caffeine_mg solo sugli ingredienti che li contengono, sommati su quegli ingredienti. I totali del pasto sono allora la somma degli ingredienti, quindi invia ingredienti oppure totali, non entrambi

Prova a dire «Registra per pranzo una burrito bowl di pollo con guacamole extra»

…oppure scatta una foto del piatto: l'IA riconosce ogni pietanza, stima le porzioni in misure di tutti i giorni (un bicchiere, una manciata), controlla come l'hai registrata le altre volte e ti chiede conferma prima di registrarla.

Cerca

lookup_barcode

Recupera da Open Food Facts i valori nutrizionali in etichetta di un prodotto confezionato tramite il codice a barre (EAN/UPC di 8–14 cifre), insieme a Nutri-Score e gruppo di trasformazione NOVA quando Open Food Facts li riporta. Gli zuccheri aggiunti compaiono quando Open Food Facts li indica, segnalati come stima quando Open Food Facts li ha ricavati dagli ingredienti. Puoi digitare le cifre o ricavarle da una foto della confezione; poi il risultato si può registrare, in proporzione a quanto ne hai mangiato.

Prova a dire «Scansiona questo codice a barre: 3017620422003»

…oppure invia una foto della confezione: l'IA ci legge le cifre del codice a barre.

Cerca

search_foods

Cerca alimenti generici di USDA FoodData Central (record Foundation, SR Legacy e Survey/FNDDS) per nome inglese e restituisce fino a 10 candidati, ciascuno con il suo id FoodData Central, la descrizione USDA, il tipo di dato, l'energia e i macronutrienti per 100 g. Le corrispondenze usano la formulazione inglese dell'USDA (ad es. «cooked, boiled»).

Parametri
  • queryobbligatorioIl nome dell'alimento in inglese, fino a 200 caratteri, ad es. banana o lentils, cooked

Prova a dire «Cosa riporta l'USDA per una banana cruda?»

Cerca

get_food_macros

Restituisce i valori USDA FoodData Central di un alimento generico tramite il suo id FoodData Central: per 100 g e, quando è indicato amount_g, riportati a quella quantità, con le porzioni elencate dall'USDA. Un nutriente che l'USDA non registra per l'alimento viene indicato come non registrato, mai come zero. Include il food_ref che gli strumenti dei pasti accettano per questi valori.

Parametri
  • fdc_idobbligatorioL'id FoodData Central dell'alimento, come elencato da search_foods
  • amount_gfacoltativoQuantità facoltativa in grammi, maggiore di 0 e fino a 5.000, a cui riportare i valori

Prova a dire «Quali sono i macro USDA per 150 g di quella banana?»

ImportaUI interattiva

start_meal_import

Apre in chat un importatore per portare il tuo storico da un'altra app: scegli il CSV esportato da MyFitnessPal, Cronometer, Lose It!, MacroFactor o un'altra app di monitoraggio, abbina le colonne a calorie, macro, fibre, zuccheri totali e aggiunti e caffeina (più l'alcol, se hai attivato il monitoraggio dell'alcol) e controlla cosa verrà aggiunto prima di confermare. Il file viene letto direttamente nel tuo browser, non si salva nulla finché non approvi l'anteprima e reimportare lo stesso file non crea duplicati.

Prova a dire «Importa lo storico dei miei pasti da MyFitnessPal»

Importa

bulk_import_meals

Aggiunge in un colpo solo un blocco di pasti passati, fino a 50 alla volta, invece di registrarli uno per uno. L'importatore qui sopra salva i dati tramite questo strumento, e l'IA può usarlo direttamente per i pasti che hai incollato in chat. Ogni riga viene prima controllata e ogni problema viene segnalato riga per riga, quindi reinviare le stesse righe è sicuro e non duplica ciò che è già registrato, purché nel frattempo tu non abbia cambiato fuso orario.

Parametri
  • mealsobbligatorioLe righe da importare, nell'ordine del file di origine (1–50 per chiamata). Ogni riga può contenere un orario, il tipo di pasto, una descrizione, le note e gli stessi valori di un pasto registrato: calories, protein_g, carbs_g, fat_g, saturated_fat_g, trans_fat_g, fiber_g, sugar_g (zuccheri totali), added_sugar_g (zuccheri aggiunti, parte del totale), alcohol_g (grammi di etanolo puro) e caffeine_mg (milligrammi, non grammi)
  • expected_row_countobbligatorioQuante righe contiene questa chiamata, contate nel file di origine, così ci si accorge se una riga va persa
  • expected_total_kcalfacoltativoCalorie totali del file di origine, confrontate con quelle effettivamente ricevute
  • dry_runfacoltativoMostra cosa succederebbe, senza scrivere nulla
  • on_errorfacoltativoSe importare le righe valide e segnalare le altre, oppure non scrivere nulla se anche una sola riga non va
  • source_appfacoltativoDa quale app proviene il file

Prova a dire «Ecco i pasti della settimana scorsa, copiati dalla mia vecchia app: aggiungili tutti»

ModificaUI interattiva

update_meal

Modifica i dettagli di un pasto già registrato: la descrizione, qualsiasi macro, fibre, zuccheri totali o aggiunti, alcol o caffeina, l'orario o le note. Serve anche a colmare i vuoti: se un pasto è stato registrato senza fibre, zuccheri o zuccheri aggiunti, il server lo segnala e, se sei d'accordo, l'IA li aggiunge qui. Su un pasto registrato con gli ingredienti, i totali cambiano tramite la sua lista di ingredienti.

Parametri
  • idobbligatorioUUID del pasto da aggiornare
  • descriptionfacoltativo
  • caloriesfacoltativo
  • protein_gfacoltativo
  • carbs_gfacoltativo
  • fat_gfacoltativo
  • saturated_fat_gfacoltativoFacoltativo. Grassi saturi in grammi, parte di fat_g e mai superiori a essa. Un valore vuoto viene salvato come non misurato e lascia quel giorno fuori dalla media e dal limite dei grassi saturi; 0 è il valore corretto per un alimento che non ne contiene.
  • trans_fat_gfacoltativoFacoltativo. Grassi trans in grammi, un tipo di grasso a sé, non controllato rispetto a fat_g. Non hanno un limite e vengono mostrati solo dove sono stati registrati; 0 è il valore corretto per un alimento che non ne contiene.
  • fiber_gfacoltativo
  • sugar_gfacoltativoZuccheri totali, non zuccheri aggiunti
  • added_sugar_gfacoltativoSolo zuccheri aggiunti, mai più degli zuccheri totali. Accompagna sugar_g: una modifica degli zuccheri totali di un pasto senza zuccheri aggiunti registrati potrebbe non essere salvata senza questo valore
  • alcohol_gfacoltativoGrammi di etanolo puro, non il volume della bevanda
  • caffeine_mgfacoltativoMilligrammi, non grammi
  • logged_atfacoltativo
  • notesfacoltativo
  • itemsfacoltativoLa lista completa degli ingredienti, che sostituisce quella esistente. I totali del pasto diventano la somma di questa lista, quindi con essa non si possono inviare i campi dei totali

Prova a dire «In realtà quel pranzo era di 600 calorie, non 500: correggilo»

Rimuovi

delete_meal

Rimuove un pasto registrato per errore.

Parametri
  • idobbligatorioUUID del pasto da eliminare

Prova a dire «Elimina lo spuntino che ho registrato oggi pomeriggio»

Registra

save_meal

Salva con un nome un pasto che mangi spesso, come la tua colazione abituale, con i suoi valori per una porzione e, se li hai, i suoi ingredienti. Puoi inserire tu i valori oppure copiarli da un pasto già registrato. Salvare non aggiunge nulla al tuo diario: quando mangi il pasto salvato, registralo con log_saved_meal.

Parametri
  • nameobbligatorioIl nome con cui salvarlo, unico tra i tuoi pasti salvati (da 1 a 100 caratteri)
  • from_meal_idfacoltativoUUID di un pasto registrato da cui copiare valori e ingredienti
  • descriptionfacoltativoDi cosa si tratta. Predefinito: il nome
  • meal_typefacoltativocolazione, pranzo, cena o spuntino: il valore predefinito al momento della registrazione
  • itemsfacoltativoIngredienti, una riga per ciascuno, con quantità e valori nutrizionali. La loro somma diventa i valori del pasto salvato, quindi invia ingredienti oppure valori, non entrambi
  • caloriesfacoltativoCalorie totali per una porzione
  • protein_gfacoltativoProteine in grammi per una porzione
  • carbs_gfacoltativoCarboidrati in grammi per una porzione
  • fat_gfacoltativoGrassi in grammi per una porzione
  • saturated_fat_gfacoltativoFacoltativo. Grassi saturi in grammi, parte di fat_g e mai superiori a essa. Un valore vuoto viene salvato come non misurato e lascia quel giorno fuori dalla media e dal limite dei grassi saturi; 0 è il valore corretto per un alimento che non ne contiene.
  • trans_fat_gfacoltativoFacoltativo. Grassi trans in grammi, un tipo di grasso a sé, non controllato rispetto a fat_g. Non hanno un limite e vengono mostrati solo dove sono stati registrati; 0 è il valore corretto per un alimento che non ne contiene.
  • fiber_gfacoltativoFibre alimentari in grammi per una porzione
  • sugar_gfacoltativoZuccheri totali in grammi per una porzione
  • added_sugar_gfacoltativoZuccheri aggiunti in grammi per una porzione, mai più degli zuccheri totali. Accompagna sugar_g
  • alcohol_gfacoltativoGrammi di etanolo puro per una porzione, non il volume della bevanda
  • caffeine_mgfacoltativoMilligrammi di caffeina per una porzione, non grammi

Prova a dire «Salva questo come la mia colazione abituale»

RegistraUI interattiva

log_saved_meal

Registra un pasto salvato come voce del diario, da adesso oppure da un orario che indichi. La voce riceve una copia dei valori e degli ingredienti salvati, riportati alle porzioni indicate, con singoli ingredienti eventualmente portati alla quantità effettivamente mangiata o esclusi solo per questa volta. Le modifiche successive al pasto salvato lasciano invariati i pasti già registrati da esso.

Parametri
  • saved_mealobbligatorioIl nome del pasto salvato, oppure il suo ID da get_saved_meals o search_meals
  • servingsfacoltativoQuante porzioni registrare: più di 0 e fino a 20 (predefinito 1)
  • item_amountsfacoltativoLe quantità di singoli ingredienti effettivamente mangiate in questa voce, per nome o posizione. Prima le porzioni ridimensionano il pasto salvato, poi questi valori fissano la quantità degli ingredienti indicati; i loro valori nutrizionali si adeguano in proporzione
  • leave_outfacoltativoIngredienti da togliere da questa voce, per nome o posizione
  • meal_typefacoltativocolazione, pranzo, cena o spuntino: sostituisce il tipo predefinito del pasto salvato
  • descriptionfacoltativoDescrizione di questa voce. Predefinito: la descrizione del pasto salvato
  • logged_atfacoltativoQuando l'hai mangiato, se non è adesso
  • notesfacoltativoNote aggiuntive
  • idempotency_keyfacoltativoUna chiave che rende nullo un tentativo ripetuto, così la stessa voce non viene registrata due volte

Prova a dire «Registra la mia colazione abituale, mezza porzione»

Modifica

update_saved_meal

Modifica il nome, la descrizione, il tipo di pasto predefinito, gli ingredienti o i valori per porzione di un pasto salvato. I pasti già registrati da esso mantengono i loro valori.

Parametri
  • idobbligatorioUUID del pasto salvato da aggiornare
  • namefacoltativoNuovo nome, unico tra i tuoi pasti salvati
  • descriptionfacoltativoNuova descrizione
  • meal_typefacoltativoNuovo tipo di pasto predefinito: colazione, pranzo, cena o spuntino
  • itemsfacoltativoLa lista completa degli ingredienti, che sostituisce quella esistente. La loro somma diventa i valori del pasto salvato, quindi con essa non si possono inviare i campi dei valori
  • caloriesfacoltativoCalorie totali per una porzione
  • protein_gfacoltativoProteine in grammi per una porzione
  • carbs_gfacoltativoCarboidrati in grammi per una porzione
  • fat_gfacoltativoGrassi in grammi per una porzione
  • saturated_fat_gfacoltativoFacoltativo. Grassi saturi in grammi, parte di fat_g e mai superiori a essa. Un valore vuoto viene salvato come non misurato e lascia quel giorno fuori dalla media e dal limite dei grassi saturi; 0 è il valore corretto per un alimento che non ne contiene.
  • trans_fat_gfacoltativoFacoltativo. Grassi trans in grammi, un tipo di grasso a sé, non controllato rispetto a fat_g. Non hanno un limite e vengono mostrati solo dove sono stati registrati; 0 è il valore corretto per un alimento che non ne contiene.
  • fiber_gfacoltativoFibre alimentari in grammi per una porzione
  • sugar_gfacoltativoZuccheri totali in grammi per una porzione
  • added_sugar_gfacoltativoZuccheri aggiunti in grammi per una porzione, mai più degli zuccheri totali. Accompagna sugar_g
  • alcohol_gfacoltativoGrammi di etanolo puro per una porzione, non il volume della bevanda
  • caffeine_mgfacoltativoMilligrammi di caffeina per una porzione, non grammi

Prova a dire «La mia colazione abituale ora ha 350 calorie per porzione: aggiornala»

Rimuovi

delete_saved_meal

Elimina un pasto salvato. I pasti già registrati da esso mantengono i loro valori.

Parametri
  • idobbligatorioUUID del pasto salvato da eliminare

Prova a dire «Elimina il pasto salvato chiamato vecchio pranzo»

Rivedere i tuoi pasti

Ripercorri ciò che hai registrato, un giorno o un intero periodo alla volta.

Visualizza

search_meals

Cerca tra i tuoi pasti passati per parola chiave e li raggruppa nelle varianti che ricorrono: quante volte hai registrato ciascuna, quando l'ultima volta e le sue calorie tipiche. È così che l'IA confronta la foto del tuo piatto con il modo in cui hai davvero registrato quel pasto in passato, ed è così che funziona “registra la mia solita colazione”. Cerca anche nei nomi degli ingredienti di un pasto ed elenca i tuoi pasti salvati il cui nome, descrizione o ingredienti corrispondono.

Parametri
  • queriesobbligatorioParole chiave alternative per l'alimento, in qualsiasi lingua tu abbia usato per registrare
  • daysfacoltativoQuanto indietro cercare (predefinito: un anno)
  • limitfacoltativoNumero massimo di voci da analizzare

Prova a dire «Registra la mia solita colazione»

Visualizza

get_meals_today

Mostra tutti i pasti che hai registrato oggi.

Parametri
  • detailfacoltativocompact (predefinito) mostra una riga per pasto con il relativo id; full include anche note e orari esatti

Prova a dire «Cosa ho mangiato oggi?»

Visualizza

get_meals_by_date

Mostra tutti i pasti che hai registrato in un giorno preciso.

Parametri
  • dateobbligatorioData in formato AAAA-MM-GG
  • detailfacoltativocompact (predefinito) mostra una riga per pasto con il relativo id; full include anche note e orari esatti

Prova a dire «Mostrami tutto quello che ho mangiato il 4 luglio»

Visualizza

get_meals_by_date_range

Recupera in un colpo solo tutti i pasti tra due date: comodo per rivedere una settimana o un mese. Una chiamata copre fino a 31 giorni; per periodi più lunghi, andamenti e riepiloghi ti danno i totali giornalieri.

Parametri
  • start_dateobbligatorioData di inizio (AAAA-MM-GG)
  • end_dateobbligatorioData di fine (AAAA-MM-GG), al massimo 31 giorni compreso quello di inizio
  • detailfacoltativocompact (predefinito) mostra una riga per pasto con il relativo id; full include anche note e orari esatti

Prova a dire «Elenca i miei pasti da lunedì a venerdì»

Visualizza

get_saved_meals

Vedi i tuoi pasti salvati con i loro valori per porzione e i loro ingredienti, eventualmente solo quelli il cui nome contiene un certo testo.

Parametri
  • name_containsfacoltativoSolo i pasti salvati il cui nome contiene questo testo

Prova a dire «Quali pasti ho salvato?»

Esporta

export_all_data

Esporta in un unico file ZIP tutto ciò che il servizio conserva su di te — meals.csv, meal_items.csv (gli ingredienti di ogni pasto registrato), saved_meals.csv e saved_meal_items.csv (i tuoi pasti salvati e i loro ingredienti), water.csv, weight.csv, body_measurements.csv, goals.csv, goals_history.csv (ogni modifica ai tuoi obiettivi, con data), profile.csv, account.csv (il tuo account di accesso), telemetry.csv (i dati sull'uso degli strumenti), connections.csv (le app di IA collegate e la sincronizzazione con Apple Health, senza alcun token), health_sync.csv (ciò che la sincronizzazione con Apple Health ha inviato negli ultimi 8 giorni) e un README.txt che spiega colonne, unità di misura e cosa non è incluso — e ti restituisce un link privato per il download, valido 60 minuti. Per ora solo i pasti si possono reimportare.

Prova a dire «Esporta tutti i miei dati: pasti, acqua, peso e obiettivi»

Monitoraggio dell'acqua

Tieni traccia dell'idratazione insieme a ciò che mangi.

Registra

log_water

Registra una voce di idratazione. Puoi indicare la quantità in qualsiasi unità (tazze, once, litri): la conversione in millilitri è automatica.

Parametri
  • amount_mlobbligatorioQuantità in millilitri (numero intero, > 0).

Prova a dire «Ho appena bevuto una bottiglia d'acqua da 500 ml»

Visualizza

get_water_today

Mostra il totale di acqua bevuta oggi e ogni singola voce.

Prova a dire «Quanta acqua ho bevuto oggi?»

Visualizza

get_water_by_date

Mostra il totale di acqua e le singole voci di un giorno preciso.

Parametri
  • dateobbligatorioData in formato AAAA-MM-GG

Prova a dire «Quanto ho bevuto ieri?»

Rimuovi

delete_water

Rimuove una voce d'acqua aggiunta per errore.

Parametri
  • idobbligatorioUUID della voce d'acqua da eliminare

Prova a dire «Elimina l'ultima voce d'acqua»

Peso e misure corporee

Registra pesate e misure prese con il metro, rivedile e segui l'andamento del peso verso il tuo obiettivo.

Registra

log_weight

Registra una misurazione del peso corporeo in kg o lb. Puoi registrare anche più pesate al giorno e il server salva il valore in un'unità standard, così l'unità che preferisci non altera mai il dato.

Parametri
  • weightobbligatorioValore del peso corporeo, nell'unità indicata da unit (> 0).

Prova a dire «Registra il mio peso: 74,2 kg stamattina»

Modifica

update_weight

Corregge una pesata esistente: il valore, l'orario o le note.

Parametri
  • idobbligatorioUUID della pesata da aggiornare
  • weightfacoltativoNuovo valore del peso, nell'unità indicata da unit.
  • logged_atfacoltativoData e ora in formato ISO 8601
  • notesfacoltativo

Prova a dire «Correggi la pesata di stamattina in 73,8 kg»

Rimuovi

delete_weight

Rimuove una pesata.

Parametri
  • idobbligatorioUUID della pesata da eliminare

Prova a dire «Elimina la pesata di oggi»

Visualizza

get_weight_today

Mostra le pesate di oggi nell'unità che preferisci.

Prova a dire «Quanto segnava la bilancia oggi?»

Visualizza

get_weight_by_date

Mostra le tue pesate di un giorno preciso.

Parametri
  • dateobbligatorioData in formato AAAA-MM-GG

Prova a dire «Quanto pesavo il primo del mese?»

Visualizza

get_weight_by_date_range

Mostra tutte le pesate tra due date, raggruppate per giorno con la media di ciascuno.

Parametri
  • start_dateobbligatorioData di inizio (AAAA-MM-GG)
  • end_dateobbligatorioData di fine (AAAA-MM-GG)

Prova a dire «Mostrami le pesate delle ultime due settimane»

Impostazione

set_weight_unit

Imposta se il peso viene mostrato e inserito in kg o lb. I valori salvati non cambiano: cambiano solo la visualizzazione e l'unità con cui vengono interpretati i numeri per impostazione predefinita.

Prova a dire «D'ora in poi usa le libbre per il mio peso»

Registra

log_body_measurement

Registra una misura presa con il metro da sarta in una zona del corpo (vita, fianchi, collo, torace, spalle, braccio, avambraccio, coscia o polpaccio), in cm o pollici. Il valore viene salvato così come l'hai inserito, insieme a un valore standard, così cambiare unità non altera mai un numero. I numeri molto lontani da un intervallo realistico per quella zona vengono rifiutati come probabili errori di battitura.

Parametri
  • kindobbligatorioLa zona misurata: waist, hips, neck, chest, shoulders, upper_arm, forearm, thigh o calf. Un valore per zona; il lato (sinistro o destro) può andare nelle note.
  • valueobbligatorioLa misura, nell'unità indicata da unit (> 0).
  • unitfacoltativocm o in; per impostazione predefinita, l'unità di lunghezza che hai salvato.
  • logged_atfacoltativoQuando è stata presa la misura, se non adesso
  • notesfacoltativoNote aggiuntive

Prova a dire «Registra il mio giro vita: 82 cm stamattina»

Visualizza

get_body_measurements

Elenca le tue misure corporee per giorno, dalla più vecchia alla più recente, anche per una sola zona. Copre gli ultimi 30 giorni se non indichi date, fino a 366 giorni per chiamata.

Parametri
  • kindfacoltativoSolo questa zona (ad es. waist)
  • start_datefacoltativoData di inizio (AAAA-MM-GG)
  • end_datefacoltativoData di fine (AAAA-MM-GG), fino a 366 giorni compreso quello di inizio

Prova a dire «Mostrami le misure del giro vita degli ultimi tre mesi»

Modifica

update_body_measurement

Corregge una misura esistente: il valore, la sua unità, l'orario o le note. La zona invece non cambia: una zona diversa è una nuova voce.

Parametri
  • idobbligatorioUUID della misura da aggiornare
  • valuefacoltativoNuovo valore, nell'unità indicata da unit.
  • unitfacoltativoPer impostazione predefinita, l'unità in cui è stata registrata la voce.
  • logged_atfacoltativoData e ora in formato ISO 8601
  • notesfacoltativoNote sostitutive

Prova a dire «La misura dei fianchi era 98 cm, non 89»

Rimuovi

delete_body_measurement

Rimuove una misura corporea.

Parametri
  • idobbligatorioUUID della misura da eliminare

Prova a dire «Elimina la misura del collo di oggi»

Impostazione

set_length_unit

Imposta se le misure corporee vengono mostrate e inserite in centimetri o pollici. È un'impostazione separata dall'unità di peso. I valori salvati non cambiano: cambiano solo la visualizzazione e l'unità con cui vengono interpretati i numeri per impostazione predefinita.

Prova a dire «Usa i pollici per le mie misure»

Obiettivi e progressi

Imposta gli obiettivi e guarda come va ogni giornata.

Impostazione

set_nutrition_goals

Imposta i tuoi obiettivi giornalieri di calorie, macro, grassi saturi, fibre, zuccheri, zuccheri aggiunti, alcol, caffeina e acqua, più un peso obiettivo facoltativo. Calorie, proteine, carboidrati, grassi, fibre e acqua sono valori da raggiungere; grassi saturi, zuccheri totali, zuccheri aggiunti, alcol e caffeina sono limiti da non superare, e i progressi vengono descritti di conseguenza. Aggiorna solo i campi che indichi; gli altri restano invariati.

Parametri
  • daily_caloriesfacoltativoObiettivo calorico giornaliero (kcal). Null per rimuoverlo.
  • daily_protein_gfacoltativoObiettivo giornaliero di proteine (grammi). Null per rimuoverlo.
  • daily_carbs_gfacoltativoObiettivo giornaliero di carboidrati (grammi). Null per rimuoverlo.
  • daily_fat_gfacoltativoObiettivo giornaliero di grassi (grammi). Null per rimuoverlo.
  • daily_saturated_fat_gfacoltativoLimite giornaliero di grassi saturi (grammi). Null per cancellarlo.
  • daily_fiber_gfacoltativoObiettivo giornaliero di fibre (grammi), un minimo da raggiungere. Null per rimuoverlo.
  • daily_sugar_gfacoltativoLimite giornaliero di zuccheri totali (grammi), un massimo da non superare. Gli zuccheri totali comprendono quelli naturalmente presenti in frutta e latte, quindi le linee guida ufficiali sugli zuccheri aggiunti indicano un valore molto più basso. Null per rimuoverlo.
  • daily_added_sugar_gfacoltativoLimite giornaliero di zuccheri aggiunti (grammi), un massimo da non superare. Conta solo gli zuccheri aggiunti, non quelli naturalmente presenti in frutta e latte; i valori delle linee guida ufficiali sugli zuccheri di solito si riferiscono a questa misura (l'American Heart Association indica al massimo 25 g al giorno per le donne e 36 g per gli uomini). 0 è un limite reale che significa nessuno. Null per rimuoverlo.
  • daily_alcohol_gfacoltativoLimite giornaliero di alcol in grammi di etanolo puro, un massimo da non superare. Un drink standard USA equivale a 14 g, un'unità alcolica britannica a 7,9 g. Null per rimuoverlo.
  • daily_caffeine_mgfacoltativoLimite giornaliero di caffeina in milligrammi, un massimo da non superare. EFSA e FDA fissano il tetto per gli adulti sani a 400 mg al giorno (circa quattro caffè filtro); il valore dell'EFSA in gravidanza è 200 mg. 0 è un limite vero e proprio: nessuna caffeina. Null per rimuoverlo.
  • daily_water_mlfacoltativo
  • target_weightfacoltativo

Prova a dire «Imposta i miei obiettivi a 2200 calorie, 160 g di proteine e un peso obiettivo di 75 kg»

Visualizza

get_nutrition_goals

Mostra i tuoi obiettivi giornalieri attuali di calorie e macro, l'eventuale obiettivo di fibre e i limiti di zuccheri o caffeina e, se monitori l'alcol, il tuo limite di alcol.

Prova a dire «Quali sono i miei obiettivi giornalieri?»

VisualizzaUI interattiva

get_goal_progress

Mostra a che punto sei oggi rispetto ai tuoi obiettivi: anelli che confrontano quanto hai assunto con ciascun obiettivo, più i progressi sul peso corporeo. Tocca l'anello di una macro per vedere quali pasti hanno contribuito.

Prova a dire «Come sto andando oggi con i miei obiettivi?»

VisualizzaUI interattiva

get_nutrition_summary

Mostra i totali nutrizionali giornalieri di un intervallo di date in una dashboard interattiva: riquadri delle macro rispetto agli obiettivi e un dettaglio giorno per giorno. Una chiamata copre fino a 92 giorni; per periodi più lunghi, gli andamenti ti danno le medie mobili.

Parametri
  • start_dateobbligatorioData di inizio (AAAA-MM-GG)
  • end_dateobbligatorioData di fine (AAAA-MM-GG), al massimo 92 giorni compreso quello di inizio

Prova a dire «Fammi un riepilogo della settimana appena passata»

Impostazioni e account

Preferenze che rendono tutto più preciso, e pieno controllo sui tuoi dati.

Visualizza

get_profile

Mostra in un colpo solo tutte le tue impostazioni attuali: fuso orario (con data e ora locali), lingua dei widget, unità di peso e di lunghezza preferite, se i widget in chat sono visibili e se il monitoraggio dell'alcol è attivo.

Prova a dire «Quali sono le mie impostazioni attuali?»

Impostazione

set_timezone

Imposta il tuo fuso orario IANA, così il giorno cambia alla tua mezzanotte locale: un pasto registrato alle 23 conta per quel giorno, non per il giorno successivo in UTC.

Prova a dire «Sono a Berlino: imposta il mio fuso orario»

Impostazione

set_language

Imposta la lingua dell'interfaccia dei widget in chat (dashboard e grafici), non quella in cui ti risponde l'IA.

Parametri
  • localeobbligatorioCodice ISO 639-1, ad es. de, ja. Lingue supportate: inglese, tedesco, spagnolo, francese, olandese, polacco, italiano, ucraino, giapponese, turco.

Prova a dire «Mostra i miei widget in tedesco»

Visualizza

get_current_time

Controlla data e ora attuali nel tuo fuso orario, più l'istante UTC. Alcune app non dicono all'assistente che ore sono: è così che capisce cosa vogliono dire “stamattina” o “oggi” senza doverlo chiedere a te (se non hai impostato un fuso orario, usa UTC).

Prova a dire «Che ore sono adesso da me?»

Impostazione

set_widget_display

Attiva o disattiva i widget visivi in chat: dashboard, anelli degli obiettivi e grafici degli andamenti. Se sono disattivati, gli stessi strumenti rispondono solo con testo e dati. Sono attivi per impostazione predefinita; la modifica vale per le nuove conversazioni.

Parametri
  • enabledobbligatoriotrue per mostrare i widget, false per risposte solo testuali

Prova a dire «Disattiva i widget»

Impostazione

set_alcohol_tracking

Attiva o disattiva il monitoraggio dell'alcol e scegli se contare le bevande in drink standard USA o in unità alcoliche britanniche. È disattivato per impostazione predefinita, quindi devi chiederlo tu. Se lo disattivi di nuovo, l'alcol sparisce da pasti, obiettivi e progressi e l'importatore di file smette di leggere la colonna dell'alcol: nulla di ciò che hai già registrato viene eliminato, l'esportazione CSV lo include comunque e l'alcol ricompare se riattivi il monitoraggio. La modifica vale dal tuo prossimo messaggio, senza riavviare nulla.

Parametri
  • enabledobbligatoriotrue per mostrare l'alcol in pasti, obiettivi e progressi, false per nasconderlo
  • drink_unitfacoltativoQuale drink standard mostrare accanto ai grammi: us (14 g per drink) o uk (7,9 g per unità). Predefinito: us; ciò che viene salvato davvero sono i grammi di etanolo puro.

Prova a dire «Inizia a tenere traccia dell'alcol che bevo, in unità britanniche»

Rimuovi

delete_account

Elimina definitivamente il tuo account Nutrition MCP e tutti i dati che conserva su di te. L'operazione è irreversibile, quindi lo strumento non fa nulla senza una conferma esplicita, e all'IA viene chiesto di verificare con te prima di inviarla.

Prova a dire «Elimina il mio account e tutti i miei dati»

Risoluzione dei problemi

Qualcosa non funziona? Quasi tutti i problemi si risolvono in fretta.

Non hai ancora risolto? anton@nutrition-mcp.com

01Il connettore non si collega o continua a chiedermi di accedere

Rimuovi il connettore e aggiungilo di nuovo con esattamente https://nutrition-mcp.com/mcp: la parte /mcp è obbligatoria. In Claude apri Customize → Connectors, disconnetti Nutrition e ricollegalo; in ChatGPT vai su Settings → Apps. Accedi con la stessa email e password, o con lo stesso account Google, che hai usato la prima volta: i tuoi dati appartengono al tuo account, non al collegamento, quindi ricollegandoti non perdi nulla. Una volta collegato, il connettore resta attivo finché lo usi almeno una volta ogni 90 giorni; se smette di funzionare, basta ricollegarlo allo stesso modo.

02La pagina di accesso mostra {"error":"session_expired"}

La pagina di accesso resta valida solo 10 minuti e si azzera anche ogni volta che il server si riavvia per un aggiornamento. Torna alla pagina di accesso e ricaricala, oppure ricomincia il collegamento dalla tua app di IA, poi accedi senza fare lunghe pause. Se invece compare session_mismatch, l'accesso è stato completato in un browser diverso da quello in cui era iniziato: ricomincia dalla tua app di IA e completalo nello stesso browser.

03Non riesco ad accedere, o ho dimenticato la password

Usa Accedi se hai già un account: con email o password sbagliate compare “Email o password errate” e non viene mai creato un nuovo account. Crea account serve solo la prima volta. Controlla che l'email non contenga errori di battitura. Se hai creato l'account con Continua con Google, usa di nuovo quel pulsante. Per ora non puoi reimpostare la password da solo: scrivi ad anton@nutrition-mcp.com dall'indirizzo associato al tuo account e la reimposterò io.

04Mi sono ricollegato e il mio storico è sparito

Ogni indirizzo email corrisponde a un account separato, quindi se accedi con un'altra email ne apri uno vuoto: non è stato eliminato nulla. Disconnettiti e accedi di nuovo con l'indirizzo che hai usato la prima volta. Se non sei sicuro di quale fosse, scrivi ad anton@nutrition-mcp.com.

05L'IA risponde ma non registra nulla

Assicurati che il connettore sia attivo in questa conversazione (in Claude controlla il menu degli strumenti nella casella del messaggio) e fai una richiesta esplicita, per esempio “registra la mia colazione in Nutrition”. Se l'app ti chiede il permesso di usare uno strumento, concedilo.

06I miei pasti compaiono nel giorno sbagliato

I giorni vengono calcolati nel tuo fuso orario e, se non ne hai mai impostato uno, si usa UTC. Chiedi “che fuso orario ho impostato?” (get_profile) e, se è sbagliato, “imposta il mio fuso orario su Europe/Berlin” (set_timezone). Da quel momento tutto ciò che hai registrato viene raggruppato secondo il tuo giorno locale, comprese le voci passate. L'unica eccezione sono le voci a cui hai dato un orario preciso mentre il fuso orario era sbagliato: conservano l'istante con cui sono state salvate, quindi possono risultare spostate di un'ora o di un giorno. Chiedi all'IA di spostarle alla data e all'ora giuste (update_meal). Imposta il fuso orario anche prima di importare lo storico: i pasti importati conservano l'istante a cui sono stati assegnati e, se reimporti il file di un'altra app dopo aver cambiato fuso orario, vengono aggiunti una seconda volta. Un'esportazione di Nutrition MCP invece viene riconosciuta e non si duplica.

07Vedo solo testo, niente grafici né schede

Le schede visive richiedono un'app che supporti i pannelli interattivi di MCP Apps, come Claude o ChatGPT; gli altri client ricevono le stesse informazioni come testo. Se hai disattivato i widget, chiedi di riattivarli (set_widget_display) e inizia una nuova conversazione: una chat già aperta mantiene la vecchia impostazione finché non si ricollega. La piccola scheda che compare dopo aver registrato un pasto appare solo quando hai impostato gli obiettivi giornalieri (set_nutrition_goals).

08L'importatore non si apre o dice che non può salvare

Il pannello dell'importatore richiede un'app che mostri pannelli interattivi e abbia i widget attivi. Se dice Questa app non consente al pannello di scrivere nel tuo diario, o non compare proprio, chiedi all'IA di importare il file direttamente: allega o incolla il CSV e userà bulk_import_meals, che controlla ogni riga e salta i duplicati, quindi reinviarlo è sicuro, purché nel frattempo tu non abbia cambiato fuso orario. Imposta il fuso orario prima della prima importazione: se reimporti il file di un'altra app dopo averlo cambiato, le righe vengono aggiunte di nuovo. Se usi il pannello dell'importatore e vuoi importare anche la colonna dell'alcol, attiva prima il monitoraggio dell'alcol: finché è disattivato, il pannello salta quella colonna, e reimportare in seguito non la recupererà.

09Vedo “Rate limit exceeded” o “Too many failed authentication attempts”

Ogni account può fare 60 richieste al minuto, e ogni chiamata a uno strumento conta almeno come una. Aspetta i secondi indicati nel messaggio, poi continua. Per inserire molti pasti passati usa l'importatore invece di registrarli uno per uno. Le pagine di accesso consentono 30 richieste al minuto per rete. Dopo 20 tentativi di connessione rifiutati di fila dalla stessa rete (di solito un vecchio connettore scollegato che continua a riprovare), le connessioni da quella rete vengono sospese per 5 minuti, e le sospensioni successive si allungano fino a un massimo di un'ora. Per fermare i tentativi, rimuovi il vecchio connettore e aggiungilo di nuovo.

10Un codice a barre non viene trovato, o i valori sembrano sbagliati

I dati dei codici a barre vengono da Open Food Facts, un database collaborativo, quindi alcuni prodotti mancano e alcune schede non sono aggiornate. Assicurati che tutte le 8–14 cifre sotto il codice a barre siano state lette correttamente. Se il prodotto non c'è, l'IA può stimare i valori dal nome o da una foto della tabella nutrizionale, e puoi correggere qualsiasi valore in seguito. Aggiungere il prodotto su openfoodfacts.org aiuta tutti. Open Food Facts non ha dati sulla caffeina, quindi la caffeina si ricava dall'etichetta o da quantità tipiche.

11L’IA dice «USDA data is unavailable until …»

Le ricerche di alimenti generici passano da USDA FoodData Central con una chiave API condivisa da tutti gli utenti di questo server, e USDA limita quante richieste può fare quella chiave ogni ora. Il server smette di chiamare USDA in tre casi: quando USDA segnala che il suo limite è stato raggiunto, e in quel caso le chiamate si fermano per 60 minuti; mentre il margine orario residuo della chiave è quasi esaurito; e quando hai fatto 30 consultazioni USDA nell’ultima ora. Il messaggio indica l’orario in cui USDA torna disponibile, nel fuso orario del tuo profilo (UTC se non ne è impostato uno). I risultati di ricerca non vengono salvati, quindi le ricerche attendono fino ad allora. Un alimento consultato negli ultimi 30 giorni viene conservato sul server e continua a funzionare durante una pausa, e recuperare un alimento già salvato non conta sulle tue 30 all’ora. I nomi USDA sono solo in inglese, quindi cerca in inglese. I prodotti confezionati non sono interessati: cercali tramite codice a barre.

12Ieri non è ancora in Apple Health

La sincronizzazione con Apple Health invia solo i giorni conclusi. Un giorno si considera concluso alle 05:00 del mattino dopo nel tuo fuso orario, quindi ieri arriva con la prima sincronizzazione dopo le 05:00 di oggi, e oggi compare in Salute solo domani. Una sincronizzazione parte quando scatta una delle automazioni del comando rapido (aprire l'app Salute, fermare la sveglia) oppure quando esegui Nutrition MCP Health nell'app Comandi Rapidi e scegli Sync now. Una mattina saltata si recupera da sola: ogni sincronizzazione guarda indietro agli ultimi 7 giorni. I giorni seguono il fuso orario del tuo profilo (get_profile) oppure, se non ne hai mai impostato uno, quello che il tuo iPhone ha indicato al collegamento (pasti nel giorno sbagliato). I giorni precedenti al collegamento vengono inviati solo se, collegandoti, hai scelto di recuperare fino a 7 giorni prima.

13Apple Health mostra più della mia chat

Apple Health può aggiungere a un valore, ma non può mai ridurne uno che ha già. Un pasto che aggiungi a un giorno già inviato arriva come una piccola voce in più alle 12:01, 12:02 e così via, purché il giorno rientri negli ultimi 7 giorni. Se elimini o riduci un pasto dopo che il suo giorno è stato inviato, Salute resta più alto e il comando rapido mostra un avviso con la differenza. Per correggere, apri l'app Salute, vai su Sfoglia → Alimentazione, apri il tipo di dato, tocca Mostra tutti i dati, elimina le voci di quel giorno provenienti da Comandi Rapidi e inserisci a mano il totale corretto. Non usare mai Elimina tutti i dati da “Comandi Rapidi”: cancella anche ciò che hanno registrato gli altri tuoi comandi rapidi. Se ogni giorno sembra raddoppiato, un'altra app scrive gli stessi tipi e Salute li somma: disattivane una in Condivisione → App nell'app Salute.

14La sincronizzazione con Apple Health si è interrotta

Apri l'app Comandi Rapidi ed esegui Nutrition MCP Health a mano: ti dice cosa non ha funzionato. Se ti chiede di collegarti di nuovo, il collegamento è terminato (dopo 90 giorni senza sincronizzazione, 365 giorni dopo il collegamento o dopo Disconnect): eseguilo, accedi nella pagina che apre con lo stesso account che usi nella tua app di IA e completa entro 30 minuti. Se sincronizza quando lo esegui ma non da solo, controlla che le sue automazioni nella scheda Automazione di Comandi Rapidi siano attive e impostate su Esegui immediatamente. Se un avviso dice che un giorno non ha raggiunto Apple Health, consenti a Comandi Rapidi di scrivere ogni tipo di dato sull'alimentazione in Condivisione → App → Comandi Rapidi nell'app Salute, poi eseguilo di nuovo. Collegare un nuovo iPhone sostituisce il collegamento di quello vecchio.

16Come elimino il mio account?

Chiedi all'IA di eliminare il tuo account Nutrition MCP (delete_account). Ti chiederà di confermare, poi eliminerà definitivamente pasti, pasti salvati, acqua, peso, misure corporee, obiettivi, impostazioni, il registro degli strumenti usati dalla tua app di IA, eventuali file di esportazione, i tuoi dati di accesso e l'account stesso. L'operazione non si può annullare, quindi, se vuoi una copia dei tuoi dati, esportali prima. Poi rimuovi il connettore dalla tua app. Se in futuro accedi di nuovo con la stessa email, verrà creato un nuovo account vuoto.

17Come segnalo un bug o un problema di sicurezza?

Segnala i bug su GitHub Issues: indica quale app usi (Claude, ChatGPT, …), cosa hai chiesto, cosa è successo e più o meno quando. Non includere mai la tua password. Per favore, non segnalare pubblicamente i problemi di sicurezza: segnalali in privato tramite la segnalazione privata delle vulnerabilità di GitHub o via email, come descritto nella policy di sicurezza. Per tutto il resto, scrivi ad anton@nutrition-mcp.com.