Solução de problemas do MCP

Endpoints

https://mcp.engram.page

”Failed to connect”

• URL errada. O endpoint MCP fica em /api/mcp (veja os endpoints acima). O host sem caminho não é o endpoint MCP e retorna 404.
• TLS no self-host. O endpoint MCP precisa ser HTTPS. Os clientes rejeitam HTTP puro, conforme o OAuth 2.1.
• Backend inacessível. Confirme que você consegue acessar /api/health diretamente. Se isso falhar, o MCP não tem como funcionar.

”Authorization failed”

• Conta inativa. Entre em app.engram.page e confira se sua assinatura está em dia.
• Onboarding incompleto. O Engram exige a aceitação dos Termos antes que os endpoints do cofre (incluindo o MCP) possam ser usados.
• Limite de requisições durante o OAuth. Espere um minuto e tente de novo.

O Claude não encontra notas

• Confirme que o cofre realmente foi sincronizado a partir do Obsidian. Confira a Central de sincronização e app.engram.page.
• Confirme que o token OAuth realmente carrega o escopo mcp; adicione o Conector de novo se você pulou a autorização na primeira instalação.
• Tente uma consulta mais específica. A busca semântica retorna os top-K resultados, então consultas vagas em um cofre grande podem não trazer o que você espera.

”Token expired”

Os tokens OAuth têm vida útil limitada. A maioria dos clientes renova automaticamente; tente a operação de novo. Se a falha persistir, remova e adicione o Conector novamente.

Onde encontrar mais informações

• Logs do servidor: para self-host, veja Self-Host
• Logs do cliente: Claude Desktop → Help → Open developer console
• Abra issues em engram-app/engram