troubleshooting · MCP
MCPツールがChatGPTに表示されないときの確認ポイント
MCPツールがChatGPTに表示されない原因を、アプリ設定・Tool discovery・Server接続・OAuth認証・利用権限に分けて解説します。
症状
ChatGPTにMCP対応アプリを接続したのに、ツールが表示されない、または呼び出されないことがあります。
まず、3つの状態を区別します。
- アプリ自体が見つからない：アプリ一覧や選択画面に対象アプリが出ない。
- アプリはあるが、必要な操作が見つからない：Toolスキャンや権限設定で対象操作が利用可能になっていない。
- 操作は利用可能だが、AIが使わない／実行時に失敗する：会話条件、実行権限、Serverの状態などを確認する必要がある。
すべてを「MCPの接続不良」と判断しないことが解決への近道です。
確認基準日：2026年10月10日。ChatGPTの画面名称や提供機能は、プラン・ワークスペース・提供状況により変わる場合があります。
まず確認すること
一般の利用者なら次の順序で確認してください。
- 利用する画面・アカウントを確認する。 カスタムMCPアプリの利用可否はプランやワークスペース設定に左右されます。公式ヘルプではMCPアプリの対応環境としてWebが案内されています。
- アプリが利用可能か確認する。 ChatGPTのアプリ一覧、またはワークスペースの承認済みアプリを確認します。
- 接続・認可を完了する。 アプリがユーザーごとの接続を要求する場合、接続状態を確認します。
- 新しい会話でアプリを明示的に選ぶ。 アプリ選択やメンションから対象アプリを指定して試します。
- 具体的な操作を依頼する。 たとえば「このアプリで利用可能な文書を検索して」と伝えます。「何ができる？」だけでは実行確認になりません。
UIが異なる場合は、公式ヘルプの最新手順を優先してください。
主な原因
主な原因1：アプリが作成・有効化・公開されていない
開発者モードで作成した下書きと、ワークスペース全体に公開されたアプリは異なります。管理者の承認が必要な環境では、作成しただけでは他の利用者が使えません。
確認方法： アプリが下書きか公開済みか、自分のアカウントに利用権限があるかを確認します。
主な原因2：Toolスキャンが完了していない
カスタムMCPアプリの作成時、接続先MCP Serverから利用できるToolを取得します。公式手順ではエンドポイントを設定し、必要な認証を済ませてから「ツールをスキャン（Scan Tools）」の完了を待ちます。
確認方法： スキャン結果に期待するToolがあるか、途中で認証画面や通信エラーが起きていないか確認します。
主な原因3：MCP Serverの接続先が誤っている、または応答しない
登録URLの誤りやServerの停止によりToolを取得できない場合があります。
確認方法： エンドポイントURL、Serverの稼働状態、接続経路を確認します。トップページがHTTP 200を返すだけでは、MCPの要求が正常に処理される証拠にはなりません。
主な原因4：OAuth認証や接続権限で止まっている
未認証、期限切れ、認可失敗、必要な権限不足などが原因となり得ます。
確認方法： ユーザーは接続状態を確認します。開発者は認証エラーとTool取得失敗を分けて調べます。
注意： アクセストークン、Client Secret、認証コードなどを公開の問い合わせやスクリーンショットへ貼らないでください。
主な原因5：Serverに追加したToolがChatGPT側へ反映されていない
MCP Serverへ新しいToolを追加しても、公開済みのChatGPTアプリへ自動反映されるとは限りません。ワークスペース管理者による更新・再確認が必要になる場合があります。
確認方法： Serverの最新Tool一覧と、ChatGPT側で承認された操作一覧を比較します。
主な原因6：Toolは利用可能だがAIが選んでいない
ServerにToolがあっても、AIが必ず呼び出すわけではありません。依頼内容やアプリの選択状態が関係します。
確認方法： 新しい会話で対象アプリを選択し、Toolの用途が明確になる具体的な依頼を試します。Toolの存在と実行結果を分けて判断します。
切り分け手順
開発者は接続先の稼働、MCP応答、Tool discovery、認証、ChatGPT側の公開設定、実行結果の順で調べます。
解決方法
- Serverの正常性： 意図したエンドポイントで稼働しているか確認します。
- MCPとしての応答： HTTP疎通だけでなく、対応仕様に基づくMCP要求へ正常に応答するか確認します。
- Tool discovery： Serverが意図したToolを提供しているか確認します。2026年7月版では旧来の初期化・セッションを前提としない方式や
server/discoverが導入されています。tools/listなども対応仕様に合わせて確認します。 - 認証前後の境界： 未認証、認可後、権限不足の応答を区別します。認証を要求すること自体は異常ではありません。
- ChatGPT側の設定： Serverで確認できたToolが、ChatGPT側のスキャン・公開・アクション制御でも使えるか調べます。
- 実行結果： 具体的なToolを呼び出し、結果まで返るか確認します。Tool一覧に表示された時点では動作確認は完了していません。
症状別の対応
| 症状 | まず確認するもの | 主な対応 |
|---|---|---|
| アプリが見つからない | プラン、権限、公開状態 | 利用権限・公開設定を確認 |
| スキャンでToolが取得できない | URL、Server稼働、認証 | 接続と認証を個別に検証 |
| 新しいToolだけ出ない | 保存済みツール定義 | 管理者によるツール更新を確認 |
| 認証を繰り返す | 認可状態、期限、設定 | 接続状態とエラーを確認 |
| Toolが使われない | アプリ選択、依頼、Tool説明 | 対象アプリを選び具体的に依頼 |
| Toolを呼ぶと失敗する | 実行権限、入力、対象環境 | エラーログと実行条件を確認 |
「表示されない」「呼ばれない」「実行できない」を分けるだけで、調査範囲を絞れます。
OGINAUの実装・検証から分かったこと
OGINAUでは、OGINAU RemoteやOGINAU Browserの開発でChatGPTと外部環境の接続を検証しています。重要だったのは、ToolがChatGPTに認識される段階と、利用者が許可された処理を実行できる段階を分けて検証することです。
Tool一覧の取得が成功しても、認証・アクセス許可・接続先環境によって実行できない場合があります。実行失敗の原因が最初のTool discoveryにあるとも限りません。
そのため、接続、Tool認識、権限、実行結果の順番で確認します。個別製品の内部認証構成や制御ロジックは公開していません。
根拠・一次情報
-
OpenAI公式：ChatGPTのデベロッパーモードとMCPアプリ：アプリ作成、Scan Tools、公開・権限・更新。
-
OpenAI Developers：Troubleshooting：ServerやTool discoveryの不具合の切り分け。
-
MCP公式：2026年7月28日仕様の変更点：接続・機能発見・認可。
-
OGINAU Remote・OGINAU Browserの開発検証記録：Tool認識と実行結果を分けた検証。
画面表示や対応機能は変更されるため、利用時には最新の公式ヘルプも確認してください。
再発防止
MCP対応アプリを運用する際、Server変更後はToolの発見結果とChatGPT側の承認済み一覧を確認し、接続・認証・実行を分けてテストします。
新しいToolを追加したときは、接続済みだから反映されたはずと考えず、アプリ設定と実際の利用結果を確認してください。
MCPツールが見えないときは、ChatGPT側のアプリ状態、Server接続とTool discovery、認証・権限、そして実行結果の順番で確認することが効率的な問題解決につながります。