Tutto quello che la tua IA può fare

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.

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.

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.

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.

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.

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.

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).

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à.

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.

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.

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.

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.

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.

I link di esportazione scadono dopo 60 minuti e ogni nuova esportazione sostituisce il file precedente. Chiedi una nuova esportazione (export_all_data) e scaricala subito. Se l'esportazione riporta 0 pasti quando ti aspettavi il tuo storico, probabilmente hai fatto l'accesso con un'altra email: vedi Mi sono ricollegato e il mio storico è sparito.

Chiedi all'IA di eliminare il tuo account Nutrition MCP (delete_account). Ti chiederà di confermare, poi eliminerà definitivamente pasti, 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.

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.