Référence · 41 outils répartis en 7 catégories

Tout ce que ton IA peut faire

Tu n'appelles jamais ces outils toi-même : tu parles simplement à Claude, à ChatGPT ou à un autre client MCP, et il choisit le bon outil. Voici tous les outils que le serveur Nutrition MCP met à disposition pour les repas, les calories et les macros, l'eau et le poids, avec ce que fait chacun et une phrase qui le déclenche.

Cette page a été traduite avec l'IA à partir de l'anglais et n'a pas été relue par une personne. Lire l'original en anglais

Enregistrer tes repas

Le cœur de l'app : note ce que tu as mangé, quelle que soit la façon dont tu le décris.

EnregistrerWidget interactif

log_meal

Enregistre ce que tu as mangé avec les calories et les macros, plus les fibres, les sucres totaux et ajoutés, l'alcool et la caféine quand ces valeurs sont disponibles. Décris-le avec tes mots : l'IA estime les valeurs, te demande la taille de la portion si elle n'est pas claire, et peut d'abord récupérer les données de l'étiquette via un code-barres ou sur le web.

Paramètres
  • descriptionrequisCe qui a été mangé
  • meal_typerequispetit-déjeuner, déjeuner, dîner ou collation
  • caloriesfacultatifCalories totales
  • protein_gfacultatifProtéines en grammes
  • carbs_gfacultatifGlucides en grammes
  • fat_gfacultatifLipides en grammes
  • fiber_gfacultatifFibres alimentaires en grammes. L'IA a pour consigne de remplir ce champ à chaque repas, en l'estimant à partir des ingrédients quand aucune étiquette ne donne la valeur, car un champ vide n'est pas un zéro : il exclut toute la journée de ta moyenne de fibres
  • sugar_gfacultatifSucres totaux en grammes : la valeur qu'une étiquette indique sous « dont sucres », y compris le sucre naturellement présent dans les fruits et le lait, pas seulement le sucre ajouté. Renseigné à chaque repas, selon les mêmes règles que les fibres
  • added_sugar_gfacultatifSucres ajoutés en grammes : le sucre ajouté lors de la transformation ou de la préparation (sucre de table, sirops, miel, le sucre des boissons et aliments sucrés). Ils font partie des sucres totaux et ne les dépassent jamais. Le sucre naturellement présent dans les fruits entiers, les légumes et le lait nature n'est pas ajouté, pas plus que celui d'un jus 100 % pur fruit. Renseigné à chaque repas, selon les mêmes règles que les fibres : les aliments bruts valent 0, le sucre d'un soda est entièrement ajouté, et la ligne « Includes Xg Added Sugars » des étiquettes américaines est utilisée quand elle existe. Accompagne sugar_g : un repas avec des sucres totaux mais sans sucres ajoutés peut ne pas être enregistré
  • alcohol_gfacultatifGrammes d'éthanol pur, ni le volume de la boisson ni son degré d'alcool : l'IA le calcule à partir de la quantité servie et du degré (une bière de 330 ml à 5 % en contient 13 g)
  • caffeine_mgfacultatifCaféine en milligrammes, pas en grammes : c'est le seul champ ici qui n'est pas en grammes, car c'est l'unité qu'emploient toutes les étiquettes et toutes les recommandations (un café filtre contient environ 95 mg, un expresso 63 mg, une canette de cola 34 mg). La caféine n'apporte aucune calorie. Contrairement aux fibres et aux sucres, elle n'est envoyée que pour ce qui contient réellement de la caféine : un 0 enregistré ferait apparaître une ligne caféine sur ton tableau de bord pour un nutriment que tu ne consommes jamais
  • logged_atfacultatifQuand tu l'as mangé, si ce n'est pas maintenant : permet d'enregistrer quelque chose après coup
  • notesfacultatifNotes supplémentaires

Dis par exemple « Enregistre pour le déjeuner un burrito bowl au poulet avec supplément guacamole »

…ou prends simplement ton assiette en photo : l'IA identifie chaque plat, estime les portions avec des mesures du quotidien (un verre, une poignée), regarde comment tu l'as enregistré les fois précédentes et te demande confirmation avant d'enregistrer.

Rechercher

lookup_barcode

Récupère sur Open Food Facts les valeurs nutritionnelles indiquées sur l'étiquette d'un produit emballé, à partir de son code-barres (EAN/UPC de 8 à 14 chiffres), ainsi que son Nutri-Score et son groupe de transformation NOVA quand Open Food Facts les connaît. Les sucres ajoutés sont indiqués quand Open Food Facts les fournit, et signalés quand Open Food Facts les a estimés à partir des ingrédients. Tu peux taper les chiffres ou les lire sur une photo de l'emballage ; le résultat peut ensuite être enregistré, ajusté à la quantité que tu as mangée.

