コンテンツにスキップ

MCP トラブルシューティング

https://mcp.engram.page
  • URLが間違っています。 MCPエンドポイントは/api/mcpにあります(上記エンドポイントを参照)。ホスト名のみ(パスなし)ではMCPエンドポイントにアクセスできず、404エラーが表示されます。
  • セルフホスト環境でのTLS設定。 MCPエンドポイントはHTTPSでなければなりません。OAuth 2.1の仕様により、HTTPはクライアントによって拒否されます。
  • バックエンドに接続できません。 /api/health に直接アクセスできるか確認してください。もしそれが失敗した場合、MCP は正常に動作しません。
  • アカウントが有効になっていません。 app.engram.page にログインして、サブスクリプションが有効であることを確認してください。
  • 初期設定が完了していません。 app.engram.page で設定を完了してください (利用規約と、一部のユーザーの場合は保管庫の設定)。403 エラーには、不足しているステップへのリンクが含まれています。
  • OAuth 認証中にレート制限が発生しました。 しばらく待ってから再試行してください。

Claude はノートを見つけられませんでした

Section titled “Claude はノートを見つけられませんでした”
  • 保管庫が Obsidian から実際に同期されているか確認してください。同期センターと app.engram.page を確認してください。
  • OAuth トークンに実際に mcp スコープが含まれているか確認してください。最初のインストール時に認証をスキップした場合は、コネクタを削除して再追加してください。
  • より具体的な検索語句を試してください。意味検索は上位 K 件を返すため、大規模な保管庫に対するあいまいな検索では、期待する結果が得られない場合があります。

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 で報告してください