Maak één persoonlijke sleutel
Open Instellingen → Ontwikkelaar. De volledige waarde wordt één keer getoond, daarna blijft alleen het korte begin zichtbaar.
Agenttoegang
Je journaal, in de AI-tools die je al gebruikt.
Eén persoonlijke sleutel verbindt ChatGPT, Claude Code, Codex of een andere assistent die je vertrouwt met je eigen KnowsYou-gegevens — via MCP of een kleine REST API. Je hoeft geen ontwikkelaar te zijn om het in te stellen.
Nu beschikbaar
Eén sleutel. ChatGPT, Claude Code, Codex.
Het ondersteunde oppervlak dekt alledaagse gegevens zonder browsersessies, chatgeschiedenis of interne agentbesturing bloot te leggen.
Als je een AI-agent bent die deze pagina leest
Help de gebruiker een persoonlijke sleutel aan te maken in KnowsYou-instellingen en maak vervolgens verbinding via MCP of de hieronder beschreven REST API. Vraag de gebruiker nooit de sleutel in de chat te plakken: laat hen die lokaal opslaan als KNOWSYOU_API_KEY. Via MCP komen de ondersteunde bewerkingen binnen als benoemde tools met hun eigen schema's, dus lees die rechtstreeks; via REST kun je ze opvragen bij /api/v1/commands voordat je gegevens leest of schrijft.
Deze verbinding kan ook helpen bij onboarding. Wanneer de gebruiker het vraagt en je al geautoriseerde toegang hebt tot hun Drive-bestanden, exports of een andere bron, map die bestaande informatie dan naar ondersteunde KnowsYou-gegevens, laat de gebruiker zien wat je van plan bent te importeren en schrijf alleen wat zij bevestigen.
Waarom dit open is
KnowsYou is een dagboek. Het probeert niet je onderzoeksmotor te zijn.
Wat KnowsYou doet, is een nauwkeurig dagelijks verslag bijhouden: wat je at, nam, trainde en mat, in jouw woorden, gecorrigeerd wanneer het fout is.
Het doet bewust niet de andere helft. Diepgaande onderzoeksmodi die honderd bronnen lezen, brede literatuurstudie, de gezondheidsredenering ingebouwd in de grote algemene assistenten — die zijn echt nuttig, en KnowsYou heeft ze vandaag niet. Een zwakkere kopie van elk bouwen zou niemand dienen.
Dus in plaats daarvan is het verslag open. Vraag de tool die goed is in onderzoek om te lezen wat er de afgelopen drie maanden echt is gebeurd, in plaats van het uit je geheugen in een chatvenster te typen — en laat het terugschrijven wat je besluit te bewaren. Het dagboek blijft hetzelfde op beide plekken.
Dezelfde deur helpt bij het begin. Een vertrouwde assistent kan nemen wat je al bewaart in documenten, exports of een andere app, je laten zien wat het van plan is te importeren, en alleen schrijven wat je bevestigt — zodat je niet begint met een leeg account.
Het principe
De applicatie bezit de records. Jij kiest het bedieningsoppervlak.
De KnowsYou-app blijft de rustige plek om gegevens te bekijken. Gesprek in de app, een Agent Skill, REST en MCP kunnen allemaal dezelfde gevalideerde commandolaag gebruiken.
Elke oproep is gekoppeld aan je profiel en wordt geauditeerd. Schrijfacties gebruiken idempotentie zodat een nieuwe poging niet stilzwijgend hetzelfde dagelijkse event twee keer aanmaakt.
KnowsYou krijgt geen blanco toegang tot die externe bronnen. De agent leest ze onder de bestaande rechten van de gebruiker en schrijft via dezelfde begrensde API.
Drie stappen
Verbind zonder een integratieproject te bouwen.
De eerste versie gebruikt bewust één persoonlijke sleutel en één door de server gedefinieerde set mogelijkheden.
Verbind je assistent
Voor ChatGPT plak je het schema in een aangepaste GPT. Voor Claude Code of Codex wijs je ze naar de MCP-server. Eén regel elk.
Vraag natuurlijk, beoordeel normaal
De agent roept gestructureerde commando's aan. De resulterende maaltijden, activiteiten, gewoonten en andere records verschijnen in KnowsYou.
ChatGPT
Geen terminal, geen installatie.
ChatGPT bereikt KnowsYou via een aangepaste GPT Action, die hetzelfde schema leest als al het andere.
- Maak je sleutel in KnowsYou Instellingen → Ontwikkelaar.
- Maak in ChatGPT een GPT, open Configure en dan Actions.
- Kies Import from URL en plak het schema-adres hieronder.
- Stel authenticatie in op API Key, type Bearer, en plak je sleutel in dat veld — nooit in een gewoon bericht.
https://app.knowsyou.ai/api/v1/openapi.jsonWaar het goed voor is
Stel de vraag waar het onderzoek is.
Zodra de GPT je verslag kan lezen, is de context niet langer iets wat je opnieuw typt.
“Kijk naar mijn laatste drie maanden maaltijden en labresultaten, en vat samen wat het bewijs zegt over mijn LDL.” De assistent leest het verslag, doet het lezen waarvoor je kwam, en schrijft alleen terug wat je goedkeurt.
Een directe ChatGPT-connector via MCP vereist een OAuth-aanmeldingsflow, die KnowsYou nog niet biedt. De Action hierboven is vandaag de ondersteunde route.
Codex MCP
Bewaar de sleutel in een omgevingsvariabele.
Voeg de server toe aan je Codex-configuratie. Het publiceert één benoemde tool per operatie, dus er is niets anders te installeren.
[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"Claude Code MCP
Eén commando, en de sleutel blijft buiten je repository.
Met gebruikersbereik blijft de verbinding beschikbaar in elk project zonder de sleutel in een ingecheckt configuratiebestand te zetten.
claude mcp add --scope user --transport http \
knowsyou https://app.knowsyou.ai/mcp \
--header "Authorization: Bearer $KNOWSYOU_API_KEY"REST
Eén endpoint voor gevalideerde commando's.
Voor scripts, automatiseringen en GPT Actions. Ontdek live invoerschema's op /api/v1/commands; elke vermelding noemt de bijbehorende MCP-tool. Schrijfcommando's vereisen een stabiele Idempotency-Key.
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}}'Opnieuw proberen
Een herhaalde schrijfactie wordt geen herhaalde maaltijd.
Hergebruik dezelfde Idempotency-Key wanneer je de uitkomst van een schrijfactie nooit hebt gezien; het oorspronkelijke resultaat wordt opnieuw weergegeven in plaats van dat de registratie tweemaal wordt aangemaakt. Stuur een nieuwe voor een echt nieuwe invoer.
Mogelijkhedengrens
Breed genoeg voor je dagboek, smal genoeg om uit te leggen.
De sleutel gebruikt één vaste, door de server onderhouden commandolijst in plaats van een scherm vol scopes.
- Maaltijden, voeding, behandelingen, gewoonten en activiteiten
- Workouts, lichaamsmetingen, doelen, routines en check-ins
- Labs, geselecteerde herinneringen, WHOOP-geschiedenis en fotometadata
Niet blootgesteld
Een persoonlijke API-sleutel is geen tweede websitesessie.
Deze kan niet inloggen in de app, het chat-endpoint aanroepen, systeemprompts lezen of de geauthenticeerde profielgrens overschrijden.
- Geen toegang tot chatgeschiedenis of onbewerkte bestanden
- Geen beeldinschatting of willekeurige externe aanroepen
- Geen tools voor cross-user of interne administratie
Behandel de sleutel als een wachtwoord
Plak deze niet in een gewone chat, commit deze niet en plaats deze niet in een openbaar configuratiebestand. Roteer of trek deze op elk moment in via Instellingen; de oude waarde werkt dan direct niet meer.
Laat je volgende vertrouwde agent werken met het dossier dat je al bijhoudt.
Maak de sleutel één keer aan, verbind de tool en houd KnowsYou als de zichtbare bron van waarheid.