Azure API CenterをMCPレジストリとして利用する際のレジストリエンドポイントURLにアクセスすると404 Not Foundとなる。

@中川夢斗 さん、こんにちは。

Microsoft Q&A にお問い合わせいただきありがとうございます。 この問題は、Azure API Center のベース エンドポイントと MCP レジストリ エンドポイントが異なる目的で使用されているために発生します。「API Center Data API が稼働中です」という応答が表示されることで、データ プレーン エンドポイントにアクセスできることは確認できますが、MCP レジストリ エンドポイントが正しく構成されていること、または指定されたワークスペースに MCP サーバー アセットが存在することは確認できません。ワークスペース名が間違っている、ワークスペースに MCP サーバーが登録されていない、匿名アクセスが正しく構成されていない、または使用されている URL 形式が利用側のアプリケーションが想定している形式と一致しない場合、通常は 404 Not Found エラーが発生します。さらに、GitHub Copilot とブラウザによる直接アクセスでは、Azure API Center の MCP レジストリ URL の処理方法が異なるため、エンドポイントを手動で検証する際に混乱が生じる可能性があります。製品グループによる過去の調査では、レジストリ URL の構成が不正確または不完全な場合に MCP サーバーの検出が失敗するという同様の現象が確認されています。 この問題を解決するため、または回避策として、以下の点を参照してください。 1. ワークスペース名と存在を確認する URLで指定されているワークスペースが存在し、スペルが正しいことを確認してください。 プレーンテキスト1https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME/v0.1/serversShow more lines エンドポイントは、以下の場合に404​​ Not Foundを返す可能性があります。 ワークスペースが存在しない。 ワークスペース名が間違っている。 ワークスペースが正しく構成されていない。 2. ワークスペースにMCPサーバーが登録されていることを確認する 次の場所に移動します。 Azure API Center2→アセット3→MCPサーバー 1つ以上のMCPサーバーが登録され、クエリ対象のワークスペースに関連付けられていることを確認してください。MCPサーバーが登録されていない場合、レジストリエンドポイントは期待どおりの応答を返さない可能性があります。 3. 匿名アクセスが有効になっていることを確認する MCPレジストリ検出シナリオでは、匿名アクセスが有効になっていることを確認してください。 次の手順で操作してください。 API Center ポータル2→設定3→可視性4→匿名アクセスを許可 設定を有効にした後、必要に応じて変更を保存して公開してください。これにより、GitHub Copilot などの外部クライアントが認証なしでレジストリエンドポイントにアクセスできるようになります。 4. GitHub Copilot の正しい URL 形式を使用する GitHub Copilot Enterprise MCP レジストリ設定を構成する場合は、次の形式を使用してください。 https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME 次の形式は構成しないでください。 https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME/v0.1/servers GitHub Copilot は必要な MCP レジストリパスを自動的に追加します。/v0.1/servers を手動で追加すると、レジストリの検出に失敗する可能性があります。 5. MCP レジストリ エンドポイントを直接テストする GitHub Copilot とは独立してレジストリ エンドポイントを検証するには、次のエンドポイントを参照するか、リクエストを実行してください。 プレーンテキスト1 https://SERVICE-NAME.data.REGION.azure-apicenter.ms/workspaces/WORKSPACE-NAME/v0.1/servers 期待される応答: JSON1 {2 "servers": [...] 3} エンドポイントが 404 Not Found を返す場合は、GitHub Copilot の問題ではなく、ワークスペース、MCP サーバーの登録、または API Center の設定に問題があることを示しています。 6. 製品グループが特定した既知の回避策 以前調査したケースで、製品グループは、次のエンドポイントを使用することで VS Code での MCP サーバー検出の問題が解決したことを確認しました。 プレーンテキスト1 /workspaces/default/v0.1/servers この問題の原因は、レジストリ URL の設定が不完全だったためで、必要なワークスペースと MCP レジストリ サフィックスを追加することで解決しました。