MCP 故障排除
https://mcp.engram.pageFailed to connect
Section titled “Failed to connect”- URL错误。 MCP 接口位于
/api/mcp(请参阅上方的接口)。仅有主机名(没有路径)不是 MCP 接口,会返回 404 错误。 - 支持自托管 TLS。 MCP 端点必须使用 HTTPS。客户端会拒绝不使用 HTTPS 的连接,符合 OAuth 2.1 标准。
- 后端无法访问。 请确认可以直接访问
/api/health。如果失败,MCP 无法正常工作。
Authorization failed
Section titled “Authorization failed”- 账户未激活。 登录
app.engram.page检查你的订阅状态。 - 注册未完成。 在
app.engram.page完成设置(包括条款,以及部分用户需要进行的仓库配置)。403 错误页面包含你缺失的步骤链接。 - OAuth 期间可能受速率限制。 请稍等片刻后重试。
Claude 找不到任何笔记
Section titled “Claude 找不到任何笔记”- 确认仓库已从 Obsidian 同步。检查同步中心和
app.engram.page。 - 确认 OAuth 令牌包含
mcp权限;如果首次安装时跳过了授权,请重新添加连接器。 - 尝试更具体的搜索。语义搜索返回前K个结果,因此对大型仓库使用模糊查询可能无法找到你想要的内容。
Token expired
Section titled “Token expired”OAuth 令牌有有效期。大多数客户端会自动刷新;请重试该操作。如果问题仍然存在,请删除并重新添加连接器。
Codex 无法访问 Engram
Section titled “Codex 无法访问 Engram”Codex 0.163 及更早版本可能会反复尝试无效的登录,或者丢失登录信息,而不是要求你重新登录(相关问题 openai/codex#48507 和 openai/codex#39054,均未解决)。Codex 0.164.0 会停止重试失败的登录,所以请先更新 Codex。
如果 Engram 工具仍然无法正常工作,请重新连接。使用你在添加服务器时设置的名称运行以下命令:
codex mcp login engram查找更多信息的地方
Section titled “查找更多信息的地方”- 服务器端日志:对于自托管,请参阅 自托管
- 客户端日志:Claude 桌面 → 帮助 → 打开开发者控制台
- 报告问题请访问 engram-app/engram