> ## Documentation Index > Fetch the complete documentation index at: https://renor.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://app.renor.cloud/signup). Se o login expirar, rode o passo de login de novo; sua conta já existe. ```sh theme={null} 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](#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](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 `. Os exemplos abaixo mostram cada cliente. **Claude Code** (`.mcp.json` no projeto, ou `~/.claude.json`): ```json theme={null} { "mcpServers": { "renor": { "type": "http", "url": "https://mcp.renor.cloud/mcp", "headers": { "Authorization": "Bearer " } } } } ``` **Cursor** (`~/.cursor/mcp.json`): ```json theme={null} { "mcpServers": { "renor": { "url": "https://mcp.renor.cloud/mcp", "headers": { "Authorization": "Bearer " } } } } ``` **OpenCode** (`~/.config/opencode/opencode.json`): ```json theme={null} { "mcp": { "renor": { "type": "remote", "url": "https://mcp.renor.cloud/mcp", "headers": { "Authorization": "Bearer " } } } } ``` **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=` nesse arquivo: ```yaml theme={null} 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](#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. ```sh theme={null} 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](https://github.com/renorai/renor-engine#connect-your-agent) (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. > [!WARNING] > > 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: ```sh theme={null} 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 ```sh theme={null} 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 ```sh theme={null} 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 [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=renor\&config=eyJ1cmwiOiJodHRwczovL21jcC5yZW5vci5jbG91ZC9tY3AifQ%3D%3D) 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: ```json theme={null} { "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 [![Add to VS Code](https://img.shields.io/badge/VS_Code-Add_Renor-0098FF?style=flat-square\&logo=visualstudiocode\&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=renor\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.renor.cloud%2Fmcp%22%7D) 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: ```json theme={null} { "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: ```sh theme={null} 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): ```json theme={null} { "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`: ```json theme={null} { "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](https://renor.mintlify.site/pt-BR/how-it-works.md): o que é guardado e como a busca escolhe. * [Tools](https://renor.mintlify.site/tools.md): as ferramentas MCP e seus argumentos (em inglês). * [Limits and pricing](https://renor.mintlify.site/limits-and-pricing.md): Free e Pro (em inglês). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.