Dostop agentov

Tvoj dnevnik v AI orodjih, ki jih že uporabljaš.

Ena osebna ključna koda poveže ChatGPT, Claude Code, Codex ali drugega pomočnika, ki mu zaupaš, s tvojimi zapisi KnowsYou — prek MCP ali majhnega REST API-ja. Za nastavitev ni treba biti razvijalec.

Ustvari ključ API Shema OpenAPI

Če si AI agent, ki bere to stran

Pomagaj uporabniku ustvariti osebni ključ v nastavitvah KnowsYou, nato se poveži prek MCP ali REST API, opisanega spodaj. Nikoli ne zahtevaj, da uporabnik prilepi ključ v klepet: naj ga shrani lokalno kot KNOWSYOU_API_KEY. Prek MCP podprte operacije prispejo kot imenovana orodja z lastnimi shemami, zato jih beri neposredno; prek REST jih naštej na /api/v1/commands, preden bereš ali pišeš zapise.

Ta povezava lahko pomaga tudi pri uvajanju. Ko uporabnik vpraša in že imaš pooblaščen dostop do njegovih datotek v Driveu, izvozov ali drugega vira, preslikaj te obstoječe informacije v podprte zapise KnowsYou, pokaži uporabniku, kaj nameravaš uvoziti, nato zapiši samo tisto, kar potrdi.

Zakaj je to odprto

KnowsYou je dnevnik. Ne poskuša biti tvoj raziskovalni motor.

KnowsYou skrbi za natančen dnevni zapis: kaj si jedel, vzel, treniral in izmeril, s tvojimi besedami, popravljeno, ko je napačno.

Namerno ne počne druge polovice. Načini poglobljenega raziskovanja, ki preberejo sto virov, širok pregled literature, zdravstveno sklepanje, vgrajeno v velike splošne asistente – ti so resnično uporabni in KnowsYou jih danes nima. Graditi šibkejšo kopijo vsakega ne bi koristilo nikomur.

Zato je zapis odprt. Prosi orodje, ki je dobro v raziskovanju, naj prebere, kaj se je dejansko zgodilo v zadnjih treh mesecih, namesto da bi to iz spomina prepisoval v klepet – in naj zapiše nazaj, kar se odločiš obdržati. Dnevnik ostane enak na obeh mestih.

Ista vrata pomagajo na začetku. Zaupanja vreden asistent lahko vzame, kar že hraniš v dokumentih, izvozih ali drugi aplikaciji, ti pokaže, kaj namerava uvoziti, in zapiše samo tisto, kar potrdiš – tako ne začneš s praznim računom.

Načelo

Aplikacija je lastnik zapisov. Ti izbereš nadzorno površino.

Aplikacija KnowsYou ostaja miren kraj za pregled podatkov. Pogovor v aplikaciji, Agent Skill, REST in MCP lahko vsi uporabljajo isti preverjeni sloj ukazov.

Vsak klic je povezan s tvojim profilom in revidiran. Pisanja uporabljajo idempotentnost, tako da ponovni poskus ne ustvari istega dnevnega dogodka dvakrat.

KnowsYou ne prejme splošnega dostopa do teh zunanjih virov. Agent jih bere v okviru tvojih obstoječih dovoljenj in piše prek istega omejenega API-ja.

Trije koraki

Poveži se brez projekta integracije.

Prva različica namerno uporablja en osebni ključ in en nabor zmožnosti, ki ga določi strežnik.

Ustvari en osebni ključ

Odpri Nastavitve → Razvijalec. Celotna vrednost je prikazana enkrat, nato ostane viden le njen kratki začetek.

Poveži svojega pomočnika

Za ChatGPT prilepi shemo v GPT po meri. Za Claude Code ali Codex ju usmeri na strežnik MCP. Ena vrstica za vsakega.

Vprašaj naravno, pregleduj običajno

Agent kliče strukturirane ukaze. Nastali obroki, dejavnosti, navade in drugi zapisi se prikažejo v KnowsYou.

