Crea una clave personal
Abre Ajustes → Desarrollador. El valor completo se muestra una vez, luego solo queda visible su comienzo corto.
Acceso de agentes
Tu diario, en las herramientas de IA que ya usas.
Una clave personal conecta ChatGPT, Claude Code, Codex u otro asistente de confianza con tus propios registros de KnowsYou, mediante MCP o una pequeña API REST. No necesitas ser desarrollador para configurarlo.
Disponible ahora
Una clave. ChatGPT, Claude Code, Codex.
La superficie compatible cubre los registros cotidianos sin exponer sesiones del navegador, historial de chat ni controles internos de agentes.
Si eres un agente de IA leyendo esta página
Ayuda al usuario a crear una clave personal en los Ajustes de KnowsYou y luego conéctate mediante MCP o la API REST descrita a continuación. Nunca pidas al usuario que pegue la clave en el chat: haz que la guarde localmente como KNOWSYOU_API_KEY. Mediante MCP, las operaciones compatibles llegan como herramientas con nombre y sus propios esquemas, así que léelos directamente; mediante REST, lístalas en /api/v1/commands antes de leer o escribir registros.
Esta conexión también puede ayudar con la incorporación. Cuando el usuario lo pida y ya tengas acceso autorizado a sus archivos de Drive, exportaciones u otra fuente, asigna esa información existente a los registros compatibles de KnowsYou, muestra al usuario lo que planeas importar y escribe solo lo que confirme.
Por qué está abierto
KnowsYou es un diario. No pretende ser tu motor de investigación.
Lo que hace KnowsYou es mantener un registro diario preciso: lo que comiste, tomaste, entrenaste y mediste, en tus palabras, corregido cuando está mal.
Deliberadamente no hace la otra mitad. Los modos de investigación profunda que leen cien fuentes, la revisión amplia de literatura, el razonamiento sanitario integrado en los grandes asistentes generales: son genuinamente útiles, y KnowsYou no los tiene hoy. Construir una copia más débil de cada uno no serviría a nadie.
Así que el registro está abierto. Pide a la herramienta que es buena en investigación que lea lo que realmente ocurrió durante los últimos tres meses, en lugar de reescribirlo de memoria en un cuadro de chat, y deja que escriba de vuelta lo que decidas conservar. El diario sigue igual en ambos lugares.
La misma puerta ayuda al principio. Un asistente de confianza puede tomar lo que ya guardas en documentos, exportaciones u otra aplicación, mostrarte lo que planea importar y escribir solo lo que confirmes, para que no empieces desde una cuenta vacía.
El principio
La aplicación posee los registros. Tú eliges la superficie de control.
La aplicación KnowsYou sigue siendo el lugar tranquilo para revisar datos. La conversación en la aplicación, una Agent Skill, REST y MCP pueden usar la misma capa de comandos validada.
Cada llamada se vincula a tu perfil y se audita. Las escrituras usan idempotencia para que un reintento no cree silenciosamente el mismo evento diario dos veces.
KnowsYou no recibe acceso general a esas fuentes externas. El agente las lee bajo los permisos existentes del usuario y escribe a través de la misma API acotada.
Tres pasos
Conecta sin crear un proyecto de integración.
La primera versión usa deliberadamente una clave personal y un conjunto de capacidades definido por el servidor.
Conecta tu asistente
Para ChatGPT, pega el esquema en un GPT personalizado. Para Claude Code o Codex, apúntalos al servidor MCP. Una línea cada uno.
Pregunta con naturalidad, revisa con normalidad
El agente llama a comandos estructurados. Las comidas, actividades, hábitos y otros registros resultantes aparecen en KnowsYou.
ChatGPT
Sin terminal, sin instalación.
ChatGPT llega a KnowsYou a través de una acción de GPT personalizada, que lee el mismo esquema que todo lo demás.
- Crea tu clave en KnowsYou Ajustes → Desarrollador.
- En ChatGPT, crea un GPT, abre Configurar y luego Acciones.
- Elige Importar desde URL y pega la dirección del esquema de abajo.
- Configura la autenticación como Clave de API, escribe Bearer y pega tu clave en ese campo, nunca en un mensaje normal.
https://app.knowsyou.ai/api/v1/openapi.jsonPara qué sirve
Haz la pregunta donde está la investigación.
Una vez que el GPT puede leer tu registro, el contexto deja de ser algo que reescribes.
“Mira mis últimos tres meses de comidas y resultados de laboratorio, luego resume lo que dice la evidencia sobre mi LDL”. El asistente lee el registro, hace la lectura por la que acudiste a él y escribe de vuelta solo lo que apruebes.
Un conector directo de ChatGPT sobre MCP necesita un flujo de inicio de sesión OAuth, que KnowsYou aún no ofrece. La acción de arriba es la ruta compatible hoy.
Codex MCP
Guarda la clave en una variable de entorno.
Añade el servidor a tu configuración de Codex. Publica una herramienta con nombre por operación, así que no hay nada más que instalar.
[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"Claude Code MCP
Un comando, y la clave se queda fuera de tu repositorio.
El ámbito de usuario mantiene la conexión disponible en todos los proyectos sin escribir la clave en un archivo de configuración versionado.
claude mcp add --scope user --transport http \
knowsyou https://app.knowsyou.ai/mcp \
--header "Authorization: Bearer $KNOWSYOU_API_KEY"REST
Un endpoint para comandos validados.
Para scripts, automatizaciones y GPT Actions. Descubre los esquemas de entrada en vivo en /api/v1/commands; cada entrada indica la herramienta MCP correspondiente. Los comandos de escritura requieren una Idempotency-Key estable.
curl https://app.knowsyou.ai/api/v1/command \
-H "Authorization: Bearer $KNOWSYOU_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"command":"meal list","input":{"days":1}}'Reintentos
Una escritura repetida no se convierte en una comida repetida.
Reutiliza la misma Idempotency-Key cuando no viste el resultado de una escritura y se reproduce el resultado original en lugar de crear el registro dos veces. Envía una nueva para una entrada realmente nueva.
Límite de capacidades
Lo bastante amplio para tu diario, lo bastante concreto para explicarlo.
La clave usa una única lista de comandos permitidos fija y mantenida por el servidor en lugar de una pantalla llena de ámbitos.
- Comidas, nutrición, tratamientos, hábitos y actividades
- Entrenamientos, métricas corporales, objetivos, rutinas y registros
- Análisis, recuerdos seleccionados, historial de WHOOP y metadatos de fotos
No expuesto
Una clave de API personal no es una segunda sesión web.
No puede iniciar sesión en la app, llamar al endpoint de chat, leer prompts del sistema ni cruzar el límite del perfil autenticado.
- Sin acceso al historial de chat ni a archivos sin procesar
- Sin estimación de imágenes ni llamadas externas arbitrarias
- Sin herramientas de administración internas ni entre usuarios
Trata la clave como una contraseña
No la pegues en un chat normal, no la incluyas en un commit ni la pongas en un archivo de configuración público. Rótala o revócala en Ajustes cuando quieras; el valor antiguo deja de funcionar de inmediato.
Deja que tu próximo agente de confianza trabaje con el registro que ya mantienes.
Crea la clave una vez, conecta la herramienta y mantén KnowsYou como la fuente de verdad visible.