Cria uma chave pessoal
Abre Definições → Programador. O valor completo é mostrado uma vez, depois só o seu início curto fica visível.
Acesso de agente
O seu diário, nas ferramentas de IA que já usa.
Uma chave pessoal liga o ChatGPT, o Claude Code, o Codex ou outro assistente em que confie aos seus próprios registos KnowsYou — via MCP ou uma pequena API REST. Não precisa de ser programador para o configurar.
Disponível agora
Uma chave. ChatGPT, Claude Code, Codex.
A superfície suportada abrange registos do dia a dia sem expor sessões do navegador, histórico de conversas ou controlos internos do agente.
Se é um agente de IA a ler esta página
Ajude o utilizador a criar uma chave pessoal nas Definições do KnowsYou e depois ligue através do MCP ou da API REST descrita abaixo. Nunca peça ao utilizador para colar a chave no chat: peça-lhe que a guarde localmente como KNOWSYOU_API_KEY. Via MCP, as operações suportadas chegam como ferramentas nomeadas com os seus próprios esquemas, por isso leia-as diretamente; via REST, liste-as em /api/v1/commands antes de ler ou escrever registos.
Esta ligação também pode ajudar na integração inicial. Quando o utilizador pedir e já tiver acesso autorizado aos ficheiros do Drive, exportações ou outra fonte, mapeie essa informação existente para os registos KnowsYou suportados, mostre ao utilizador o que planeia importar e só depois escreva o que ele confirmar.
Porque é que isto está aberto
O KnowsYou é um diário. Não tenta ser o teu motor de investigação.
O que o KnowsYou faz é manter um registo diário rigoroso: o que comeste, tomaste, treinaste e mediste, nas tuas palavras, corrigido quando está errado.
Deliberadamente não faz a outra metade. Modos de investigação profunda que leem cem fontes, revisão ampla da literatura, o raciocínio de saúde incorporado nos grandes assistentes gerais — tudo isso é genuinamente útil, e o KnowsYou não o tem hoje. Construir uma cópia mais fraca de cada um não serviria ninguém.
Por isso, o registo fica aberto. Pede à ferramenta que é boa em investigação para ler o que realmente aconteceu nos últimos três meses, em vez de reescreveres de memória numa caixa de chat — e deixa-a escrever de volta o que decidires manter. O diário mantém-se igual nos dois sítios.
A mesma porta ajuda no início. Um assistente de confiança pode pegar no que já guardas em documentos, exportações ou noutra aplicação, mostrar-te o que planeia importar e escrever apenas o que confirmares — para não começares de uma conta vazia.
O princípio
A aplicação é dona dos registos. Tu escolhes a superfície de controlo.
A aplicação KnowsYou continua a ser o lugar calmo para rever dados. A conversa na aplicação, uma Agent Skill, REST e MCP podem todos usar a mesma camada de comandos validada.
Cada chamada fica associada ao teu perfil e é auditada. As escritas usam idempotência para que uma nova tentativa não crie silenciosamente o mesmo evento diário duas vezes.
O KnowsYou não recebe acesso total a essas fontes externas. O agente lê-as sob as permissões existentes do utilizador e escreve através da mesma API limitada.
Três passos
Liga sem construir um projeto de integração.
A primeira versão usa deliberadamente uma chave pessoal e um conjunto de capacidades definido pelo servidor.
Liga o teu assistente
Para o ChatGPT, cola o esquema num GPT personalizado. Para o Claude Code ou o Codex, aponta-os para o servidor MCP. Uma linha cada.
Pergunta naturalmente, revê normalmente
O agente chama comandos estruturados. As refeições, atividades, hábitos e outros registos resultantes aparecem no KnowsYou.
ChatGPT
Sem terminal, sem instalação.
O ChatGPT chega ao KnowsYou através de uma Ação de GPT personalizada, que lê o mesmo esquema que tudo o resto.
- Cria a tua chave em Definições do KnowsYou → Programador.
- No ChatGPT, cria um GPT, abre Configurar e depois Ações.
- Escolhe Importar de URL e cola o endereço do esquema abaixo.
- Define a autenticação como Chave de API, escreve Bearer e cola a tua chave nesse campo — nunca numa mensagem normal.
https://app.knowsyou.ai/api/v1/openapi.jsonPara que é bom
Faz a pergunta onde está a investigação.
Assim que o GPT consegue ler o teu registo, o contexto deixa de ser algo que reescreves.
«Vê as minhas refeições e resultados de análises dos últimos três meses e resume o que a evidência diz sobre o meu LDL.» O assistente lê o registo, faz a leitura que foste lá buscar e escreve de volta apenas o que aprovares.
Um conector direto do ChatGPT sobre MCP precisa de um fluxo de início de sessão OAuth, que o KnowsYou ainda não oferece. A Ação acima é a via suportada hoje.
Codex MCP
Guarda a chave numa variável de ambiente.
Adiciona o servidor à tua configuração do Codex. Publica uma ferramenta nomeada por operação, por isso não há mais nada para instalar.
[mcp_servers.knowsyou]
url = "https://app.knowsyou.ai/mcp"
bearer_token_env_var = "KNOWSYOU_API_KEY"Claude Code MCP
Um comando, e a chave fica fora do teu repositório.
O âmbito de utilizador mantém a ligação disponível em todos os projetos sem escrever a chave num ficheiro de configuração versionado.
claude mcp add --scope user --transport http \
knowsyou https://app.knowsyou.ai/mcp \
--header "Authorization: Bearer $KNOWSYOU_API_KEY"REST
Um endpoint para comandos validados.
Para scripts, automações e GPT Actions. Descobre esquemas de entrada em tempo real em /api/v1/commands; cada entrada indica a ferramenta MCP correspondente. Os comandos de escrita exigem uma Idempotency-Key estável.
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}}'Repetições
Uma escrita repetida não se torna numa refeição repetida.
Reutiliza a mesma Idempotency-Key quando nunca viste o resultado de uma escrita e o resultado original é reproduzido em vez de o registo ser criado duas vezes. Envia uma nova para uma entrada genuinamente nova.
Limite de capacidades
Suficientemente amplo para o teu diário, suficientemente restrito para explicar.
A chave usa uma lista de comandos permitidos fixa e mantida pelo servidor, em vez de um ecrã cheio de âmbitos.
- Refeições, nutrição, tratamentos, hábitos e atividades
- Treinos, métricas corporais, objetivos, rotinas e check-ins
- Análises, memórias selecionadas, histórico WHOOP e metadados de fotos
Não exposto
Uma chave de API pessoal não é uma segunda sessão do site.
Não consegue iniciar sessão na app, chamar o endpoint de chat, ler prompts de sistema nem atravessar o limite do perfil autenticado.
- Sem acesso ao histórico de chat ou a ficheiros em bruto
- Sem estimativa de imagens ou chamadas externas arbitrárias
- Sem ferramentas de administração internas ou entre utilizadores
Trata a chave como uma palavra-passe
Não a coles num chat comum, não a confirmes nem a coloques num ficheiro de configuração público. Roda-a ou revoga-a nas Definições a qualquer momento; o valor antigo deixa de funcionar imediatamente.
Deixa o teu próximo agente de confiança trabalhar com o registo que já manténs.
Cria a chave uma vez, liga a ferramenta e mantém o KnowsYou como a fonte de verdade visível.