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 にログインし、サブスクリプションが問題なく有効か確認してください。
オンボーディングが完了していない。 保管庫のエンドポイント (MCP を含む) を使うには、利用規約への同意が必要です。
OAuth 中にレート制限された。 1 分ほど待ってから、もう一度試してください。

Claude がノートを見つけられない

Obsidian から保管庫が実際に同期されているか確認してください。同期センターと app.engram.page で確認できます。
OAuth トークンに mcp スコープが実際に含まれているか確認してください。初回インストール時に認可をスキップした場合は、コネクターを追加し直してください。
もっと具体的なクエリを試してください。セマンティック検索は上位 K 件を返すため、大きな保管庫に漠然としたクエリを投げても、期待したものが出てこないことがあります。

“Token expired”

OAuth トークンの有効期間には限りがあります。ほとんどのクライアントは更新を自動で処理するので、もう一度操作してみてください。それでも失敗する場合は、コネクターを削除して追加し直してください。

さらに情報を探すには

サーバー側のログ: セルフホストの場合はセルフホストを参照
クライアント側のログ: Claude Desktop → Help → Open developer console
問題の報告は engram-app/engram へ