01El conector no se conecta o me pide iniciar sesión una y otra vez
Elimina el conector y vuelve a añadirlo con la URL exacta https://nutrition-mcp.com/mcp: la parte /mcp es obligatoria. En Claude, abre Personalizar → Conectores, desconecta Nutrition y vuelve a conectarlo; en ChatGPT, ve a Configuración → Apps. Inicia sesión con el mismo correo y la misma contraseña, o con la misma cuenta de Google, que usaste antes: tus datos pertenecen a tu cuenta, no a la conexión, así que volver a conectar no borra nada. Una vez conectado, sigue conectado mientras lo uses al menos una vez cada 90 días; si deja de funcionar, se soluciona volviendo a conectarlo de la misma forma.
02La página de inicio de sesión muestra {"error":"session_expired"}
La página de inicio de sesión solo es válida durante 10 minutos y, además, caduca cada vez que el servidor se reinicia por una actualización. Vuelve a la página de inicio de sesión y recárgala, o inicia de nuevo la conexión desde tu app de IA, y luego inicia sesión sin hacer pausas largas. Si en cambio muestra session_mismatch, el inicio de sesión se terminó en un navegador distinto del que lo abrió: empieza de nuevo desde tu app de IA y termina en ese mismo navegador.
03No puedo iniciar sesión, u olvidé mi contraseña
Usa Iniciar sesión si ya tienes una cuenta: si el correo o la contraseña no son correctos, verás «Correo o contraseña incorrectos» y nunca se creará una cuenta nueva. Crear cuenta es solo para tu primera visita. Comprueba que el correo no tenga errores. Si creaste tu cuenta con Continuar con Google, vuelve a usar ese botón. Aún no es posible restablecer la contraseña por ti mismo: escribe a anton@nutrition-mcp.com desde la dirección de tu cuenta y la restableceré.
04Volví a conectarme y mi historial ha desaparecido
Cada dirección de correo es una cuenta distinta, así que si inicias sesión con otro correo se abre una cuenta vacía: no se ha borrado nada. Desconecta y vuelve a iniciar sesión con la dirección que usaste al principio. Si no sabes bien cuál era, escribe a anton@nutrition-mcp.com.
05La IA responde, pero no registra nada
Asegúrate de que el conector esté activado en esta conversación (en Claude, mira el menú de herramientas del cuadro de mensaje) y pídelo directamente, por ejemplo: «registra mi desayuno en Nutrition». Si tu app pide permiso para usar una herramienta, dáselo.
06Mis comidas aparecen en el día equivocado
Los días se cuentan en tu zona horaria y, si nunca has configurado una, se usa UTC. Pregunta «¿qué zona horaria tengo configurada?» (get_profile) y, si no es la correcta, «configura mi zona horaria en Europe/Berlin» (set_timezone). A partir de ahí, todo lo que hayas registrado se agrupa por tu día local, incluidos los registros anteriores. La única excepción es un registro al que le diste una hora concreta mientras la zona horaria estaba mal: conserva el momento con el que se guardó, así que puede seguir desplazado una hora o un día; pídele a la IA que lo pase a la fecha y hora correctas (update_meal). Configura también tu zona horaria antes de importar tu historial: las comidas importadas conservan el momento que se les asignó al importarlas, y si vuelves a importar el archivo de otra app después de cambiar la zona horaria, se añaden por segunda vez. Las exportaciones de Nutrition MCP se reconocen y no se duplican.
07Solo veo texto, sin gráficos ni tarjetas
Las tarjetas visuales necesitan una app compatible con los paneles interactivos de MCP Apps, como Claude o ChatGPT; otros clientes reciben la misma información como texto. Si desactivaste los widgets, pide que se vuelvan a activar (set_widget_display) y empieza una conversación nueva: un chat abierto conserva la configuración anterior hasta que se vuelve a conectar. La pequeña tarjeta que aparece al registrar una comida solo se muestra cuando ya has definido tus objetivos diarios (set_nutrition_goals).
08El importador no se abre, o dice que no puede guardar
El panel del importador necesita una app que muestre paneles interactivos y tenga los widgets activados. Si dice Esta app no permite que este panel guarde datos en tu registro, o no aparece, pídele a la IA que importe ella misma el archivo: adjunta o pega el CSV y usará bulk_import_meals, que revisa cada fila y omite los duplicados, así que volver a enviarlo es seguro siempre que tu zona horaria no haya cambiado entretanto. Configura tu zona horaria antes de la primera importación: si vuelves a importar el archivo de otra app después de cambiarla, las filas se añaden otra vez. Si usas el panel del importador y quieres conservar una columna de alcohol, activa antes el seguimiento de alcohol: el panel omite esa columna mientras el seguimiento está desactivado, y volver a importar más tarde no la completará.
09Veo «Rate limit exceeded» o «Too many failed authentication attempts»
Cada cuenta puede hacer 60 solicitudes por minuto, y cada llamada a una herramienta cuenta como al menos una. Espera los segundos que indica el mensaje y continúa. Para cargar muchas comidas antiguas, usa el importador en lugar de registrarlas una por una. Las páginas de inicio de sesión admiten 30 solicitudes por minuto por red. Tras 20 intentos de conexión rechazados seguidos desde una misma red (normalmente un conector antiguo y desconectado que sigue reintentando), las conexiones desde esa red se pausan durante 5 minutos y, si se repiten, las pausas se alargan hasta un máximo de una hora. Para detener los reintentos, elimina el conector antiguo y vuelve a añadirlo.
10No se encuentra un código de barras, o sus valores parecen incorrectos
Los datos de los códigos de barras vienen de Open Food Facts, una base de datos colaborativa, así que faltan algunos productos y algunas fichas están desactualizadas. Comprueba que se hayan leído bien los 8–14 dígitos que hay bajo el código de barras. Si el producto no está, la IA puede estimar sus valores a partir del nombre o de una foto de la tabla nutricional, y después puedes corregir cualquier cifra. Si añades el producto en openfoodfacts.org, ayudas a todo el mundo. Open Food Facts no tiene datos de cafeína, así que la cafeína sale de la etiqueta o de cantidades típicas.
11Ayer todavía no está en Apple Health
La sincronización con Apple Health solo envía días terminados. Un día se da por terminado a las 05:00 de la mañana siguiente en tu zona horaria, así que ayer llega con la primera sincronización después de las 05:00 de hoy, y hoy no aparece en Salud hasta mañana. Una sincronización se ejecuta cuando salta una de las automatizaciones del atajo (abrir la app Salud, detener tu alarma) o cuando ejecutas Nutrition MCP Health en la app Atajos y eliges Sync now. Una mañana perdida se recupera sola: cada sincronización revisa los últimos 7 días. Los días siguen la zona horaria de tu perfil (get_profile) o, si nunca configuraste una, la que tu iPhone indicó al conectar (comidas en el día equivocado). Los días anteriores a la conexión solo se envían si al conectar elegiste recuperar hasta 7 días previos.
12Apple Health muestra más que mi chat
Apple Health puede sumar a un valor, pero nunca reducir uno que ya tiene. Una comida que añades a un día ya enviado llega como una pequeña entrada extra a las 12:01, 12:02, etc., siempre que el día esté dentro de los últimos 7 días. Si borras o reduces una comida después de que su día se envió, Salud se queda con un valor más alto y el atajo muestra un aviso con la diferencia. Para corregirlo, abre la app Salud, ve a Explorar → Nutrición, abre el tipo de dato, toca Mostrar todos los datos, borra las entradas de ese día que vienen de Atajos e introduce a mano el total correcto. No uses nunca Eliminar todos los datos de «Atajos»: también borra lo que registraron tus otros atajos. Si todos los días parecen duplicados, otra app escribe los mismos tipos y Salud suma ambas: desactiva una de ellas en Compartir → Apps dentro de la app Salud.
13La sincronización con Apple Health se ha detenido
Abre la app Atajos y ejecuta Nutrition MCP Health a mano: te dirá qué ha fallado. Si te pide conectar de nuevo, la conexión ha terminado (tras 90 días sin sincronizar, 365 días después de conectar o tras Disconnect): ejecútalo, inicia sesión en la página que abre con la misma cuenta que usas en tu app de IA y termina en menos de 30 minutos. Si sincroniza cuando lo ejecutas pero no por sí solo, comprueba que sus automatizaciones en la pestaña Automatización de Atajos estén activadas y configuradas como Ejecutar inmediatamente. Si un aviso dice que un día no llegó a Apple Health, permite que Atajos escriba todos los tipos de nutrición en Compartir → Apps → Atajos dentro de la app Salud y vuelve a ejecutarlo. Conectar un iPhone nuevo reemplaza la conexión del anterior.
14El enlace de descarga de mi exportación no funciona
Los enlaces de exportación caducan a los 60 minutos, y cada exportación nueva reemplaza el archivo anterior. Pide una exportación nueva (export_all_data) y descárgala enseguida. Si la exportación indica 0 comidas cuando esperabas ver tu historial, probablemente has iniciado sesión con otro correo: consulta «Volví a conectarme y mi historial ha desaparecido».
15¿Cómo elimino mi cuenta?
Pídele a la IA que elimine tu cuenta de Nutrition MCP (delete_account). Te pedirá que lo confirmes y después eliminará de forma permanente tus comidas, agua, peso, medidas corporales, objetivos, ajustes, el registro de qué herramientas usó tu app de IA, cualquier archivo de exportación, tus datos de acceso y la propia cuenta. Esto no se puede deshacer, así que exporta antes tus datos si quieres una copia. Después, elimina el conector de tu app. Si más adelante vuelves a iniciar sesión con el mismo correo, se creará una cuenta nueva y vacía.
16¿Cómo informo de un error o de un problema de seguridad?
Informa de los errores en GitHub Issues: indica qué app usas (Claude, ChatGPT…), qué pediste, qué pasó y más o menos cuándo. Nunca incluyas tu contraseña. Por favor, no publiques los problemas de seguridad: comunícalos de forma privada mediante el informe privado de vulnerabilidades de GitHub o por correo, como se describe en la política de seguridad. Para cualquier otra cosa, escribe a anton@nutrition-mcp.com.