クロード コード MCP ログ: 最初に失敗した境界を見つける

クロード コード MCP ログ を探している場合は、解決されたサーバーの状態から始めて、インシデント スコープのデバッグ ファイルを 1 つキャプチャします。 Claude Desktop のログ ディレクトリを追跡することから始めないでください。現在の MCP ドキュメントでは、特に Desktop 用のファイル システム パスにラベルが付けられていますが、Claude Code では、 /mcp 、 claude mcp list 、 claude debug mcp 、および debug file がドキュメント化されています。 有益な結果は「ログを見つける」ことではありません。これは、構成、プロジェクトの承認、プロセスの起動、ツールの検出、ツールの実行、またはツールが生成するはずだった外部結果など、最初に失敗した境界を特定することです。ログは 1 つの境界を説明できます。 6つすべてを証明することはできません。 このガイドでは、現在のクロード コード ドキュメントと、2026 年 7 月 30 日に確認された npm リリース 2.1.220 を使用します。MCP の動作と診断はまだ変更されているため、すべてのインシデントにインストールされているバージョンをピン留めしてください。 生の出力を読み取る前に解決された状態を検査する 問題が発生したのと同じ作業ディレクトリおよびユーザー アカウントから次のチェックを実行します。 影響を受けるクロード コード セッション内で、次を実行します。 公式構成デバッグガイド には、 /mcp に、構成されたサーバー、接続ステータス、プロジェクトの承認が表示されると記載されています。 MCP リファレンス は、重要な 2 つの操作詳細を追加します。 プロジェクト スコープの .mcp.json サーバーは、ワークスペースが信頼され、サーバーが承認されるまで保留状態のままにすることができます。 接続されたサーバーはツールを公開しない可能性があり、 /mcp はその数を報告します。 これらの事実により、次の 3 つのクラスのブラインド ログ検索が排除されます。 解決された証拠 最初の決定 なぜログが最初ではないのか サーバーが存在しません CONFIG MISSING 診断するロードされたサーバー プロセスはまだありません。スコープと設定ソースを確認してください。 承認待ち APPROVAL WAIT これは正当な権限の境界であり、クラッシュではありません。インタラクティブにレビューして承認します。 接続に失敗しました MCP デバッグ証拠をキャプチャ コマンド、パス、環境、認証、またはトランスポートが失敗した可能性があります。 接続、ツールなし 再接続し、MCP デバッグ証拠をキャプチャします。起動は接続に十分成功しましたが、検出では使用可能なレジストリが生成されませんでした。 接続済み、ツールあり 1 つの制限された呼び出しを再現する 接続の健全性は、選択したツールやその外部効果については何も示しません。 ローカル stdio サーバーの場合、相対パスには特別な疑いが必要です。 Claude Code には、 command および args のパスが、 .mcp.json の場所からではなく、Claude Code が起動されたディレクトリから解決されることが記載されています。したがって、サーバーは、あるリポジトリで動作し、同じ構成テキストを使用して別のリポジトリで動作しなくなる可能性があります。 スコープ付きクロード コード MCP デバッグ ファイルをキャプチャする 現在の クロードコード CLI リファレンス には、2 つの関連フラグが記載されています。 debug はデバッグ モードを有効にし、 mcp などのカテゴリ フィルターを受け入れます。 debug file <path は、デバッグ出力を明示的なパスに書き込み、暗黙的にデバッグ モードを有効にします。 プライベート インシデント ディレクトリを作成し、MCP デバッグ カテゴリのみを使用して新しいセッションを開始し、1 つの限定された症状を再現します。 そのセッション内で、 /mcp を調べます。サーバーがツールなしで接続されている場合は、 再接続 アクションを 1 回使用してください。ツールが存在する場合は、問題を再現する最小の読み取り専用ツールのみを呼び出します。ログをより興味深いものにするためだけに、書き込み可能な呼び出しを再試行しないでください。 デバッグ ファイルを機密ファイルとして扱います。これには、絶対パス、サーバー名、環境の詳細、リクエストのメタデータ、サーバーの標準エラー出力が含まれる場合があります。派生した証拠をインシデント受領書に記録し、セキュリティ ポリシーに従って生ファイルを保持または削除します。アクセス トークン、プロンプト本文、ツール引数、結果、または標準エラー テキストがファイルに含まれているからといって、それらを監視システムにコピーしないでください。 公開されている MCP サーバーごとのログ ファイルに対するクロード コード機能のリクエスト は、ユーザーがクロード コード用のデスクトップ スタイルの永続ファイルを必要としていると報告しています。この問題は有用な境界証拠であり、製品保証ではありません。サポートされるインシデント手順は、想定されるデフォルトのサーバーごとのパスではなく、文書化された明示的なデバッグ ファイルに依存する必要があります。 トランスポートへの証拠パスを照合する プロトコル リビジョンの MCP デバッグ ガイド 2026 07 28 は、重要なトランスポート境界を描きます。 ローカル stdio サーバーの場合、stdout はプロトコル メッセージを伝送します。サーバー診断は標準エラー出力に属します。診断テキストを標準出力に書き込むと、プロトコル ストリームが破損する可能性があります。 Claude Code のトラブルシューティング ガイドでは、接続されたサーバーがツールを公開しない場合に claude debug mcp を特に推奨しています。これにより、デバッグ証拠でサーバーの stderr が利用可能になるためです。 ストリーミング可能な HTTP の場合、クライアントはリモート サーバー プロセスの標準エラー出力をキャプチャできません。クロード コードのデバッグ ファイルはクライアント側の接続とリクエストの動作を表示できますが、サーバーの内部障害にはサーバー側のログまたは OpenTelemetry と HTTP レベルの検査が必要です。空のクライアント デバッグ セグメントは、リモート サービスが何もしなかったことを証明するものではありません。 この区別により、よくある誤った結論が防止されます。 輸送を領収書に記録します。これがなければ、「標準エラー出力なし」は曖昧になります。 コンテンツを最小限に抑えたインシデント受領書を作成する 生のログは調査の証拠となります。領収書は永続的な健康記録です。コンテンツを保存しなくても引き続き使用できます。 分類子の優先順位を明示的に保ちます。 I replayed that rule against eight synthetic cases.構成の欠落、承認待ち、キャプチャされた起動失敗、接続されたゼロツール、ツールエラー、結果のない成功したツール応答、検証された結果、およびデバッグ証拠が不十分な失敗した接続を正しく分離しました。予想される 8 つの州すべてが合格しました。 最後の 2 つのケースが重要な境界です。 A JSON RPC success or non error tool result is activity evidence. If the task promised a created issue, changed record, delivered file, or updated destination, verify that destination separately. Without that receipt, the correct state is OUTCOME UNVERIFIED , not healthy. 最小の安全な次のアクションを選択してください 各状態は 1 つの制限された応答につながる必要があります。 CONFIG MISSING : 設定スコープとロードされた正確なファイル クロード コードを検査します。サーバーコードを変更しないでください。 APPROVAL WAIT : 承認を責任者にルーティングします。待機をクラッシュと表現しないでください。 STARTUP FAILED : スコープ付きデバッグ証拠の最初の具体的な起動原因を修復し、一度再接続します。 DISCOVERY EMPTY : 初期化とツールリストの証拠を比較します。必要に応じて、MCP Inspector を使用してサーバーを個別にテストします。 TOOL CALL FAILED : リクエストの ID を保持し、再試行が安全かどうかを識別し、不確実な書き込みの再実行を回避します。 OUTCOME UNVERIFIED : 安定した識別子で宛先をクエリします。効果がすでに発生しているかどうかがわかるまで、ツールを再実行しないでください。 UNCERTAIN : 不足している境界証拠を収集するか、エスカレーションします。不明は動作状態であり、推測を促すものではありません。 HEALTHY : 使用可能な MCP チェーンと新鮮で確定的な結果の受信の両方が必要です。 ログによって障害が説明可能になります。解決済みステータスにより、場所を特定できるようになります。宛先の領収書により、回復が検証可能になります。これらのジョブを分離しておくと、Claude Code MCP インシデントは、リスクが高まる一連の再試行ではなく、短い証拠演習になります。 Sidewisp は、つながり、有益な進歩、ツール、成果の間の健康第一の区別を中心に設計されています。 Sidewisp は現在プライベートプレビュー段階です。 運用監視アダプタとリカバリ エグゼキュータは通常、出荷されません。