トラブルシューティング

2 分で読めます · カスタマーガイド

まずは、接続の追加、ツールの検出、ツールの実行、書き込みの検証など、失敗した段階を特定することから始めます。設定を変更する前に、時刻と簡単な説明を記録します。

接続に到達できません#

正確に割り当てられたエンドポイントと、AI クライアントがそのトランスポートおよび認証方法をサポートしているかどうかを確認してください。プラットフォームのホームアドレスは MCP エンドポイントではありません。通常の安全な接続を使用します。証明書の警告を回避しないでください。

同じ割り当てられた接続が以前に機能していた場合は、最後に成功したのはいつなのか、およびクライアントで何が変更されたのかを報告します。交換が確認される前に、動作中の接続の詳細を削除しないでください。

症状	何を確認するか
`401` 接続時または検出時	資格情報が欠落している、間違っている、期限切れ、または取り消されている。ヘッダーまたはエンドポイントが正しくありません。
`403` 手術のために	資格情報の範囲、ツールの権限、またはアップストリームのサービスの役割。どの層がそれを返したかを特定します。
`429`	リクエストの許容量を超えました。再試行の遅延を考慮し、リクエストの頻度を減らします。
`404`	エンドポイントまたは参照レコードが間違っているか、使用できない可能性があります。正確なパスとコンテキストを確認してください。
`5xx` または利用不可	プラットフォームまたは上流サービスの問題。キャプチャ時間とリクエストステージ。
無効な引数	必須フィールド、入力タイプ、サポートされていない追加フィールド、または識別子が一致しません。
接続されていますが、予期したツールがありません	割り当てられたスコープ、非アクティブまたは未検証の追加、または古いクライアントの検出。
ツールは表示されるが呼び出しは失敗する	上流の承認、アカウント資格、または操作固有の入力。

これらは診断の開始点です。 HTTP エラーの実際の原因は重要です。サービスの権限エラーは、MCP 認証を弱めても修正されません。

エンドポイントを確認し、ツールリストを更新し、ハンドオフと比較して、合意された読み取り専用テストを実行します。失敗した場合は、ツール名と編集されたエラーを記録します。結果が不確実な書き込みアクションを繰り返す前に停止してください。

を使用します。サポートチェックリスト。会話全体のエクスポートやキーを含む設定ではなく、機密情報が非表示になっているスクリーンショットまたは関連するエラーテキストを含めてください。