Configuração do MCP

A maioria dos usuários não precisa desta página. Todo cliente de IA moderno (Claude, Cursor, ChatGPT, VS Code, Windsurf, Zed) tem uma interface que adiciona o Engram em poucos cliques. Veja Integrações de IA para o passo a passo de cada cliente.

Se você prefere editar um arquivo de configuração (ou seu cliente não tem interface gráfica), há três caminhos, do mais fácil ao mais trabalhoso: entregar a configuração para a sua IA, seguir as abas de cada cliente ou dispensar o OAuth e usar uma chave de API.

Peça para sua IA configurar

O caminho mais rápido: cole o prompt abaixo no seu assistente de IA. Ele identifica em qual cliente está rodando, edita o arquivo de configuração certo (ou executa o comando de CLI certo) e diz o que fazer em seguida.

Add Engram as an MCP server in this AI client, then teach the AI to use it.

URL: https://mcp.engram.page
Transport: HTTP
Auth: OAuth — a browser opens on first connect.

First, pick the right path for this client (CLI like `claude mcp add`, editing an mcp.json, etc.), do the setup, and tell me how to restart so the new server registers.

After that's done, add the text below to my long-lived system / global prompt for this client (e.g. ~/.claude/CLAUDE.md for Claude Code, Cursor Rules for Cursor, the personal preferences field at claude.ai/settings/general for Claude Desktop). If it's a web UI you can't edit, just tell me where to paste it:

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Reference: https://engram.page/docs/mcp/manual-config/

Se algo der errado (ou se você preferir fazer por conta própria), as abas de cada cliente abaixo trazem a receita manual completa.

Endpoint MCP do Engram

https://mcp.engram.page

O Engram fala MCP sobre HTTPS. Há duas formas de autenticar:

• OAuth (padrão). Na primeira vez que seu cliente se conecta à URL acima, uma janela do navegador abre para você entrar. Depois disso, o cliente guarda um token e reconecta sem avisos. Sem chaves para copiar.
• Chave de API para configurações headless, com scripts ou de cofre compartilhado. Envie a chave como token Bearer em um cabeçalho Authorization. Veja Autenticação por chave de API abaixo.

Em ambos os casos, sem variáveis de ambiente e sem processo de servidor local.

Configure seu cliente

Escolha seu cliente abaixo. Cada aba é uma receita completa: configuração, recarga, primeira autenticação e onde ensinar a IA a realmente usar o Engram.

Para self-host, troque a URL da nuvem pela URL /api/mcp do seu próprio backend em qualquer um dos trechos abaixo. Veja a seção de endpoints acima para os placeholders canônicos.

Claude Code

1. Adicione o Engram. Use a CLI do Claude Code, que faz a edição da configuração por você:

claude mcp add --transport http --scope user engram https://mcp.engram.page

A flag --scope user deixa o Engram disponível em todos os projetos. Retire-a (ou use --scope project) para limitar o Engram ao .mcp.json do projeto atual.

Prefere manualmente? Adicione ao ~/.claude.json (escopo de usuário) ou ao .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarregue. Saia da sessão atual do Claude Code e execute claude de novo. Rode claude mcp list para confirmar que o Engram está registrado.

3. Primeira autenticação. O Claude Code não pede automaticamente. Na nova sessão, execute /mcp, selecione engram (aparece como △ needs authentication) e escolha Authenticate. Seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, e o Claude Code guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga ao Claude para usá-lo. Acrescente o trecho abaixo ao ~/.claude/CLAUDE.md, seu arquivo de instruções no nível do usuário, aplicado a todos os projetos.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Cursor

1. Edite a configuração. Adicione o Engram ao ~/.cursor/mcp.json (escopo de usuário) ou ao .cursor/mcp.json na raiz do projeto (escopo de projeto):

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarregue. Feche o Cursor por completo (Cmd+Q / File → Exit) e abra de novo. Recarregar a janela não basta; os servidores MCP são registrados na inicialização do app.

3. Primeira autenticação.

Na primeira vez que Cursor chamar o Engram, seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, pronto. Cursor guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga ao Cursor para usá-lo. Adicione o trecho abaixo às Rules do Cursor: ~/.cursor/rules (escopo de usuário) ou .cursor/rules em um projeto.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

VS Code

1. Edite a configuração. Adicione o Engram ao .vscode/mcp.json do seu workspace. O VS Code usa servers em vez de mcpServers e exige "type": "http":