Dis par exemple « Scanne ce code-barres : 3017620422003 »

…ou envoie une photo de l'emballage : l'IA y lit les chiffres du code-barres.

ImporterWidget interactif

start_meal_import

Ouvre un outil d'import dans le chat pour récupérer ton historique depuis une autre app : choisis le CSV exporté depuis MyFitnessPal, Cronometer, Lose It!, MacroFactor ou une autre app de suivi, associe ses colonnes aux calories, aux macros, aux fibres, aux sucres totaux et ajoutés et à la caféine (plus l'alcool si tu as activé son suivi), puis vérifie ce qui sera ajouté avant de confirmer. Le fichier est lu dans ton navigateur, rien n'est enregistré tant que tu n'as pas validé l'aperçu, et réimporter le même fichier ne crée pas de doublons.

Dis par exemple « Importe mon historique de repas depuis MyFitnessPal »

Importer

bulk_import_meals

Ajoute d'un coup un lot de repas passés (jusqu'à 50 à la fois) au lieu de les enregistrer un par un. L'outil d'import ci-dessus passe par lui pour enregistrer les repas, et l'IA peut aussi l'utiliser directement pour des repas que tu as collés dans le chat. Chaque ligne est d'abord vérifiée, et tout ce qui ne convient pas est signalé ligne par ligne : renvoyer les mêmes lignes est donc sans risque et ne crée pas de doublons de ce qui est déjà enregistré, tant que ton fuseau horaire n'a pas changé entre-temps.

