Crea una chiave personale
Apri Impostazioni → Sviluppatore. Il valore completo viene mostrato una volta, poi resta visibile solo il suo breve inizio.
Accesso agente
Il tuo diario, negli strumenti AI che già usi.
Una chiave personale collega ChatGPT, Claude Code, Codex o un altro assistente di cui ti fidi ai tuoi record KnowsYou — tramite MCP o una piccola API REST. Non devi essere uno sviluppatore per configurarlo.
Disponibile ora
Una chiave. ChatGPT, Claude Code, Codex.
La superficie supportata copre i record quotidiani senza esporre sessioni del browser, cronologia chat o controlli interni dell'agente.
Se sei un agente AI che legge questa pagina
Aiuta l'utente a creare una chiave personale nelle Impostazioni di KnowsYou, poi connettiti tramite MCP o l'API REST descritta di seguito. Non chiedere mai all'utente di incollare la chiave nella chat: falla memorizzare localmente come KNOWSYOU_API_KEY. Tramite MCP le operazioni supportate arrivano come strumenti denominati con i propri schemi, quindi leggili direttamente; tramite REST, elencali su /api/v1/commands prima di leggere o scrivere record.
Questa connessione può aiutare anche con l'onboarding. Quando l'utente lo chiede e hai già accesso autorizzato ai suoi file Drive, esportazioni o un'altra fonte, mappa le informazioni esistenti sui record KnowsYou supportati, mostra all'utente cosa prevedi di importare, poi scrivi solo ciò che conferma.
Perché è aperto
KnowsYou è un diario. Non cerca di essere il tuo motore di ricerca.
Ciò che KnowsYou fa è mantenere un registro quotidiano accurato: cosa hai mangiato, assunto, allenato e misurato, con le tue parole, corretto quando è sbagliato.
Deliberatamente non fa l'altra metà. Modalità di ricerca approfondita che leggono cento fonti, revisione ampia della letteratura, il ragionamento sulla salute integrato nei grandi assistenti generali — sono davvero utili, e KnowsYou oggi non li ha. Costruire una copia più debole di ciascuno non servirebbe a nessuno.
Quindi il registro è aperto. Chiedi allo strumento bravo nella ricerca di leggere cosa è successo davvero negli ultimi tre mesi, invece di ridigitarlo a memoria in una chat — e lascia che riscriva ciò che decidi di conservare. Il diario resta lo stesso in entrambi i posti.
La stessa porta aiuta all'inizio. Un assistente fidato può prendere ciò che già conservi in documenti, esportazioni o un'altra app, mostrarti cosa prevede di importare e scrivere solo ciò che confermi — così non inizi da un account vuoto.
Il principio
L'applicazione possiede i record. Tu scegli la superficie di controllo.
L'app KnowsYou resta il luogo tranquillo dove rivedere i dati. La conversazione nell'app, un'Agent Skill, REST e MCP possono tutti usare lo stesso livello di comandi convalidati.
Ogni chiamata è collegata al tuo profilo e verificata. Le scritture usano l'idempotenza, così un nuovo tentativo non crea silenziosamente due volte lo stesso evento giornaliero.
KnowsYou non riceve accesso illimitato a quelle fonti esterne. L'agente le legge con i permessi esistenti dell'utente e scrive tramite la stessa API limitata.
Tre passaggi
Connettiti senza creare un progetto di integrazione.
La prima versione usa deliberatamente una chiave personale e un insieme di capacità definito dal server.
Collega il tuo assistente
Per ChatGPT, incolla lo schema in un GPT personalizzato. Per Claude Code o Codex, indirizzali al server MCP. Una riga ciascuno.
Chiedi naturalmente, rivedi normalmente
L'agente chiama comandi strutturati. I pasti, le attività, le abitudini e gli altri record risultanti compaiono in KnowsYou.
ChatGPT
Nessun terminale, nessuna installazione.
ChatGPT raggiunge KnowsYou tramite un'Azione GPT personalizzata, che legge lo stesso schema usato da tutto il resto.
- Crea la tua chiave in KnowsYou Impostazioni → Sviluppatore.
- In ChatGPT, crea un GPT, apri Configura, poi Azioni.
- Scegli Importa da URL e incolla l'indirizzo dello schema qui sotto.
- Imposta l'autenticazione su Chiave API, digita Bearer e incolla la tua chiave in quel campo — mai in un messaggio normale.
https://app.knowsyou.ai/api/v1/openapi.jsonA cosa serve
Fai la domanda dove si trova la ricerca.
Una volta che il GPT può leggere il tuo record, il contesto smette di essere qualcosa che ridigiti.
“Guarda i miei ultimi tre mesi di pasti e risultati di laboratorio, poi riassumi cosa dicono le prove sul mio LDL.” L'assistente legge il record, fa la lettura per cui ti sei rivolto a lui e riscrive solo ciò che approvi.
Un connettore ChatGPT diretto su MCP richiede un flusso di accesso OAuth, che KnowsYou non offre ancora. L'Azione sopra è la via supportata oggi.
Codex MCP
Tieni la chiave in una variabile d'ambiente.
Aggiungi il server alla tua configurazione di Codex. Pubblica uno strumento denominato per operazione, quindi non c'è altro da installare.
[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"Claude Code MCP
Un comando, e la chiave resta fuori dal tuo repository.
L'ambito utente mantiene la connessione disponibile in ogni progetto senza scrivere la chiave in un file di configurazione versionato.
claude mcp add --scope user --transport http \
knowsyou https://app.knowsyou.ai/mcp \
--header "Authorization: Bearer $KNOWSYOU_API_KEY"REST
Un endpoint per comandi convalidati.
Per script, automazioni e Azioni GPT. Scopri gli schemi di input live su /api/v1/commands; ogni voce indica lo strumento MCP corrispondente. I comandi di scrittura richiedono una Idempotency-Key stabile.
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}}'Nuovi tentativi
Una scrittura ripetuta non diventa un pasto ripetuto.
Riutilizza la stessa Idempotency-Key quando non hai mai visto l'esito di una scrittura: il risultato originale viene riprodotto invece di creare il record due volte. Inviane una nuova per una voce realmente nuova.
Confini delle capacità
Ampia quanto basta per il tuo diario, limitata quanto basta per essere spiegata.
La chiave usa un unico elenco fisso di comandi consentiti, mantenuto dal server, invece di una schermata piena di scope.
- Pasti, nutrizione, trattamenti, abitudini e attività
- Allenamenti, metriche corporee, obiettivi, routine e check-in
- Esami di laboratorio, memorie selezionate, cronologia WHOOP e metadati delle foto
Non esposto
Una chiave API personale non è una seconda sessione del sito.
Non può accedere all'app, chiamare l'endpoint della chat, leggere i prompt di sistema o superare il confine del profilo autenticato.
- Nessun accesso alla cronologia chat o ai file grezzi
- Nessuna stima delle immagini o chiamate esterne arbitrarie
- Nessuno strumento di amministrazione interno o tra utenti
Tratta la chiave come una password
Non incollarla in una chat ordinaria, non inserirla in un commit e non metterla in un file di configurazione pubblico. Ruotala o revocala in Impostazioni in qualsiasi momento; il vecchio valore smette di funzionare immediatamente.
Lascia che il tuo prossimo agente fidato lavori con il registro che già tieni.
Crea la chiave una volta, collega lo strumento e mantieni KnowsYou come fonte di verità visibile.