{
  "servers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarregue. Execute Developer: Reload Window na paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P). Não é preciso reiniciar o VS Code por completo.

3. Primeira autenticação.

Na primeira vez que Copilot Chat (or your MCP-aware extension) chamar o Engram, seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, pronto. Copilot Chat (or your MCP-aware extension) guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga ao VS Code para usá-lo. Adicione o trecho abaixo às custom instructions do seu workspace (Copilot Chat → settings → Custom Instructions, ou o equivalente da sua extensão).

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Windsurf

1. Edite a configuração. Adicione o Engram ao ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarregue. Feche o Windsurf por completo e abra de novo. Recarregar a janela pode não disparar o registro do servidor MCP.

3. Primeira autenticação.

Na primeira vez que Windsurf chamar o Engram, seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, pronto. Windsurf guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga ao Windsurf para usá-lo. Adicione o trecho abaixo ao painel AI Rules do Windsurf (Workspace → AI Rules) ou ao ~/.codeium/windsurf/global_rules.md para regras de todo o usuário.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Zed

1. Edite a configuração. Abra o ~/.config/zed/settings.json e adicione o Engram em context_servers (a chave de agrupamento do Zed, não o mcpServers padrão):

{
  "context_servers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

2. Recarregue. Execute zed: reload settings na paleta de comandos (Cmd+Shift+P). Em casos teimosos, feche o Zed por completo e abra de novo.

3. Primeira autenticação.

Na primeira vez que Zed's assistant chamar o Engram, seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, pronto. Zed's assistant guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga ao Zed para usá-lo. Adicione o trecho abaixo ao prompt padrão do seu assistente no settings.json (em assistant.default_prompt) ou pela interface de configurações do assistente.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Other / Custom

1. Edite a configuração. A maioria dos clientes MCP aceita o agrupamento mcpServers padrão:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.engram.page"
    }
  }
}

Se seu cliente não reconhecer esse formato, consulte a documentação dele para saber qual chave de agrupamento espera (o VS Code usa servers, o Zed usa context_servers).

2. Recarregue. A maioria dos clientes precisa de uma reinicialização completa, e não apenas de recarregar a janela, para registrar novos servidores MCP.

3. Primeira autenticação.

Na primeira vez que the client chamar o Engram, seu navegador abre para o OAuth. Entre no Engram, aprove a conexão, pronto. the client guarda o token e o reutiliza dali em diante. A concessão é o escopo mcp completo hoje; escopos granulares por ação estão no roteiro.

4. Diga à sua IA para usá-lo. Cole o trecho abaixo onde seu cliente aceita instruções de sistema ou globais de longa duração.

Engram holds my personal notes — treat it as your long-term memory of me. Search it when a question depends on context I might have shared before. Before saving or updating a note, ask first.

Autenticação por chave de API

O OAuth é o padrão. Use uma chave de API para acesso headless ou com scripts, para controle por conexão (um bot com permissão de escrita versus um agente somente leitura) ou para compartilhar um cofre sem conceder login completo. Uma única chave autentica tanto o MCP quanto a API REST. Hoje toda chave carrega o acesso completo da sua conta; escopos finos por chave estão no roteiro.

Obtenha uma chave

Gere uma em app.engram.page/settings/api-keys. O Engram exibe a chave completa uma única vez, na criação, e depois mostra apenas o prefixo. Trate-a como uma senha e guarde em um lugar seguro.

Adicione à sua configuração

Adicione um bloco headers que envia a chave como token Bearer. A chave de agrupamento (mcpServers / servers / context_servers) segue o cliente que você está configurando, então use o mesmo formato que a sua aba acima mostrou. Para os clientes com mcpServers padrão:

{
  "mcpServers": {
    "engram": {
      "type": "http",
      "url": "https://mcp.engram.page",
      "headers": {
        "Authorization": "Bearer engram_YOUR_KEY_HERE"
      }
    }
  }
}

Com uma chave de API configurada, nenhum navegador abre na primeira conexão; a chave autentica na hora. Para rotacionar, gere uma nova chave nas configurações e troque o valor na sua configuração.

Cuidado

Trate a chave como uma senha. Não a envie para o controle de versão; mantenha as chaves de API fora de arquivos mcp.json que vão para o repositório. Use a substituição por variável de ambiente onde seu cliente suportar, ou restrinja a configuração a um arquivo no nível do usuário (não do projeto).

Solução de problemas

• O cliente não vê o Engram depois da edição. Reinicie o cliente por completo, não só a janela.
• O navegador nunca abre para autenticar. Verifique se nenhum bloqueador de pop-up está atrapalhando; alguns clientes passam a janela do OAuth por uma lógica própria de navegador, que falha em silêncio se for bloqueada.
• Failed to connect. Confira se a URL está acessível. Veja Solução de problemas para problemas comuns a todos os clientes.

Para os fluxos pela interface de cada cliente, veja Integrações de IA.