Quickstart

Conecte seu agente de IA ao Renor em cinco minutos e confira se ele lembra.

O Renor dá aos seus agentes de IA uma memória durável, via MCP. O que você conta a um agente conectado, todos os agentes conectados podem lembrar depois. Escolha um caminho.

​

Hospedado (renor.cloud): cerca de cinco minutos

Você precisa do Node 18 ou superior e de uma conta Renor. Qualquer pessoa pode se cadastrar, sem lista de espera: crie a sua em https://app.renor.cloud/signup. Se o login expirar, rode o passo de login de novo; sua conta já existe.

npx renor setup

Para ligar de forma explícita os hooks do Claude Code que salvam ao parar (Stop) e carregam as regras fixas no início da sessão, rode npx renor setup --capture. Veja os cinco estados de captura de cliente e servidor com npx renor capture status e desfaça as mudanças no cliente com npx renor setup --capture --uninstall. O instalador adiciona apenas hooks.Stop e hooks.SessionStart às configurações do Claude Code; o operador do workspace controla as três funções do servidor.

O que você vai ver:

1. Found: a lista de apps que ele detectou (Claude Code, Codex, Cursor, OpenCode, Pi, VS Code). Ele pergunta [Y/n] antes de mudar qualquer coisa; use --dry-run para só ver o que faria e -y para pular a pergunta.
2. Sign-in: o navegador abre para cada app que consegue entrar pelo terminal. Entre uma vez e clique em Approve. Nenhuma chave é copiada nem guardada.
3. Skill: ele instala a skill do Renor, que diz ao seu agente quando lembrar e quando salvar.
4. Done: uma lista, por app, do que ainda falta, se faltar algo (por exemplo, no Claude Code rode /mcp, escolha renor e Authenticate).

Reinicie o agente e confira se funciona. Todos os agentes usam o mesmo endereço, https://mcp.renor.cloud/mcp. ChatGPT e Claude.ai são configurados à mão, mais abaixo.

​

Rodando em um servidor?

Se o agente roda em uma máquina remota (servidor na nuvem, VPS, sessão SSH), não há tela para abrir o navegador de login, então o passo de login não consegue terminar. Use uma chave de acesso. Entre em qualquer dispositivo seu e depois:

1. Acesse https://app.renor.cloud, abra API keys e escolha Create key.
2. Copie a chave. Ela aparece uma única vez. Mantenha-a privada: não cole no chat, em um arquivo que você vai commitar nem em um histórico de terminal compartilhado.
3. Adicione o Renor à configuração MCP do agente com o endereço https://mcp.renor.cloud/mcp e o header Authorization: Bearer <key>. Os exemplos abaixo mostram cada cliente.

Claude Code (.mcp.json no projeto, ou ~/.claude.json):

