MCP トラブルシューティング
エンドポイント
Section titled “エンドポイント”https://mcp.engram.pageFailed to connect
Section titled “Failed to connect”- URLが間違っています。 MCPエンドポイントは
/api/mcpにあります(上記エンドポイントを参照)。ホスト名のみ(パスなし)ではMCPエンドポイントにアクセスできず、404エラーが表示されます。 - セルフホスト環境でのTLS設定。 MCPエンドポイントはHTTPSでなければなりません。OAuth 2.1の仕様により、HTTPはクライアントによって拒否されます。
- バックエンドに接続できません。
/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 以前のバージョンでは、有効期限が切れたサインインを繰り返し試行したり、サインイン情報を失ったりすることがあります (関連 issue: openai/codex#48507 および openai/codex#39054, いずれも未解決)。Codex 0.164.0 では、拒否されたサインインの再試行が停止されるため、まず Codex をアップデートしてください。
Engram ツールがまだ失敗する場合は、再接続してください。サーバーを追加したときに指定した名前を使用して、次のコマンドを実行してください。
codex mcp login engramより詳しい情報を確認できる場所
Section titled “より詳しい情報を確認できる場所”- サーバー側のログ: セルフホストの場合は、セルフホスト を参照してください
- クライアント側のログ: Claude デスクトップ → ヘルプ → 開発者コンソールを開く
- 問題は engram-app/engram で報告してください