MCP solução de problemas
Pontos de extremidade
Seção intitulada “Pontos de extremidade”https://mcp.engram.pageFailed to connect
Seção intitulada “Failed to connect”- URL incorreta. O endpoint MCP está localizado em
/api/mcp(veja endpoints acima). O host sem caminho não é o endpoint MCP e retornará 404. - TLS para hospedagem própria. O endpoint MCP deve ser HTTPS. HTTP simples é rejeitado pelos clientes de acordo com o OAuth 2.1.
- Servidor não acessível. Verifique se você consegue acessar
/api/healthdiretamente. Se isso falhar, MCP não poderá funcionar.
Authorization failed
Seção intitulada “Authorization failed”- Conta não ativa. Faça login em
app.engram.pagee verifique se sua assinatura está em dia. - Configuração não concluída. Finalize a configuração em
app.engram.page(os Termos, e a etapa do cofre para alguns cadastros). O erro 403 inclui um link para a etapa que você está faltando. - Limite de requisições atingido durante o OAuth. Aguarde um minuto e tente novamente.
Claude não encontrou nenhuma nota
Seção intitulada “Claude não encontrou nenhuma nota”- Confirme se o cofre foi realmente sincronizado com Obsidian. Verifique a Central de sincronização e
app.engram.page. - Confirme se o token OAuth realmente possui o escopo
mcp; adicione o Conector novamente se você pulou a autorização na primeira instalação. - Tente uma consulta mais específica. A pesquisa semântica retorna os top-K, então consultas vagas em um cofre grande podem não mostrar o que você espera.
Token expired
Seção intitulada “Token expired”Os tokens OAuth têm um tempo de vida limitado. A maioria dos clientes lida com a atualização automaticamente; tente a operação novamente. Se a falha persistir, remova e adicione o Conector novamente.
Codex perde o acesso a Engram
Seção intitulada “Codex perde o acesso a Engram”Versões 0.163 e anteriores do Codex podem continuar tentando fazer login em uma conta que não é mais válida, ou podem perder as informações de login, em vez de solicitar que você faça login novamente (problemas relatados openai/codex#48507 e openai/codex#39054, ambos ainda abertos). A versão 0.164.0 do Codex para de tentar fazer login em uma conta rejeitada, então atualize o Codex primeiro.
Se as ferramentas Engram ainda falharem, reconecte. Execute este comando, usando o nome que você deu ao servidor quando o adicionou:
codex mcp login engramOnde encontrar mais informações
Seção intitulada “Onde encontrar mais informações”- Logs do servidor: para hospedagem própria, veja Hospedagem própria
- Logs do cliente: Claude Desktop → Ajuda → Abrir o console do desenvolvedor
- Reporte problemas em engram-app/engram