Azure API Center で Azure Functions でホストされている MCP サーバーを登録する

MCP サーバーを Azure Functions でリモートでホストした後、Azure API Center に登録します。 Azure API Center では、リモート MCP サーバーのインベントリ (またはレジストリ) が保持されるため、組織全体で簡単に検出できます。 登録されているすべての MCP サーバーは、組織内のチームの API センター ポータルに表示されます。

ヒント

API センター名は、レジストリ フィルターのプライベート ツール カタログ名になります。 ユーザーが組織のツール カタログを識別するのに役立つ有益な名前を選択します。

リソースを作成する

1. Azure portal にサインインし、Azure API Center リソースがまだない場合は作成します。

2. API Center リソースに環境を作成します。 [Server>Type] で、[Azure Functions] を選択します。

MCP サーバーを登録する

リモート MCP サーバーを API として追加して登録します。

1. API センター リソースの左側のナビゲーション ウィンドウで、API を選択 します。

2. [ + API の登録] を選択します。 次の表に、必要な設定の値の例を示します。 また、MCP サーバーの説明、リポジトリ、外部ドキュメント、API センター ポータルに表示されるその他の情報などのオプションの設定を入力することもできます。

   Setting	価値
   API タイトル	MCP サーバーのわかりやすい名前 ( Weather MCP Serverなど) を入力します。
   [識別]	この値は API タイトルに基づいて自動生成されますが、変更することもできます。
   [API の種類]	MCP
   ランタイム URL	MCP サーバー エンドポイントを入力します (例: https://contoso.azurewebsites.net/mcp
   環境	前に作成した環境を選択します。
   バージョン タイトル	v1など、任意のバージョン タイトルを入力します。
   バージョン ID	上記のタイトルを入力すると、Azure API Center によってこの識別子が生成され、この識別子はオーバーライドできます。
   バージョンのライフサイクル	[ テスト ] や [ 運用] など、最も適切な値をドロップダウンから選択します。

3. を選択してを作成します。

   これで、一覧に API として登録されている MCP サーバーが表示されます。

サーバー定義を更新する

1. OpenAPI 3.0 形式でリモート MCP サーバーの API 定義を作成します。 API センター ポータルに MCP サーバーの URL エンドポイントが表示されるように、この定義が必要です。 アクセスできる場所に定義を保存します。 次の手順でアップロードする必要があります。

   MCP サーバーの OpenAPI 3.0 API 定義の例:

   {
       "openapi": "3.0.0",
       "info": {
           "title": "Weather MCP server",
           "description": "MCP server with tools returning weather forecast and alerts.",
           "version": "1.0"
       },
       "servers": [
           {
               "url": "https://my-mcp-server.azurewebsites.net/mcp"
           }
       ]
   }
   

2. サーバー定義を更新します。

   a. 左側のメニューで、 Assets -> API を見つけます。

   b。 MCP サーバー名を選択して登録を開きます。

   c. 左側のメニューで、[ 詳細] -> [バージョン] を見つけます。

   d. [バージョン] で、"v1" を見つけて展開します。 次に、[ Streamable Definition for... ]\(ストリーミング可能な定義\ ) を選択して定義を開きます。

   d. 「置換」を選択します。

   e. 開いたサイド ウィンドウで、"仕様バージョン" を 3.0 に変更し、最後の手順から定義をアップロードします。

   f. 「置換」を選択します。

API センター ポータルを設定する

1. ポータルがまだ ない場合は、ポータルを設定します。

2. ポータルがセットアップされたら、 https://<service-name>.portal.<location>.azure-apicenter.msでアクセスできます。 <service-name>と<location>は、API センターの名前とデプロイした場所に置き換えます。 登録済みの MCP サーバーを表示するには、サインインする必要があります。

3. サーバー名を選択すると、ウィンドウが開き、サーバー登録時に指定したデータとアップロードされた API 定義に基づく情報が表示されます。 ポータルにアクセスできるユーザーは、Visual Studio Code 統合でエンドポイント URL またはインストールをコピーすることで、選択したサーバーに接続できます。

   

関連資料

Azure API Management の MCP サーバーについて