Conecte o Engram à sua IA
O Engram é um servidor MCP remoto. Todos os clientes abaixo se conectam à mesma URL, fazem seu login com OAuth e depois leem e escrevem as notas do seu cofre. Nada para instalar, e o Obsidian não precisa estar aberto.
https://mcp.engram.pageO servidor fala Streamable HTTP e autentica com OAuth 2.1. Os clientes se registram sozinhos, então você nunca copia um ID de cliente ou segredo.
Antes de começar
Seção intitulada “Antes de começar”Antes de começar, confirme:
- Você tem uma conta do Engram em app.engram.page.
- Pelo menos um cofre está sincronizado. Abra o plugin do Obsidian ou o app web e confirme que as notas foram sincronizadas no último dia.
- Você consegue entrar pelo navegador. O fluxo de autenticação do MCP abre uma janela do navegador.
- Se você pretende usar uma chave de API em vez do OAuth: chaves de API exigem o Pro. O login por OAuth funciona em todos os planos, inclusive o Free, e é o caminho recomendado. Free e Starter não podem criar nem usar chaves de API.
Claude (web e desktop)
Seção intitulada “Claude (web e desktop)”- Abra claude.ai/customize/connectors. As configurações feitas ali valem tanto para o claude.ai quanto para o app desktop.
- Clique em + e depois em Add custom connector.
- Informe
Engramcomo nome ehttps://mcp.engram.pagecomo URL do servidor MCP remoto. Deixe Advanced settings vazio. - Clique em Add, depois em Connect, e aprove a janela de login.
O plano Free do Claude permite um conector personalizado. Passo a passo completo: Claude Desktop.
ChatGPT
Seção intitulada “ChatGPT”Os conectores personalizados ficam atrás do Developer mode do ChatGPT, no app web, em planos pagos elegíveis. Em um workspace Business ou Enterprise, um administrador precisa liberá-lo antes.
- Vá em Settings → Apps → Advanced settings e ative o Developer mode.
- De volta a Settings → Apps, clique em Create app.
- Dê o nome
Engram, defina a URL do servidor MCP comohttps://mcp.engram.pagee escolha OAuth como autenticação. - Clique em Scan Tools e espere terminar.
- Clique em Create e aprove a janela de login.
- Em um chat, escolha Engram no menu de ferramentas do campo de mensagem.
Em um workspace Business, o app fica em Workspace settings → Apps → Drafts até que um administrador o publique.
Passo a passo completo: ChatGPT.
O Grok não tem uma listagem do Engram no diretório de conectores. Você o adiciona como conector personalizado, por URL.
- Abra grok.com/connectors.
- Clique em New Connector e depois em Custom.
- Cole
https://mcp.engram.pagee conclua o login.
Está desenvolvendo com a API da xAI em vez do app do Grok? Veja Grok (xAI API).
Adicione o Engram ao ~/.cursor/mcp.json (todos os projetos) ou ao
.cursor/mcp.json (um projeto):
{ "mcpServers": { "engram": { "url": "https://mcp.engram.page" } }}Feche o Cursor por completo e abra de novo. A janela de login abre na primeira vez que o agente chama uma ferramenta do Engram. Passo a passo completo: Cursor.
VS Code
Seção intitulada “VS Code”O VS Code lê servidores MCP no modo Agent do Copilot Chat. Execute
MCP: Add Server na Command Palette, ou adicione isto ao
.vscode/mcp.json:
{ "servers": { "engram": { "type": "http", "url": "https://mcp.engram.page" } }}Clique no code-lens Auth acima da entrada engram para entrar.
Passo a passo completo: GitHub Copilot.
Claude Code
Seção intitulada “Claude Code”claude mcp add --transport http engram https://mcp.engram.pageReinicie o claude, execute /mcp, escolha engram e selecione
Authenticate. Adicione --scope user para deixar o Engram
disponível em todos os projetos. Passo a passo completo:
Claude Code.
Qualquer cliente MCP
Seção intitulada “Qualquer cliente MCP”Se seu cliente suporta servidores MCP remotos, informe a ele:
- URL:
https://mcp.engram.page - Transporte: Streamable HTTP
- Autenticação: OAuth. O Engram publica os metadados do seu servidor de autorização e aceita Dynamic Client Registration, então um cliente compatível não precisa de mais nada.
Um cliente que não consegue fazer o login pelo navegador pode enviar
uma chave de API do Engram como cabeçalho Bearer. Chaves de API
exigem o Pro. Os formatos de configuração para ambos estão em
Configuração do MCP.
Primeiro login
Seção intitulada “Primeiro login”Na primeira vez que você conecta, o cliente abre uma janela do navegador pedindo que você entre no Engram. Entre, marque as permissões que quer conceder e clique em Approve. O navegador devolve você a o cliente automaticamente. Sem copiar e colar tokens, sem variáveis de ambiente. É o mesmo tipo de fluxo de login que você usaria para conectar qualquer app ao Google, ao Dropbox ou ao GitHub.
Se preferir pular o fluxo do navegador (configurações headless, com scripts ou de cofre compartilhado), você pode autenticar com uma chave de API. Veja Configuração do MCP → Autenticação por chave de API.
Confirme que funciona
Seção intitulada “Confirme que funciona”Pergunte à sua IA algo que só as suas notas podem responder, por exemplo:
Que valor eu defini para
POOL_SIZEnas minhas notas de deploy?
Se ela responder a partir do seu cofre, você está conectado. Se não, veja Solução de problemas.
Desconectar
Seção intitulada “Desconectar”Remova o conector no seu cliente de IA e depois revogue a sessão dele em app.engram.page/settings/connections.