Claude Desktop

A interface de Connectors do Claude Desktop é o caminho mais suave para conectar o Engram. É um fluxo de colar a URL e entrar, sem arquivos de configuração e sem chaves de API para copiar. Para entender o que acontece por baixo, veja MCP.

Pré-requisitos

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.

Configuração

1. Abra a página Add Engram connector. Ela inicia a configuração de conectores do Claude com o nome e a URL do Engram já preenchidos. Essas configurações valem tanto para o app desktop quanto para o claude.ai.

   Prefere fazer manualmente? Vá em claude.ai/customize/connectors e clique no botão + para adicionar um conector personalizado.

2. Preencha os dois campos e clique em Add. Ambos já vêm preenchidos se você abriu o modal pelo link acima; caso contrário, informe você mesmo.

   Name: qualquer nome que quiser, por exemplo:

   Engram

   Remote MCP server URL:

   https://mcp.engram.page

3. Uma janela de autorização do navegador abre. Veja Primeira autenticação para saber o que esperar.

4. Revise as permissões solicitadas na tela de escopo e aprove.

5. Diga ao Claude como usá-lo para que ele recorra ao Engram automaticamente.

6. Experimente para confirmar que o conector funciona.

Primeira autenticação

Na primeira vez que você conecta, Claude Desktop abre automaticamente 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 Claude Desktop 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.

Diga ao Claude como usá-lo

Adicionar o conector é só metade do trabalho. O Claude não vai recorrer ao Engram a menos que você diga para ele fazer isso. Coloque uma instrução curta nas preferências globais do Claude, para que toda conversa saiba usar o Engram como memória.

1. Abra claude.ai/settings/general.
2. Encontre o campo What personal preferences should Claude consider in responses? (a caixa de instruções globais).
3. Cole este trecho. Mantenha-o em uma linha própria, para que continue valendo em todas as conversas:

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.

Agora o Claude recorre ao Engram automaticamente quando precisa consultar ou salvar algo que você compartilhou.

Experimente

Com tudo conectado e o prompt global no lugar, o conector aparece na sua barra lateral. Tente perguntar:

• Pesquise no meu cofre as notas sobre o processo de entrevistas de engenharia e resuma as três principais.
• Encontre tudo o que escrevi sobre embeddings no último mês.
• Leia minha nota chamada 'Planejamento do T3' e extraia os itens de ação.
• Mostre o frontmatter e os links de saída de 'ideias-de-projetos.md'.
• Escreva uma nota nova chamada 'Reunião com o design, 21 de maio' na minha pasta 'Notas de reunião' com os pontos principais de hoje.
• Acrescente uma seção 'Decisões' em 'roadmap.md' com estes três itens.
• Liste as pastas de nível superior do meu cofre.
• Mova tudo o que está em 'inbox' e menciona 'Q4' para 'Planejamento-Q4'.

O Claude chama a ferramenta search do Engram (ou get_note, write_note etc.), traz os resultados e responde no contexto.

Escopos concedidos

O Claude Desktop solicita o escopo mcp na tela de aprovação. É uma única concessão que cobre toda a superfície de ferramentas MCP no seu cofre. Escopos granulares por ação (somente leitura, sem exclusão etc.) estão no roteiro. Veja Escopos para os detalhes e o fluxo de revogação.

Solução de problemas (específico do Claude Desktop)

• A janela de autorização nunca abre. Confirme que o Claude Desktop está na versão mais recente e que nenhum bloqueador de pop-up está ativo.
• “Connector failed to load.” Confirme que a URL do MCP está acessível. Cole-a em uma aba do navegador. Se você vir uma página de resposta estruturada em vez de um erro, a conexão está boa e o problema é do lado do Claude Desktop. Reinicie-o e tente de novo.

Para falhas comuns a todos os clientes (autenticação recusada, erros de escopo, lacunas de sincronização), veja Solução de problemas.

Revogação

A desconexão vale a partir de qualquer um dos lados. Escolha o que for mais prático:

Pelo app do Claude: abra Settings → Connectors, encontre o Engram e escolha Disconnect.

Pelo Claude na web: vá em claude.ai/customize/connectors, clique no conector do Engram e escolha Disconnect.

Pelo Engram: vá em app.engram.page/settings/connections e desconecte a sessão.

De qualquer forma, o token OAuth é invalidado no servidor, e o Claude Desktop precisará se autenticar de novo para reconectar.

Próximos passos

MCPVisão geral do protocolo.

EscoposEscolha o mínimo de permissões.

Todas as integraçõesEscolha outro cliente.