Paramètres
  • mealsrequisLes lignes à importer, dans l'ordre du fichier source (1 à 50 par appel). Chaque ligne peut contenir une heure, un type de repas, une description, des notes et les mêmes valeurs qu'un repas enregistré : calories, protein_g, carbs_g, fat_g, fiber_g, sugar_g (sucres totaux), added_sugar_g (sucres ajoutés, inclus dans le total), alcohol_g (grammes d'éthanol pur) et caffeine_mg (milligrammes, pas grammes)
  • expected_row_countrequisNombre de lignes transmises par cet appel, compté dans le fichier source, pour repérer une ligne perdue
  • expected_total_kcalfacultatifTotal des calories du fichier source, rapproché de ce qui est reçu
  • dry_runfacultatifIndiquer ce qui se passerait, sans rien écrire
  • on_errorfacultatifImporter les lignes valides et signaler les autres, ou ne rien écrire si une ligne échoue
  • source_appfacultatifL'app d'où provient le fichier

Dis par exemple « Voici les repas de la semaine dernière, copiés depuis mon ancienne app : ajoute-les tous »

ModifierWidget interactif

update_meal

Modifie un repas déjà enregistré : sa description, une macro, les fibres, les sucres totaux ou ajoutés, l'alcool ou la caféine, l'heure ou les notes. C'est aussi comme ça qu'on complète une valeur manquante : si un repas a été enregistré sans ses fibres, ses sucres ou ses sucres ajoutés, le serveur le signale et l'IA les ajoute ici une fois que tu as donné ton accord.

Paramètres
  • idrequisUUID du repas à modifier
  • descriptionfacultatif
  • caloriesfacultatif
  • protein_gfacultatif
  • carbs_gfacultatif
  • fat_gfacultatif
  • fiber_gfacultatif
  • sugar_gfacultatifSucres totaux, pas le sucre ajouté
  • added_sugar_gfacultatifSucres ajoutés uniquement, jamais plus que les sucres totaux. Accompagne sugar_g : une modification des sucres totaux d'un repas sans sucres ajoutés enregistrés peut ne pas être enregistrée sans cette valeur
  • alcohol_gfacultatifGrammes d'éthanol pur, pas le volume de la boisson
  • caffeine_mgfacultatifMilligrammes, pas grammes
  • logged_atfacultatif
  • notesfacultatif

Dis par exemple « En fait, ce déjeuner faisait 600 calories, pas 500 : corrige-le »

Supprimer

delete_meal

Supprime un repas enregistré par erreur.

Paramètres
  • idrequisUUID du repas à supprimer

Dis par exemple « Supprime la collation que j'ai enregistrée cet après-midi »

Consulter tes repas

Reviens sur ce que tu as enregistré, jour par jour ou sur toute une période.

Consulter

search_meals

Recherche tes anciens repas par mot-clé et vois-les regroupés selon tes variantes récurrentes : combien de fois chacune a été enregistrée, la dernière fois, et ses calories typiques. C'est ainsi que l'IA compare une photo de ton assiette à la façon dont tu as réellement enregistré ce repas auparavant, et c'est ce qui fait fonctionner « enregistre mon petit-déjeuner habituel ».

Paramètres
  • queriesrequisDifférentes façons de nommer l'aliment, dans n'importe quelle langue utilisée dans ton journal
  • daysfacultatifJusqu'où remonter (un an par défaut)
  • limitfacultatifNombre maximal d'entrées à analyser

Dis par exemple « Enregistre mon petit-déjeuner habituel »

Consulter

get_meals_today

Affiche tous les repas enregistrés aujourd'hui.

Paramètres
  • detailfacultatifcompact (par défaut) pour une ligne par repas avec son identifiant, ou full pour inclure les notes et les heures exactes

Dis par exemple « Qu'est-ce que j'ai mangé aujourd'hui ? »

Consulter

get_meals_by_date

Affiche tous les repas enregistrés un jour donné.

Paramètres
  • daterequisDate au format AAAA-MM-JJ
  • detailfacultatifcompact (par défaut) pour une ligne par repas avec son identifiant, ou full pour inclure les notes et les heures exactes

Dis par exemple « Montre-moi tout ce que j'ai mangé le 4 juillet »

Consulter

get_meals_by_date_range

Récupère d'un coup tous les repas entre deux dates : pratique pour faire le point sur une semaine ou un mois. Un appel couvre jusqu'à 31 jours ; pour des périodes plus longues, les tendances et les résumés donnent les totaux quotidiens.

Paramètres
  • start_daterequisDate de début (AAAA-MM-JJ)
  • end_daterequisDate de fin (AAAA-MM-JJ), 31 jours maximum, jour de début compris
  • detailfacultatifcompact (par défaut) pour une ligne par repas avec son identifiant, ou full pour inclure les notes et les heures exactes

Dis par exemple « Liste mes repas du lundi au vendredi »

Exporter

export_all_data

Exporte tout ce que le service conserve à ton sujet dans un seul fichier ZIP : meals.csv, water.csv, weight.csv, body_measurements.csv, goals.csv, goals_history.csv (chaque modification de tes objectifs, datée), profile.csv, account.csv (ton compte de connexion), telemetry.csv (l'historique d'utilisation des outils), connections.csv (tes apps d'IA connectées et la synchronisation Apple Health, sans aucun jeton), health_sync.csv (ce que la synchronisation Apple Health a envoyé ces 8 derniers jours) et un README.txt qui explique les colonnes, les unités et ce qui n'est pas inclus. Tu reçois en retour un lien de téléchargement privé, valable 60 minutes. Pour l'instant, seuls les repas peuvent être réimportés.

Dis par exemple « Exporte toutes mes données : repas, eau, poids et objectifs »

Suivi de l'eau

Suis ton hydratation en même temps que tes repas.

Enregistrer

log_water

Enregistre une entrée d'eau. Donne la quantité dans l'unité de ton choix (tasses, onces, litres) : elle est convertie en millilitres pour toi.

Paramètres
  • amount_mlrequisQuantité en millilitres (nombre entier, > 0).

Dis par exemple « Je viens de boire une bouteille d'eau de 500 ml »

Consulter

get_water_today

Affiche ton total d'eau du jour et chaque entrée.

Dis par exemple « Combien d'eau ai-je bu aujourd'hui ? »

Consulter

get_water_by_date

Affiche ton total d'eau et tes entrées d'un jour donné.

Paramètres
  • daterequisDate au format AAAA-MM-JJ

Dis par exemple « Combien ai-je bu hier ? »

Supprimer

delete_water

Supprime une entrée d'eau ajoutée par erreur.

Paramètres
  • idrequisUUID de l'entrée d'eau à supprimer

Dis par exemple « Supprime ma dernière entrée d'eau »

Poids et mensurations

Enregistre tes pesées et tes mensurations, consulte-les et suis l'évolution de ton poids vers ton poids cible.

Enregistrer

log_weight

Enregistre une mesure de ton poids en kg ou en lb. Tu peux te peser plusieurs fois par jour, et le serveur enregistre la valeur dans une unité de référence, pour que ta préférence d'unité ne fausse jamais le chiffre.

Paramètres
  • weightrequisValeur du poids, en unit (> 0).

Dis par exemple « Enregistre mon poids : 74,2 kg ce matin »

Modifier

update_weight

Corrige une pesée existante : la valeur, l'horodatage ou ses notes.

Paramètres
  • idrequisUUID de la pesée à modifier
  • weightfacultatifNouvelle valeur du poids, en unit.
  • logged_atfacultatifHorodatage ISO 8601
  • notesfacultatif

Dis par exemple « Corrige la pesée de ce matin : 73,8 kg »

Supprimer

delete_weight

Supprime une pesée.

Paramètres
  • idrequisUUID de la pesée à supprimer

Dis par exemple « Supprime la pesée d'aujourd'hui »

Consulter

get_weight_today

Affiche tes pesées du jour, dans ton unité préférée.

Dis par exemple « Quel est mon poids aujourd'hui ? »

Consulter

get_weight_by_date

Affiche tes pesées d'un jour donné.

Paramètres
  • daterequisDate au format AAAA-MM-JJ

Dis par exemple « Combien je pesais le 1er ? »

Consulter

get_weight_by_date_range

Récupère toutes les pesées entre deux dates, regroupées par jour avec la moyenne de chaque jour.

Paramètres
  • start_daterequisDate de début (AAAA-MM-JJ)
  • end_daterequisDate de fin (AAAA-MM-JJ)

Dis par exemple « Montre mes pesées des deux dernières semaines »

Régler

set_weight_unit

Choisis si les poids s'affichent et se saisissent en kg ou en lb. Les valeurs enregistrées ne changent pas : seuls l'affichage et l'unité retenue par défaut à la saisie changent.

Dis par exemple « Passe mon poids en livres à partir de maintenant »

Enregistrer

log_body_measurement

Enregistre une mesure au mètre ruban d'une zone du corps (taille, hanches, cou, poitrine, épaules, haut du bras, avant-bras, cuisse ou mollet) en cm ou en pouces. La valeur est conservée telle que tu l'as saisie, avec une valeur de référence, pour qu'un changement d'unité ne modifie jamais un chiffre. Les nombres très éloignés d'une plage réaliste pour la zone sont refusés, car il s'agit probablement de fautes de frappe.

Paramètres
  • kindrequisLa zone mesurée : waist, hips, neck, chest, shoulders, upper_arm, forearm, thigh ou calf. Une valeur par zone ; le côté (gauche ou droit) peut figurer dans les notes.
  • valuerequisLa mesure, en unit (> 0).
  • unitfacultatifcm ou in ; par défaut, ton unité de longueur enregistrée.
  • logged_atfacultatifMoment de la mesure, si ce n'est pas maintenant
  • notesfacultatifNotes supplémentaires

Dis par exemple « Enregistre mon tour de taille : 82 cm ce matin »

Consulter

get_body_measurements

Liste tes mensurations par jour, de la plus ancienne à la plus récente, éventuellement pour une seule zone. Couvre les 30 derniers jours si tu n'indiques pas de dates, jusqu'à 366 jours par appel.

Paramètres
  • kindfacultatifUniquement cette zone (par ex. waist)
  • start_datefacultatifDate de début (AAAA-MM-JJ)
  • end_datefacultatifDate de fin (AAAA-MM-JJ), jusqu'à 366 jours en comptant le premier

Dis par exemple « Montre mes tours de taille des trois derniers mois »

Modifier

update_body_measurement

Corrige une mesure existante : la valeur, son unité, l'heure ou les notes. La zone elle-même ne change pas ; une autre zone fait l'objet d'une nouvelle entrée.

Paramètres
  • idrequisUUID de la mesure à modifier
  • valuefacultatifNouvelle valeur, en unit.
  • unitfacultatifPar défaut, l'unité dans laquelle l'entrée a été enregistrée.
  • logged_atfacultatifHorodatage ISO 8601
  • notesfacultatifNotes de remplacement

Dis par exemple « Mon tour de hanches faisait 98 cm, pas 89 »

Supprimer

delete_body_measurement

Supprime une mensuration.

Paramètres
  • idrequisUUID de la mesure à supprimer

Dis par exemple « Supprime la mesure du tour de cou d'aujourd'hui »

Régler

set_length_unit

Choisis si les mensurations s'affichent et se saisissent en centimètres ou en pouces. Ce réglage est distinct de ton unité de poids. Les valeurs enregistrées ne changent pas : seuls l'affichage et l'unité retenue par défaut à la saisie changent.

Dis par exemple « Passe mes mensurations en pouces »

Objectifs et progression

Fixe tes objectifs et vois où tu en es chaque jour.

Régler

set_nutrition_goals

Fixe tes objectifs quotidiens de calories, macros, fibres, sucres, sucres ajoutés, alcool, caféine et eau, plus un poids cible facultatif. Les calories, les protéines, les glucides, les lipides, les fibres et l'eau sont des cibles à atteindre ; les sucres totaux, les sucres ajoutés, l'alcool et la caféine sont des limites à ne pas dépasser, et la progression est formulée en conséquence. Seuls les champs que tu mentionnes sont mis à jour ; les autres restent inchangés.

Paramètres
  • daily_caloriesfacultatifObjectif calorique quotidien (kcal). Mettre à null pour supprimer cet objectif.
  • daily_protein_gfacultatifObjectif quotidien de protéines (grammes). Mettre à null pour supprimer cet objectif.
  • daily_carbs_gfacultatifObjectif quotidien de glucides (grammes). Mettre à null pour supprimer cet objectif.
  • daily_fat_gfacultatifObjectif quotidien de lipides (grammes). Mettre à null pour supprimer cet objectif.
  • daily_fiber_gfacultatifObjectif quotidien de fibres (grammes), un minimum à atteindre. Mettre à null pour supprimer cet objectif.
  • daily_sugar_gfacultatifLimite quotidienne de sucres totaux (grammes), un maximum à ne pas dépasser. Les sucres totaux incluent le sucre naturellement présent dans les fruits et le lait : les recommandations officielles sur les sucres ajoutés donnent donc un chiffre bien plus bas. Mettre à null pour supprimer cette limite.
  • daily_added_sugar_gfacultatifLimite quotidienne de sucres ajoutés (grammes), un maximum à ne pas dépasser. Ne compte que les sucres ajoutés, pas le sucre naturellement présent dans les fruits et le lait ; les chiffres des recommandations officielles sur le sucre portent généralement sur cette mesure (l'American Heart Association suggère au plus 25 g par jour pour les femmes et 36 g pour les hommes). 0 est une vraie limite qui signifie aucun. Mettre à null pour supprimer cette limite.
  • daily_alcohol_gfacultatifLimite quotidienne d'alcool en grammes d'éthanol pur, un maximum à ne pas dépasser. Un verre standard américain contient 14 g, une unité d'alcool britannique 7,9 g. Mettre à null pour supprimer cette limite.
  • daily_caffeine_mgfacultatifLimite quotidienne de caféine en milligrammes, un maximum à ne pas dépasser. L'EFSA et la FDA fixent le plafond à 400 mg par jour pour un adulte en bonne santé (environ quatre cafés filtre) ; pendant la grossesse, l'EFSA retient 200 mg. 0 est une vraie limite : aucune caféine du tout. Mettre à null pour supprimer cette limite.
  • daily_water_mlfacultatif
  • target_weightfacultatif

Dis par exemple « Fixe mes objectifs à 2 200 calories, 160 g de protéines et un poids cible de 75 kg »

Consulter

get_nutrition_goals

Affiche tes objectifs quotidiens actuels de calories et de macros, ton éventuel objectif de fibres, tes éventuelles limites de sucres ou de caféine et, si tu suis l'alcool, ta limite d'alcool.

Dis par exemple « Quels sont mes objectifs quotidiens ? »

ConsulterWidget interactif

get_goal_progress

Compare ce que tu as consommé aujourd'hui à tes objectifs : anneaux consommé/objectif et progression de ton poids. Touche l'anneau d'une macro pour voir quels repas y ont contribué.

Dis par exemple « Où j'en suis par rapport à mes objectifs aujourd'hui ? »

ConsulterWidget interactif

get_nutrition_summary

Affiche tes totaux nutritionnels quotidiens sur une période, sous forme de tableau de bord interactif : tuiles de macros comparées aux objectifs et détail jour par jour. Un appel couvre jusqu'à 92 jours ; pour des périodes plus longues, les tendances donnent des moyennes glissantes.

Paramètres
  • start_daterequisDate de début (AAAA-MM-JJ)
  • end_daterequisDate de fin (AAAA-MM-JJ), 92 jours maximum, jour de début compris

Dis par exemple « Fais-moi un résumé de la semaine écoulée »

Réglages et compte

Des préférences pour que tout reste exact, et le contrôle total de tes données.

Consulter

get_profile

Affiche tous tes réglages actuels d'un coup : fuseau horaire (avec la date et l'heure locales), langue des widgets, unités de poids et de longueur préférées, si les widgets s'affichent dans le chat et si le suivi de l'alcool est activé.

Dis par exemple « Quels sont mes réglages actuels ? »

Régler

set_timezone

Définis ton fuseau horaire IANA pour que tes journées basculent à minuit, heure locale : un repas enregistré à 23 h compte pour ce jour-là, pas pour le lendemain en UTC.

Dis par exemple « Je suis à Berlin, règle mon fuseau horaire »

Régler

set_language

Choisis la langue de l'interface des widgets interactifs dans le chat (tableaux de bord et graphiques), pas celle dans laquelle l'IA te répond.

Paramètres
  • localerequisCode ISO 639-1, par exemple de, ja. Langues prises en charge : anglais, allemand, espagnol, français, néerlandais, polonais, italien, ukrainien, japonais.

Dis par exemple « Affiche mes widgets en allemand »

Consulter

get_current_time

Donne la date et l'heure actuelles dans ton fuseau horaire, ainsi que l'instant UTC. Certaines apps n'indiquent pas l'heure à l'assistant : c'est ainsi qu'il sait ce que veulent dire « ce matin » ou « aujourd'hui » sans avoir à te le demander (UTC par défaut si aucun fuseau horaire n'est défini).

Dis par exemple « Quelle heure est-il chez moi en ce moment ? »

Régler

set_widget_display

Active ou désactive les widgets visuels dans le chat : tableaux de bord, anneaux d'objectifs et graphiques de tendances. Quand ils sont désactivés, les mêmes outils répondent uniquement avec du texte et des données. Activés par défaut ; le changement s'applique aux nouvelles conversations.

Paramètres
  • enabledrequistrue pour afficher les widgets, false pour des réponses en texte seul

Dis par exemple « Désactive les widgets »

Régler

set_alcohol_tracking

Active ou désactive le suivi de l'alcool, et choisis si les boissons sont comptées en verres standards américains ou en unités d'alcool britanniques. Il est désactivé par défaut : il faut donc le demander. Le désactiver à nouveau masque l'alcool dans les repas, les objectifs et la progression, et empêche l'outil d'import de lire la colonne alcool d'un fichier. Rien de ce qui est déjà enregistré n'est supprimé, ton export CSV l'inclut toujours, et il réapparaît si tu réactives le suivi. Le changement s'applique dès ton prochain message, sans rien redémarrer.

Paramètres
  • enabledrequistrue pour afficher l'alcool dans les repas, les objectifs et la progression, false pour le masquer
  • drink_unitfacultatifLe verre standard à afficher à côté des grammes : us (14 g par verre) ou uk (7,9 g par unité). us par défaut ; ce qui est réellement enregistré, ce sont des grammes d'éthanol pur.

Dis par exemple « Commence à suivre ma consommation d'alcool, en unités britanniques »

Supprimer

delete_account

Supprime définitivement ton compte Nutrition MCP et toutes les données qu'il conserve sur toi. C'est irréversible : l'outil ne fait rien sans confirmation explicite, et l'IA a pour consigne de vérifier avec toi avant d'envoyer la confirmation.

Dis par exemple « Supprime mon compte et toutes mes données »

Dépannage

Quelque chose ne fonctionne pas ? La plupart des problèmes se règlent vite.

Le problème persiste ? anton@nutrition-mcp.com

01Le connecteur ne se connecte pas, ou me demande sans cesse de me connecter

Supprime le connecteur et ajoute-le à nouveau avec exactement https://nutrition-mcp.com/mcp : la partie /mcp est indispensable. Dans Claude, ouvre Personnaliser → Connecteurs, déconnecte Nutrition puis reconnecte-le ; dans ChatGPT, passe par Paramètres → Applications. Connecte-toi avec la même adresse e-mail et le même mot de passe, ou le même compte Google, qu'auparavant : tes données appartiennent à ton compte, pas à la connexion, donc te reconnecter ne te fait rien perdre. Une fois connecté, le connecteur le reste tant que tu t'en sers au moins une fois tous les 90 jours ; s'il cesse de fonctionner, il suffit de le reconnecter de la même façon.

02La page de connexion affiche {"error":"session_expired"}

La page de connexion n'est valable que 10 minutes, et elle est aussi réinitialisée chaque fois que le serveur redémarre pour une mise à jour. Retourne sur la page de connexion et recharge-la, ou relance la connexion depuis ton app d'IA, puis connecte-toi sans trop tarder. Si elle affiche plutôt session_mismatch, la connexion a été finalisée dans un autre navigateur que celui qui l'a ouverte : recommence depuis ton app d'IA et va jusqu'au bout dans ce même navigateur.

03Je n'arrive pas à me connecter, ou j'ai oublié mon mot de passe

Utilise Se connecter pour un compte que tu as déjà : avec un e-mail ou un mot de passe incorrect, ce bouton affiche « E-mail ou mot de passe incorrect » et ne crée jamais de nouveau compte. Créer un compte ne sert que lors de ta première visite. Vérifie que l'adresse e-mail ne contient pas de faute de frappe. Si tu as créé ton compte avec Continuer avec Google, utilise de nouveau ce bouton. La réinitialisation du mot de passe en libre-service n'existe pas encore : écris à anton@nutrition-mcp.com depuis l'adresse de ton compte et je réinitialiserai ton mot de passe.

04Après une reconnexion, mon historique a disparu

Chaque adresse e-mail correspond à un compte distinct : te connecter avec une autre adresse ouvre donc un compte vide, mais rien n'a été supprimé. Déconnecte le connecteur et reconnecte-toi avec l'adresse que tu utilisais au départ. Si tu ne sais plus laquelle c'était, écris à anton@nutrition-mcp.com.

05L'IA répond mais n'enregistre rien

Vérifie que le connecteur est activé pour cette conversation (dans Claude, regarde le menu des outils dans la zone de saisie) et demande-le explicitement, par exemple « enregistre mon petit-déjeuner dans Nutrition ». Si ton app te demande l'autorisation d'utiliser un outil, accepte.

06Mes repas apparaissent au mauvais jour

Les journées sont comptées dans ton fuseau horaire ; si tu n'en as jamais défini, c'est l'UTC qui s'applique. Demande « quel fuseau horaire est configuré ? » (get_profile) et, s'il est faux, « règle mon fuseau horaire sur Europe/Berlin » (set_timezone). Tout ce que tu as enregistré est alors regroupé selon ta journée locale, y compris les entrées passées. Seule exception : une entrée pour laquelle tu as indiqué une heure précise alors que le fuseau était faux garde l'instant auquel elle a été enregistrée, et peut donc rester décalée d'une heure ou d'un jour. Demande à l'IA de la déplacer à la bonne date et à la bonne heure (update_meal). Définis aussi ton fuseau horaire avant d'importer ton historique : les repas importés gardent l'instant auquel ils ont été placés, et réimporter le fichier d'une autre app après avoir changé de fuseau les ajoute une seconde fois. Un export Nutrition MCP, lui, est reconnu et n'est pas dupliqué.

07Je ne vois que du texte, ni graphiques ni cartes

Les cartes visuelles nécessitent une app compatible avec les panneaux interactifs MCP Apps, comme Claude ou ChatGPT ; les autres clients reçoivent les mêmes informations sous forme de texte. Si tu as désactivé les widgets, demande à les réactiver (set_widget_display) et ouvre une nouvelle conversation : une conversation déjà ouverte garde l'ancien réglage jusqu'à sa reconnexion. La petite carte qui s'affiche après l'enregistrement d'un repas n'apparaît que si tu as défini des objectifs quotidiens (set_nutrition_goals).

08L'outil d'import ne s'ouvre pas, ou indique qu'il ne peut pas enregistrer

Le panneau d'import nécessite une app qui affiche les panneaux interactifs, avec les widgets activés. S'il affiche Cet hôte ne permet pas à cette vue d'écrire dans ton journal, ou s'il n'apparaît pas du tout, demande à l'IA d'importer le fichier elle-même : joins ou colle le CSV et elle utilisera bulk_import_meals, qui vérifie chaque ligne et ignore les doublons ; tu peux donc le renvoyer sans risque, tant que ton fuseau horaire n'a pas changé entre-temps. Définis ton fuseau horaire avant le premier import : réimporter le fichier d'une autre app après un changement de fuseau ajoute de nouveau les lignes. Si tu utilises le panneau d'import et veux conserver une colonne d'alcool, active d'abord le suivi de l'alcool : le panneau ignore cette colonne tant que le suivi est désactivé, et un nouvel import plus tard ne la complétera pas.

09Je vois « Rate limit exceeded » ou « Too many failed authentication attempts »

Chaque compte peut envoyer 60 requêtes par minute, et chaque appel d'outil en compte au moins une. Attends le nombre de secondes indiqué dans le message, puis continue. Pour rattraper beaucoup de repas passés, utilise l'outil d'import plutôt que de les enregistrer un par un. Les pages de connexion acceptent 30 requêtes par minute et par réseau. Après 20 tentatives de connexion refusées d'affilée depuis un même réseau (en général, un ancien connecteur déconnecté qui réessaie encore), les connexions depuis ce réseau sont suspendues pendant 5 minutes, et les suspensions suivantes s'allongent, jusqu'à une heure au maximum. Supprimer l'ancien connecteur puis l'ajouter à nouveau met fin à ces tentatives.

10Un code-barres est introuvable, ou ses valeurs semblent fausses

Les données des codes-barres viennent d'Open Food Facts, une base de données collaborative : certains produits y manquent et certaines fiches ne sont plus à jour. Vérifie que les 8 à 14 chiffres sous le code-barres ont tous été lus correctement. Si le produit n'y figure pas, l'IA peut faire une estimation à partir de son nom ou d'une photo de l'étiquette nutritionnelle, et tu peux corriger n'importe quelle valeur ensuite. Ajouter le produit sur openfoodfacts.org aide tout le monde. Open Food Facts ne fournit pas de données sur la caféine : elle provient donc de l'étiquette ou de quantités typiques.

11Hier n'apparaît pas encore dans Apple Health

La synchronisation avec Apple Health n'envoie que les journées terminées. Une journée est terminée à 05:00 le lendemain matin dans ton fuseau horaire : hier arrive donc avec la première synchronisation après 05:00 aujourd'hui, et aujourd'hui n'apparaît dans Santé que demain. Une synchronisation se lance quand l'une des automatisations du raccourci se déclenche (ouvrir l'app Santé, arrêter ton alarme) ou quand tu exécutes Nutrition MCP Health dans l'app Raccourcis et choisis Sync now. Un matin manqué se rattrape tout seul : chaque synchronisation remonte sur les 7 derniers jours. Les journées suivent le fuseau horaire de ton profil (get_profile) ou, si tu n'en as jamais défini, celui que ton iPhone a indiqué à la connexion (repas au mauvais jour). Les jours antérieurs à la connexion ne sont envoyés que si tu as choisi, en te connectant, de récupérer jusqu'à 7 jours précédents.

12Apple Health affiche plus que mon chat

Apple Health peut ajouter à une valeur, mais jamais diminuer une valeur qu'il a déjà. Un repas que tu ajoutes à une journée déjà envoyée suit sous forme d'une petite entrée supplémentaire à 12:01, 12:02, etc., tant que la journée fait partie des 7 derniers jours. Si tu supprimes ou réduis un repas après l'envoi de sa journée, Santé reste plus haut et le raccourci affiche un avis indiquant l'écart. Pour corriger, ouvre l'app Santé, va dans Parcourir → Nutrition, ouvre le type concerné, touche Afficher toutes les données, supprime les entrées de ce jour provenant de Raccourcis et saisis le bon total à la main. N'utilise jamais Supprimer toutes les données de « Raccourcis » : cela efface aussi ce que tes autres raccourcis ont enregistré. Si chaque journée semble doublée, une autre app écrit les mêmes types et Santé additionne les deux : désactive l'une d'elles dans Partage → Apps de l'app Santé.

13La synchronisation avec Apple Health s'est arrêtée

Ouvre l'app Raccourcis et exécute Nutrition MCP Health à la main : il te dit ce qui n'a pas marché. S'il te demande de te reconnecter, la connexion a pris fin (après 90 jours sans synchronisation, 365 jours après la connexion ou après Disconnect) : exécute-le, connecte-toi sur la page qu'il ouvre avec le même compte que dans ton app d'IA, et termine en moins de 30 minutes. S'il synchronise quand tu l'exécutes mais pas tout seul, vérifie que ses automatisations dans l'onglet Automatisation de Raccourcis sont activées et réglées sur Exécuter immédiatement. Si un avis indique qu'une journée n'a pas atteint Apple Health, autorise Raccourcis à écrire chaque type de nutrition dans Partage → Apps → Raccourcis de l'app Santé, puis relance-le. Connecter un nouvel iPhone remplace la connexion de l'ancien.

15Comment supprimer mon compte ?

Demande à l'IA de supprimer ton compte Nutrition MCP (delete_account). Elle te demandera confirmation, puis supprimera définitivement tes repas, tes entrées d'eau, de poids et de mensurations, tes objectifs, tes réglages, l'historique des outils utilisés par ton app d'IA, tout fichier d'export, tes identifiants de connexion et le compte lui-même. C'est irréversible : exporte d'abord tes données si tu veux en garder une copie. Retire ensuite le connecteur de ton app. Si tu te reconnectes plus tard avec la même adresse e-mail, un nouveau compte vide sera créé.

16Comment signaler un bug ou un problème de sécurité ?

Signale les bugs sur GitHub Issues : précise quelle app tu utilises (Claude, ChatGPT, …), ce que tu as demandé, ce qui s'est passé et à peu près quand. N'indique jamais ton mot de passe. Merci de ne pas signaler publiquement les problèmes de sécurité : signale-les en privé via le formulaire de signalement de vulnérabilités de GitHub ou par e-mail, comme l'explique la politique de sécurité. Pour tout le reste, écris à anton@nutrition-mcp.com.