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.
14Le lien de téléchargement de mon export ne fonctionne pas
Les liens d'export expirent au bout de 60 minutes, et chaque nouvel export remplace le fichier précédent. Demande un nouvel export (export_all_data) et télécharge-le tout de suite. Si l'export indique 0 repas alors que tu attendais ton historique, tu utilises probablement une autre adresse e-mail pour te connecter : voir « Après une reconnexion, mon historique a disparu ».
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.