MCP 故障排查

端点

https://mcp.engram.page

”Failed to connect”

• URL 错误。 MCP 端点位于 /api/mcp（参见上方的端点）。 不带路径的裸主机名不是 MCP 端点，会返回 404。
• 自托管 TLS。 MCP 端点必须使用 HTTPS。按照 OAuth 2.1， 客户端会拒绝纯 HTTP。
• 后端无法访问。 确认你可以直接访问 /api/health。 如果这都不通，MCP 肯定无法工作。

“Authorization failed”

• 账号未激活。 登录 app.engram.page，检查你的订阅状态是否正常。
• 未完成引导流程。 Engram 要求先接受服务条款，才能使用知识库端点（包括 MCP）。
• OAuth 期间被限流。 等待一分钟后重试。

Claude 找不到笔记

• 确认知识库确实已从 Obsidian 同步。检查同步中心和 app.engram.page。
• 确认 OAuth 令牌确实带有 mcp 权限范围；如果首次安装时跳过了授权， 请重新添加连接器。
• 换一个更具体的查询。语义搜索只返回前 K 条结果， 所以在大型知识库上使用含糊的查询，可能搜不到你期望的内容。

“Token expired”

OAuth 令牌的有效期是有限的。大多数客户端会自动刷新，请再试一次操作。 如果仍然失败，请移除并重新添加连接器。

更多信息去哪里找

• 服务器端日志：自托管请参阅自托管
• 客户端日志：Claude Desktop → Help → Open developer console
• 问题请提交到 engram-app/engram