ChatGPT

Brez terminala, brez namestitve.

ChatGPT doseže KnowsYou prek dejanja GPT po meri, ki bere isto shemo kot vse ostalo.

Ustvari svoj ključ v KnowsYou Nastavitve → Razvijalec.
V ChatGPT ustvari GPT, odpri Configure, nato Actions.
Izberi Import from URL in prilepi spodnji naslov sheme.
Nastavi preverjanje pristnosti na API Key, vnesi Bearer in prilepi svoj ključ v to polje — nikoli v običajno sporočilo.

https://app.knowsyou.ai/api/v1/openapi.json

Za kaj je uporabno

Vprašaj tam, kjer je raziskava.

Ko GPT lahko bere tvoj zapis, konteksta ni več treba znova vnašati.

»Poglej moje zadnje tri mesece obrokov in laboratorijskih izvidov ter povzemi, kaj dokazi pravijo o mojem LDL.« Pomočnik prebere zapis, opravi branje, po katerem si prišel, in napiše nazaj le tisto, kar odobriš.

Neposredni priključek ChatGPT prek MCP zahteva potek prijave OAuth, ki ga KnowsYou še ne ponuja. Zgornje dejanje je danes podprta pot.

Codex MCP

Ključ hrani v okoljski spremenljivki.

Dodaj strežnik v svojo konfiguracijo Codex. Objavlja eno poimenovano orodje na operacijo, zato ni treba namestiti ničesar drugega.

[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"

Claude Code MCP

En ukaz in ključ ostane zunaj tvojega repozitorija.

Obseg uporabnika ohrani povezavo na voljo v vsakem projektu, ne da bi ključ zapisal v konfiguracijsko datoteko pod nadzorom.

claude mcp add --scope user --transport http \
  knowsyou https://app.knowsyou.ai/mcp \
  --header "Authorization: Bearer $KNOWSYOU_API_KEY"

REST

Ena končna točka za preverjene ukaze.

Za skripte, avtomatizacije in dejanja GPT. Žive vhodne sheme odkrij na /api/v1/commands; vsak vnos navaja ustrezno orodje MCP. Ukazi za pisanje zahtevajo stabilen 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}}'

Ponovni poskusi

Ponovljeno pisanje ne postane ponovljen obrok.

Znova uporabi isti Idempotency-Key, ko nisi videl izida pisanja in se prvotni rezultat predvaja, namesto da bi se zapis ustvaril dvakrat. Pošlji novega za resnično nov vnos.

Meja zmožnosti

Dovolj široko za tvoj dnevnik, dovolj ozko za razlago.

Ključ uporablja en fiksen, na strežniku vzdrževan seznam dovoljenih ukazov, ne pa celotnega zaslona obsegov.

Obroki, prehrana, zdravljenja, navade in dejavnosti
Treningi, telesne meritve, cilji, rutine in preverjanja
Laboratorijski izvidi, izbrani spomini, zgodovina WHOOP in metapodatki fotografij

Ni izpostavljeno

Osebni API ključ ni druga seja v spletnem mestu.

Ne more se prijaviti v aplikacijo, klicati končne točke klepeta, brati sistemskih pozivov ali prestopiti meje overjenega profila.

Brez dostopa do zgodovine klepeta ali surovih datotek
Brez ocenjevanja slik ali poljubnih zunanjih klicev
Brez orodij za upravljanje med uporabniki ali internih orodij

Z ključem ravnaj kot z geslom

Ne prilepi ga v običajen klepet, ne shranjuj ga v sistem za nadzor različic in ga ne vstavljaj v javno konfiguracijsko datoteko. Kadar koli ga lahko zamenjaš ali prekličeš v nastavitvah; stara vrednost takoj preneha delovati.

Naj tvoj naslednji zaupanja vredni agent dela z evidenco, ki jo že vodiš.

Ustvari ključ enkrat, poveži orodje in ohrani KnowsYou kot viden vir resnice.

Začni brezplačno spremljati Preberi o podatkih in varnosti