{
  "mcpServers": {
    "renor": {
      "type": "http",
      "url": "https://mcp.renor.cloud/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "renor": {
      "url": "https://mcp.renor.cloud/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

OpenCode (~/.config/opencode/opencode.json):

{
  "mcp": {
    "renor": {
      "type": "remote",
      "url": "https://mcp.renor.cloud/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Hermes (~/.hermes/config.yaml). O Hermes lê ${RENOR_API_KEY} de ~/.hermes/.env, então a chave pode ficar fora do arquivo de configuração. Coloque RENOR_API_KEY=<key> nesse arquivo:

mcp_servers:
  renor:
    url: "https://mcp.renor.cloud/mcp"
    headers:
      Authorization: "Bearer ${RENOR_API_KEY}"

Escreva a chave no arquivo com um editor, e não como argumento de comando, para que ela não vá para o histórico do shell. Deixe o arquivo legível só por você (chmod 600). Reinicie o agente e confira se funciona. Para cortar o acesso, abra API keys e revogue a chave; ela deixa de funcionar em qualquer agente que a use.

Outros clientes que aceitam um servidor MCP remoto com headers funcionam do mesmo jeito. O npx renor setup mostra estes mesmos passos quando não encontra tela na máquina em que roda.

​

Auto-hospedado (na sua máquina, sem conta)

Você precisa do Node 22. Suas notas ficam como arquivos Markdown em ~/.renor; nada sai da sua máquina.

claude mcp add --scope user renor-local -- npx -y renor-engine mcp
codex mcp add renor-local -- npx -y renor-engine mcp

Para qualquer outro cliente, o servidor é o comando npx com os argumentos -y renor-engine mcp. A primeira execução baixa cerca de 12 MB e leva cerca de 3 segundos, então seu agente pode mostrar uma conexão com falha: reinicie-o. A instalação por clone e a pasta de notas personalizada estão no README do engine (em inglês).

​

Confira se funciona

1. Em uma sessão, diga ao agente: “Save to Renor: my favorite editor is Neovim.”
2. Abra uma sessão nova (outro chat, ou outro agente conectado) e pergunte: “What is my favorite editor?”

O Renor deve responder Neovim. Ele busca por significado e também por palavras, então você não precisa repetir o que salvou palavra por palavra; uma pergunta muito vaga, como “what do you know about me?”, ainda pode voltar vazia. No ChatGPT, comece os dois chats com @Renor.

Não guarde credenciais nem segredos como memórias.

Recomendado: adicione esta linha ao AGENTS.md ou ao CLAUDE.md do seu projeto, para que o agente consulte o Renor ao começar uma tarefa ou quando estiver em dúvida (a linha fica em inglês, como o resto da regra de memória):

Before starting a task or when anything is unclear, ask Renor (get_context) what was already decided; save new decisions with remember.

Cole você mesmo, ou deixe o agente adicionar depois de perguntar a você. O setup do Renor não escreve esta linha por você.

​

Problemas comuns

• O agente não menciona o Renor, ou diz que não tem essa ferramenta. Reinicie o agente depois do setup. Depois rode /mcp (Claude Code) ou codex mcp list e confirme que renor aparece e está logado. Se aparece mas não está logado, rode o login de novo: codex mcp login renor, cursor-agent mcp login renor, opencode mcp auth renor, pi mcp login renor. Sua conta já existe, então repetir um login que expirou é seguro.

• Está conectado, mas nunca lembra. Pergunte direto: “Check Renor for my favorite editor.” Se funcionar, falta a skill; rode npx renor setup de novo (ele pula apps que já têm o Renor) ou instale só a skill:

  npx skills@1.7.2 add https://github.com/renorai/renor-skills/tree/018fddc51e6066c30c6919fdf27bbb1c8b64187a --agent '*' -y
  

  No seu próprio terminal, npx skills@1.7.2 add https://github.com/renorai/renor-skills/tree/018fddc51e6066c30c6919fdf27bbb1c8b64187a pergunta em quais agentes instalar.

• renor já existe, ou a página de login não termina. Se um app tem um servidor renor em outro endereço, npx renor setup --force o substitui (no Claude Code, claude mcp remove renor e adicione de novo). No login, o OpenCode usa a porta 19876 e o app desktop do Cursor a 8787 para o retorno; pare qualquer programa que esteja usando essa porta (8787 é a padrão do Cloudflare wrangler). Versões do Cursor que ainda entram por cursor:// são recusadas até o Cursor ser atualizado.

​

Adicione o Renor à mão

Se o npx renor setup não cobre a sua ferramenta, adicione o endereço você mesmo. Cada ferramenta faz o login pelo navegador.

​

Claude Code

claude mcp add --transport http --scope user renor https://mcp.renor.cloud/mcp

Se renor já existe, remova primeiro (claude mcp remove renor) e adicione de novo.

Reinicie o Claude Code, rode /mcp, escolha renor e clique em Authenticate.

​

Codex

codex mcp add renor --url https://mcp.renor.cloud/mcp

No Codex 0.160.x isso já abre o login no navegador; em versões mais novas, se não abrir, rode codex mcp login renor. Depois reinicie o Codex.

​

Cursor

O botão abre o Cursor, que pede para instalar o renor. Para fazer à mão, junte isto ao ~/.cursor/mcp.json, mantendo todos os servidores que já existem:

{
  "mcpServers": {
    "renor": { "url": "https://mcp.renor.cloud/mcp" }
  }
}

Salve o arquivo, reinicie o Cursor, abra Customize › MCPs, encontre renor e entre. No terminal, cursor-agent mcp login renor faz o mesmo.

O login do Renor aceita o retorno local que o Cursor CLI usa (verificado com o Cursor CLI 2026.09.28 em 2026-10-06) e recusa o retorno antigo cursor://, então uma versão do Cursor que ainda entra por cursor:// é rejeitada até o Cursor ser atualizado.

O OpenCode usa a porta 19876 e o app desktop do Cursor usa a 8787 para o retorno do login; se outro programa estiver usando essa porta (8787 é a porta padrão de desenvolvimento do Cloudflare wrangler), pare-o durante o login.

​

VS Code

O botão abre o VS Code, que pede para instalar o renor para o GitHub Copilot. Para fazer à mão, rode MCP: Add Server na Command Palette, escolha HTTP e cole o endereço acima. O VS Code pede que você entre no Renor na primeira vez que o Copilot o usar.

​

OpenCode

Junte isto ao ~/.config/opencode/opencode.json, mantendo todas as chaves que já existem:

{
  "mcp": {
    "renor": { "type": "remote", "url": "https://mcp.renor.cloud/mcp" }
  }
}

Rode opencode mcp auth renor e reinicie o OpenCode.

​

Pi

O Pi 0.99 e superiores têm suporte a MCP embutido. Rode:

pi mcp add renor --url https://mcp.renor.cloud/mcp --exposure direct
pi mcp login renor

--exposure direct declara as ferramentas do Renor ao modelo uma a uma; o padrão do Pi, codemode, deixa isso para scripts. pi mcp login abre o login no navegador. Se as ferramentas do Renor não aparecem no Pi, rode /reload lá.

Antes do Pi 0.99 não existe pi mcp. Confira com pi --version; se for anterior à 0.99, rode pi update primeiro e depois os dois comandos acima.

​

Gemini CLI

O npx renor setup adiciona o Renor ao ~/.gemini/settings.json. À mão, junte isto, mantendo todas as chaves que já existem (o Gemini CLI lê httpUrl para um servidor streamable-HTTP):

{
  "mcpServers": {
    "renor": { "httpUrl": "https://mcp.renor.cloud/mcp" }
  }
}

Abra o Gemini CLI, digite /mcp auth renor e aprove o Renor no navegador.

Pare os pedidos de permissão. O Gemini CLI pergunta antes de toda chamada de ferramenta MCP, mesmo nas que o Renor marca como somente leitura, a menos que o servidor seja confiável. Adicione "trust": true à entrada renor:

{
  "mcpServers": {
    "renor": { "httpUrl": "https://mcp.renor.cloud/mcp", "trust": true }
  }
}

Reinicie o Gemini CLI. Com trust ligado, o Gemini CLI pula a confirmação para toda ferramenta do Renor, inclusive retire_memory, que tira uma memória da busca (restore_memory a traz de volta). Se preferir manter essa confirmação, deixe trust desligado e escolha a opção “always allow” que o Gemini CLI oferece no prompt.

​

ChatGPT e Claude.ai

Esses apps rodam no navegador, então um agente dentro do chat não consegue adicionar o Renor por você. Adicione como conector personalizado nas configurações do próprio app, com o endereço acima. Os caminhos abaixo vêm das páginas de ajuda dos próprios apps em 2026-10-08 e podem mudar.

• Claude.ai: Customize › Connectors › + Add › Add custom connector. Dê o nome Renor, cole o endereço, mantenha as configurações de login que o Claude detectar (se ele perguntar como o Claude se identifica, escolha Register automatically, e não a identidade publicada do Claude — o Renor registra o próprio cliente), depois Add e Connect. Em cada chat novo, abra + › Connectors e ligue o Renor. Em um plano Team ou Enterprise, um Owner adiciona primeiro, em Organization settings › Connectors; os membros então clicam em Connect.
• ChatGPT: chatgpt.com/plugins › + › Add custom MCP server. Dê o nome Renor, cole o endereço, escolha OAuth, confirme o aviso de risco e depois Create as a plugin. Instale o plugin, abra um chat novo, digite @ e escolha Renor. O ChatGPT pede que você entre no Renor na primeira vez que usa uma ferramenta. A política de segurança do admin do workspace, incluindo o Lockdown, pode bloquear servidores MCP personalizados; se o seu estiver bloqueado, peça ao admin para liberar o Renor.

​

Próximos passos

• Como funciona: o que é guardado e como a busca escolhe.
• Tools: as ferramentas MCP e seus argumentos (em inglês).
• Limits and pricing: Free e Pro (em inglês).