Pular para o conteúdo

MCP solução de problemas

https://mcp.engram.page
  • 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/health diretamente. Se isso falhar, MCP não poderá funcionar.
  • Conta não ativa. Faça login em app.engram.page e 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.
  • 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.

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.

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:

Janela do terminal
codex mcp login engram
  • 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