登録に関するトラブルシューティング

接続済みアプリの登録または構成中に問題が発生した場合は、次の表で一般的なエラー メッセージ、原因、トラブルシューティングの手順をご覧ください。

問題	エラー メッセージ	原因	解決 / トラブルシューティングの手順
「Fetch ツール」の未指定のエラー	「MCP サーバーの詳細を取得できませんでした。もう一度お試しください。」（または、特定のエラー メッセージなしで [Fetch tools] ボタンが失敗する）。	URL が無効であるか、サーバーがオフラインであるか、ネットワーク エラーが発生したため、Connected Console は MCP エンドポイントへのリクエストを完了できませんでした。	以下を確認します。 MCP エンドポイントの URL が正確で、https:// を使用していることを再度確認します。 MCP サーバーが実行されていることを確認します。 MCP サーバーが公共のインターネットからアクセス可能であることを確認します（Google は localhost やプライベート イントラネット アドレスにアクセスできません）。
MCP サーバーにアクセスできない	「MCP サーバーにアクセスできません」	Google のバックエンドが MCP エンドポイントへの接続を確立できませんでした。	一般的な原因と解決策は次のとおりです。 ファイアウォールの制限: ファイアウォールまたは WAF が Google のアウトバウンド IP 範囲をブロックしていないことを確認します。 API Gateway ルール: API Gateway が POST リクエストを受け入れ、MCP initialize handshake 中に Google の clientInfo を拒否しないことを確認します。 サブドメインの不一致: 専用のサブドメイン（gemini.mcp.company.com など）を使用する場合は、/.well-known/oauth-protected-resource メタデータが別のベースドメイン（mcp.company.com）を指すのではなく、そのサブドメインと一致していることを確認します。
サポートされていない MCP トランスポート（HTTP 405）	「MCP サーバーがリクエストを拒否しました（HTTP 405 Method Not Allowed エラー）。URL が、以前の SSE エンドポイントではなく、POST リクエストを受け入れる Streamable HTTP エンドポイントを指していることを確認してください。」	エンドポイント URL が、GET リクエストのみを受け入れるか、JSON-RPC POST リクエストを拒否する、以前の HTTP+SSE エンドポイントを指している。	initialize と tools/list の POST リクエストを受け入れる MCP Streamable HTTP トランスポートを使用するように、MCP サーバーとエンドポイント URL を更新します。
OAuth 保護リソース ファイルがありません	「MCP サーバーに /.well-known/oauth-protected-resource ファイルが存在しません」	Google が OAuth 2.0 Protected Resource Metadata の検出（RFC 9728）を試みましたが、失敗しました。	MCP サーバーで認証が不要な場合: このエラーは通常、MCP エンドポイント URL に入力ミスがあるか、パス セグメントが欠落している（例: https://mcp.example.com/mcp ではなく https://mcp.example.com）場合に発生します。この場合、HTTP 404 または 500 が返され、クライアントは OAuth 検出にフォールバックします。MCP エンドポイントの正確なパスが、認証されていない POST initialize リクエストと tools/list リクエストに対して HTTP 200 OK を返すことを確認し、[アクセス認証情報] の [サーバーで認可が必要ですか？] で [いいえ] を選択します。 MCP サーバーで認証が必要な場合: 信頼できる認可サーバーを authorization_servers 配列でアドバタイズする有効な /.well-known/oauth-protected-resource JSON ファイルを MCP サーバーでホストします。
OAuth 認可サーバーのメタデータがないか無効です	「/.well-known/oauth-authorization-server ファイルが OAuth サーバーに存在しません」または「無効または不完全な JSON が含まれています」	OAuth サーバーが /.well-known/oauth-authorization-server で有効な RFC 8414 メタデータ ドキュメントを公開していません。	authorization_endpoint と token_endpoint を含む有効な RFC 8414 ディスカバリ ドキュメントを /.well-known/oauth-authorization-server（または /.well-known/openid-configuration）でホストします。 または、[認証情報] セクションで、[カスタム認証エンドポイント] と [カスタム トークン エンドポイント] の URL を手動で入力します。
ドメインの所有権の確認に失敗する	[ドメイン証明書] に、ツールチップ メッセージ（HTTP 404、リダイレクトが許可されていない、トークンの不一致など）とともに [確認できませんでした] または [確認に失敗しました] と表示される。	https://<domain>/.well-known/google-connected-apps でチャレンジ トークンを確認できませんでした。	ファイルが見つからない（HTTP 404）: ダウンロードした google-connected-apps.json コンテンツが https://<domain>/.well-known/google-connected-apps で公開されていることを確認します（URL パスに .json 拡張子がないこと）。 リダイレクトは許可されません: HTTP 200 OK を使用して確認ペイロードを直接提供します。/.well-known/google-connected-apps を別の URL にリダイレクトしないでください。 トークンの不一致: JSON レスポンスに、デベロッパー アカウント用に生成されたトークンと完全に一致する "verification_tokens": ["<YOUR_TOKEN>"] が含まれていることを確認します。
動的クライアント登録（DCR）または CIMD の失敗	「動的クライアント登録（RFC 7591）に失敗しました」、「この OAuth サーバーは動的クライアント登録（RFC 7591）をサポートしていません」、「クライアント ID メタデータ ドキュメント（CIMD）の登録に失敗しました」	自動 OAuth クライアント登録が失敗したか、OAuth プロバイダでサポートされていないか、Google のリダイレクト URI が拒否されました。	OAuth サーバーが、[サーバー認証情報]（https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain> など）に表示されている 6 つのアプリ固有の Google リダイレクト URI をすべて許可リストに登録していることを確認します。多くの OAuth 2.1 サーバーは、ワイルドカード（*）リダイレクト URI を拒否します。 OAuth プロバイダが CIMD または RFC 7591 DCR をサポートしていない場合は、[アクセス認証情報] で [事前登録済み]（ユーザー委任 OAuth の場合）または [マシン間（OAuth クライアント認証情報）] を選択し、静的なクライアント ID とクライアント シークレットを指定します。
OAuth ログインのポップアップがブロックされる、または空白になる	「認証のポップアップがブラウザでブロックされました」というメッセージが表示される、またはツールの同期中やテスト中に OAuth ログイン ウィンドウが正しく表示されない。	ブラウザのポップアップ ブロッカーまたはログインページの厳格な X-Frame-Options / Content-Security-Policy ヘッダーにより、ポップアップ フローが妨げられた。	ブラウザでコンソールのポップアップを許可してから、もう一度お試しください。 [デベロッパーの認証情報を使用して認証する] の [アクセス認証情報] で、[ポップアップで認証する] から [リダイレクトで認証する（フォールバック）] に切り替えて、認証フローが同じタブに全画面表示で開くようにします。
MCP サーバーの指示がありません	警告メッセージ: 「MCP サーバーに指示が設定されていません。サーバー スキーマに指示を追加することをおすすめします。」	MCP サーバーが initialize レスポンスで instructions フィールドを返しませんでした。	MCP サーバーを初期化するときに、システム指示を明示的に定義します（サーバー定義の instructions パラメータ）。 ステートレスまたはカスタムの HTTP 実装の場合は、initialize メソッドの JSON-RPC レスポンス ペイロードに instructions フィールドが含まれていることを確認し、[ツールを再同期] を選択します。
UI リソースのサイズ制限またはサポートされていない MIME タイプ	取得に関する問題のエラーカード: 「リソースの合計サイズは 100 MB を超えることはできません」または「リソース '<uri>' の MIME タイプ '<type>' はサポートされていません」	MCP サーバーから返された UI リソースの合計サイズが上限を超えているか、サポートされていない MIME タイプが使用されています。	サーバーから返されるすべてのマニフェスト UI リソースの累積サイズを、上限を超えないように削減してください。 すべての UI リソースで、サポートされている MIME タイプ（text/html、text/html;profile=mcp-app、text/javascript、text/css のいずれか）が使用されていることを確認してください。
アイコンのアップロードが停止する、または「予期しないエラー」が発生する	[アプリの詳細] でアプリアイコンをアップロードすると、アップロードが読み込みスピナーでフリーズするか、「予期しないエラーが発生しました。もう一度お試しください」（多くの場合、コード 4E696748 が表示されます）。	通常は、古いブラウザ セッション、競合するブラウザ拡張機能、キャッシュに保存された認証状態が原因です。	次の手順を順番に試します。 新しいブラウザ プロファイルを使用する: 新しいブラウザ プロファイルを使用して新しいウィンドウを開きます。 シークレット モード / プライベート モードを使用する: プライベート ブラウジング ウィンドウで Google Connected Console にログインし、アイコンをアップロードします。 キャッシュを削除する: ブラウザのキャッシュと Cookie を削除してから再試行します。また、アイコンが 512 px × 512 px の有効な PNG または JPEG で、1 MB 未満であることを確認します。