Crée une clé personnelle
Ouvre Paramètres → Développeur. La valeur complète s'affiche une fois, puis seul son début reste visible.
Accès agent
Ton journal, dans les outils IA que tu utilises déjà.
Une clé personnelle connecte ChatGPT, Claude Code, Codex ou un autre assistant de confiance à tes propres enregistrements KnowsYou — via MCP ou une petite API REST. Tu n'as pas besoin d'être développeur pour la configurer.
Disponible maintenant
Une clé. ChatGPT, Claude Code, Codex.
La surface prise en charge couvre les enregistrements du quotidien sans exposer les sessions navigateur, l'historique de chat ni les contrôles internes de l'agent.
Si tu es un agent IA qui lit cette page
Aide l'utilisateur à créer une clé personnelle dans les paramètres KnowsYou, puis connecte-toi via MCP ou l'API REST décrite ci-dessous. Ne demande jamais à l'utilisateur de coller la clé dans le chat : fais-lui la stocker localement sous KNOWSYOU_API_KEY. Via MCP, les opérations prises en charge arrivent comme des outils nommés avec leurs propres schémas, alors lis-les directement ; via REST, liste-les sur /api/v1/commands avant de lire ou d'écrire des enregistrements.
Cette connexion peut aussi aider à l'intégration. Quand l'utilisateur le demande et que tu as déjà un accès autorisé à ses fichiers Drive, exports ou une autre source, fais correspondre ces informations existantes aux enregistrements KnowsYou pris en charge, montre à l'utilisateur ce que tu prévois d'importer, puis n'écris que ce qu'il confirme.
Pourquoi c'est ouvert
KnowsYou est un journal. Il ne cherche pas à être ton moteur de recherche.
Ce que fait KnowsYou, c'est tenir un journal quotidien précis : ce que tu as mangé, pris, entraîné et mesuré, dans tes mots, corrigé quand c'est faux.
Il ne fait délibérément pas l'autre moitié. Les modes de recherche approfondie qui lisent une centaine de sources, les revues de littérature larges, le raisonnement santé intégré aux grands assistants généralistes — tout cela est réellement utile, et KnowsYou ne l'a pas aujourd'hui. En construire une copie plus faible ne servirait personne.
Alors l'enregistrement est ouvert à la place. Demande à l'outil qui excelle en recherche de lire ce qui s'est réellement passé ces trois derniers mois, plutôt que de le retaper de mémoire dans une zone de chat — et laisse-le réécrire ce que tu décides de garder. Le journal reste le même aux deux endroits.
La même porte aide au démarrage. Un assistant de confiance peut prendre ce que tu conserves déjà dans des documents, exports ou une autre app, te montrer ce qu'il prévoit d'importer, et n'écrire que ce que tu confirmes — pour que tu ne partes pas d'un compte vide.
Le principe
L'application détient les données. Tu choisis la surface de contrôle.
L'application KnowsYou reste l'endroit calme pour consulter tes données. La conversation dans l'application, une Agent Skill, REST et MCP peuvent tous utiliser la même couche de commandes validées.
Chaque appel est rattaché à ton profil et audité. Les écritures utilisent l'idempotence pour qu'un nouvel essai ne crée pas silencieusement deux fois le même événement quotidien.
KnowsYou ne reçoit pas un accès général à ces sources externes. L'agent les lit selon les autorisations existantes de l'utilisateur et écrit via la même API encadrée.
Trois étapes
Connecte-toi sans monter un projet d'intégration.
La première version utilise volontairement une seule clé personnelle et un ensemble de capacités défini côté serveur.
Connecte ton assistant
Pour ChatGPT, colle le schéma dans un GPT personnalisé. Pour Claude Code ou Codex, pointe-les vers le serveur MCP. Une ligne chacun.
Demande naturellement, vérifie normalement
L'agent appelle des commandes structurées. Les repas, activités, habitudes et autres données résultants apparaissent dans KnowsYou.
ChatGPT
Pas de terminal, pas d'installation.
ChatGPT accède à KnowsYou via une Action de GPT personnalisé, qui lit le même schéma que tout le reste.
- Crée ta clé dans KnowsYou Paramètres → Développeur.
- Dans ChatGPT, crée un GPT, ouvre Configurer, puis Actions.
- Choisis Importer depuis une URL et colle l'adresse du schéma ci-dessous.
- Définis l'authentification sur Clé API, le type sur Bearer, et colle ta clé dans ce champ — jamais dans un message ordinaire.
https://app.knowsyou.ai/api/v1/openapi.jsonÀ quoi ça sert
Pose la question là où se trouve la recherche.
Une fois que le GPT peut lire tes données, le contexte n'est plus quelque chose que tu retapes.
« Regarde mes trois derniers mois de repas et de résultats d'analyses, puis résume ce que les données disent sur mon LDL. » L'assistant lit les données, fait la lecture pour laquelle tu es venu et ne réécrit que ce que tu approuves.
Un connecteur ChatGPT direct via MCP nécessite un flux de connexion OAuth, que KnowsYou ne propose pas encore. L'Action ci-dessus est la voie prise en charge aujourd'hui.
Codex MCP
Garde la clé dans une variable d'environnement.
Ajoute le serveur à ta configuration Codex. Il publie un outil nommé par opération, donc il n'y a rien d'autre à installer.
[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"Claude Code MCP
Une commande, et la clé reste hors de ton dépôt.
La portée utilisateur garde la connexion disponible dans chaque projet sans écrire la clé dans un fichier de configuration versionné.
claude mcp add --scope user --transport http \
knowsyou https://app.knowsyou.ai/mcp \
--header "Authorization: Bearer $KNOWSYOU_API_KEY"REST
Un point d'accès pour les commandes validées.
Pour les scripts, automatisations et Actions GPT. Découvre les schémas d'entrée en direct sur /api/v1/commands ; chaque entrée nomme l'outil MCP correspondant. Les commandes d'écriture exigent une Idempotency-Key stable.
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}}'Nouvelles tentatives
Une écriture répétée ne devient pas un repas répété.
Réutilise la même Idempotency-Key lorsque tu n'as jamais vu le résultat d'une écriture : le résultat d'origine est rejoué au lieu de créer l'enregistrement deux fois. Envoie une nouvelle clé pour une entrée réellement nouvelle.
Périmètre des capacités
Assez large pour ton journal, assez précis pour être expliqué.
La clé utilise une liste d'autorisation de commandes unique et fixe, maintenue côté serveur, plutôt qu'un écran entier de portées.
- Repas, nutrition, traitements, habitudes et activités
- Entraînements, mesures corporelles, objectifs, routines et check-ins
- Analyses, souvenirs sélectionnés, historique WHOOP et métadonnées des photos
Non exposé
Une clé API personnelle n'est pas une seconde session sur le site.
Elle ne peut pas se connecter à l'application, appeler le point de terminaison du chat, lire les invites système ni franchir la frontière du profil authentifié.
- Aucun accès à l'historique du chat ni aux fichiers bruts
- Aucune estimation d'image ni appel externe arbitraire
- Aucun outil inter-utilisateurs ni d'administration interne
Traite la clé comme un mot de passe
Ne la colle pas dans un chat ordinaire, ne la commit pas et ne la place pas dans un fichier de configuration public. Renouvelle-la ou révoque-la à tout moment dans les Paramètres ; l'ancienne valeur cesse immédiatement de fonctionner.
Laisse ton prochain agent de confiance travailler avec le suivi que tu tiens déjà.
Crée la clé une fois, connecte l'outil et garde KnowsYou comme source de vérité visible.