Pular para o conteúdo

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.page

O 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, 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.
  1. Abra claude.ai/customize/connectors. As configurações feitas ali valem tanto para o claude.ai quanto para o app desktop.
  2. Clique em + e depois em Add custom connector.
  3. Informe Engram como nome e https://mcp.engram.page como URL do servidor MCP remoto. Deixe Advanced settings vazio.
  4. 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.

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.

  1. Vá em Settings → Apps → Advanced settings e ative o Developer mode.
  2. De volta a Settings → Apps, clique em Create app.
  3. Dê o nome Engram, defina a URL do servidor MCP como https://mcp.engram.page e escolha OAuth como autenticação.
  4. Clique em Scan Tools e espere terminar.
  5. Clique em Create e aprove a janela de login.
  6. 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.

  1. Abra grok.com/connectors.
  2. Clique em New Connector e depois em Custom.
  3. Cole https://mcp.engram.page e 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.

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 mcp add --transport http engram https://mcp.engram.page

Reinicie 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.

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.

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.

Pergunte à sua IA algo que só as suas notas podem responder, por exemplo:

Que valor eu defini para POOL_SIZE nas minhas notas de deploy?

Se ela responder a partir do seu cofre, você está conectado. Se não, veja Solução de problemas.

Remova o conector no seu cliente de IA e depois revogue a sessão dele em app.engram.page/settings/connections.