Acces pentru agenți

Jurnalul tău, în uneltele AI pe care le folosești deja.

O singură cheie personală conectează ChatGPT, Claude Code, Codex sau alt asistent în care ai încredere la propriile tale date din KnowsYou — prin MCP sau printr-un API REST mic. Nu trebuie să fii programator ca să-l configurezi.

Disponibil acum

O cheie. ChatGPT, Claude Code, Codex.

Suprafața suportată acoperă înregistrările de zi cu zi, fără să expună sesiuni de browser, istoricul conversației sau controale interne ale agentului.

Trimite-i agentului tău

Trimite un link. Cheia rămâne la tine.

Lipește pagina asta în Codex, Claude Code, ChatGPT sau alt agent. Conține pașii de conectare și îi spune agentului cum să-ți trateze cheia în siguranță.

https://knowsyou.ai/ro/acces-agent

Trimite doar linkul — nu cheia ta de API.

Dacă ești un agent AI care citește pagina asta

Ajută-l pe utilizator să-și creeze o cheie personală în Setările KnowsYou, apoi conectează-te prin MCP sau prin API-ul REST descris mai jos. Nu-i cere niciodată să lipească cheia în chat: pune-l s-o păstreze local, ca KNOWSYOU_API_KEY. Prin MCP, operațiile suportate sosesc ca unelte cu nume și cu propriile scheme, deci citește-le direct; prin REST, listează-le la /api/v1/commands înainte să citești sau să scrii ceva.

Conexiunea asta poate ajuta și la început. Când utilizatorul îți cere și ai deja acces autorizat la fișierele lui din Drive, la exporturi sau la altă sursă, transformă informația existentă în înregistrări KnowsYou suportate, arată-i ce ai de gând să imporți, apoi scrie doar ce confirmă el.

De ce e deschis

KnowsYou e un jurnal. Nu încearcă să-ți fie motor de documentare.

Ce face KnowsYou e să țină o evidență zilnică exactă: ce ai mâncat, ce ai luat, cum ai antrenat și ce ai măsurat, în cuvintele tale, corectată când e greșită.

Cealaltă jumătate n-o face intenționat. Modurile de cercetare care citesc o sută de surse, trecerea în revistă a literaturii, raționamentul despre sănătate din asistenții generali mari — alea sunt cu adevărat utile, iar KnowsYou nu le are azi. O copie mai slabă a fiecăreia n-ar folosi nimănui.

Așa că e deschisă evidența, în schimb. Cere-i uneltei care se pricepe la documentare să citească ce s-a întâmplat de fapt în ultimele trei luni, în loc să retastezi din memorie într-o casetă de chat — și las-o să scrie înapoi ce decizi tu să păstrezi. Jurnalul rămâne același în ambele locuri.

Aceeași ușă ajută și la început. Un asistent de încredere poate lua ce ții deja în documente, exporturi sau altă aplicație, îți poate arăta ce are de gând să importe și poate scrie doar ce confirmi — ca să nu pornești de la un cont gol.

Principiul

Aplicația deține înregistrările. Tu alegi suprafața de control.

Aplicația KnowsYou rămâne locul liniștit în care îți citești datele. Conversația din aplicație, un Agent Skill, REST și MCP pot folosi toate același strat de comenzi validate.

Fiecare apel e legat de profilul tău și auditat. Scrierile folosesc idempotență, ca o reîncercare să nu creeze tăcut de două ori același eveniment.

KnowsYou nu primește acces general la sursele externe. Agentul le citește cu permisiunile pe care le are deja utilizatorul și scrie prin același API delimitat.

Trei pași

Te conectezi fără să construiești un proiect de integrare.

Prima versiune folosește intenționat o singură cheie personală și un singur set de capabilități definit de server.

01

Creează o cheie personală

Deschide Setări → Dezvoltator. Valoarea completă se arată o singură dată, apoi rămâne vizibil doar începutul ei scurt.

02

Conectează-ți asistentul

Pentru ChatGPT, lipești schema într-un GPT personalizat. Pentru Claude Code sau Codex, îi îndrepți spre serverul MCP. Câte o linie fiecare.

03

Întrebi natural, verifici normal

Agentul apelează comenzi structurate. Mesele, activitățile, obiceiurile și celelalte înregistrări rezultate apar în KnowsYou.

ChatGPT

Fără terminal, fără instalare.

ChatGPT ajunge la KnowsYou printr-o acțiune de GPT personalizat, care citește aceeași schemă ca tot restul.

  1. Creează-ți cheia în KnowsYou, la Setări → Dezvoltator.
  2. În ChatGPT, creează un GPT, deschide Configure, apoi Actions.
  3. Alege Import from URL și lipește adresa schemei de mai jos.
  4. Pune autentificarea pe API Key, tipul Bearer, și lipește cheia în câmpul acela — niciodată într-un mesaj obișnuit.
https://app.knowsyou.ai/api/v1/openapi.json

La ce e bun

Pune întrebarea acolo unde e documentarea.

Odată ce GPT-ul îți poate citi evidența, contextul nu mai e ceva ce retastezi.

„Uită-te la ultimele trei luni de mese și analize, apoi rezumă ce spun dovezile despre LDL-ul meu.” Asistentul citește evidența, face documentarea pentru care ai venit la el și scrie înapoi doar ce aprobi tu.

Un conector ChatGPT direct prin MCP are nevoie de un flux de autentificare OAuth, pe care KnowsYou nu îl oferă încă. Acțiunea de mai sus e ruta suportată azi.

Codex MCP

Ține cheia într-o variabilă de mediu.

Adaugi serverul în configurația Codex. Publică o unealtă cu nume pentru fiecare operație, deci n-ai altceva de instalat.

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

Claude Code MCP

O comandă, iar cheia rămâne în afara depozitului tău.

Domeniul de utilizator ține conexiunea disponibilă în fiecare proiect, fără să scrie cheia într-un fișier de configurare urmărit de git.

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

REST

Un singur endpoint pentru comenzi validate.

Pentru scripturi, automatizări și acțiuni de GPT. Descoperi schemele de intrare live la /api/v1/commands; fiecare intrare numește unealta MCP corespunzătoare. Comenzile de scriere cer o Idempotency-Key stabilă.

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}}'

Reîncercări

O scriere repetată nu devine o masă repetată.

Refolosește aceeași Idempotency-Key când n-ai văzut niciodată rezultatul unei scrieri, iar rezultatul original se redă în loc ca înregistrarea să fie creată de două ori. Trimite una nouă pentru o intrare cu adevărat nouă.

Limita de capabilități

Destul de largă pentru jurnalul tău, destul de îngustă cât să poată fi explicată.

Cheia folosește o singură listă fixă de comenzi permise, întreținută de server, nu un ecran plin de domenii de acces.

  • Mese, nutriție, tratamente, obiceiuri și activități
  • Antrenamente, măsurători corporale, obiective, rutine și check-in-uri
  • Analize, memorii selectate, istoric WHOOP și metadate de poze

Ce nu e expus

O cheie personală de API nu e o a doua sesiune de site.

Nu se poate autentifica în aplicație, nu poate apela endpointul de chat, nu poate citi prompturile de sistem și nu poate trece dincolo de limita profilului autentificat.

  • Fără acces la istoricul conversației sau la fișierele brute
  • Fără estimare din imagini și fără apeluri externe arbitrare
  • Fără unelte între utilizatori sau de administrare internă

Tratează cheia ca pe o parolă

Nu o lipi într-un chat obișnuit, nu o comite în git și nu o pune într-un fișier public de configurare. O poți roti sau revoca oricând din Setări; valoarea veche încetează să funcționeze imediat.

Lasă-ți următorul agent de încredere să lucreze cu evidența pe care o ții deja.

Creezi cheia o dată, conectezi unealta și păstrezi KnowsYou ca sursă vizibilă de adevăr.