API インベントリに MCP サーバーを登録して検出する

この記事では、Azure API Center を使用してリモートまたはローカル モデル コンテキスト プロトコル (MCP) サーバーのインベントリ (または レジストリ) を維持し、関係者が API Center ポータルを使用してそれらを検出できるようにする方法について説明します。 MCP サーバーは、バックエンド API またはデータ ソースを使用する AI エージェントとモデルに標準的な方法で公開します。

この記事に示すように、API やその他の資産を登録する方法と同様に、Azure portal を使用してリモートまたはローカルの MCP サーバーを登録できます。 API センターには、インベントリに登録できるパートナー MCP サーバーへのリンクも用意されています。

MCP サーバーについて

大規模言語モデル (LLM) 機能の強化により、AI エージェントが広く採用されています。 ただし、最も高度なモデルでも、外部データから分離されているため、制限に直面します。 新しいデータ ソースごとに、モデルのデータを抽出、準備、およびアクセスできるようにするためのカスタム実装が必要になる可能性があります。

モデル コンテキスト プロトコル (MCP) は、この問題の解決に役立ちます。 MCP は、AI モデルとエージェントを、ローカル データ ソース (データベースまたはコンピューター ファイル) やリモート サービス (リモート データベースや API など、インターネット経由で利用可能なシステム) などの外部データ ソースと接続するためのオープン標準です。

MCP アーキテクチャ

MCP は、ホスト アプリケーションが複数のサーバーに接続できるクライアント/サーバー アーキテクチャに従います。 MCP ホストまたはクライアントがツールを必要とする場合は常に、MCP サーバーに接続します。 その後、MCP サーバーは、データベースや API などに接続します。 MCP ホストとサーバーは、MCP プロトコルを介して相互に接続します。

MCP アーキテクチャは、 メッセージングのためにJSON-RPC 2.0 上に構築されています。 クライアントとサーバー間の通信は、定義されたトランスポート層を介して行われ、主に 2 つの操作モードをサポートします。

• リモート MCP サーバー - MCP クライアントはインターネット経由で MCP サーバーに接続し、HTTP およびサーバー送信イベント (SSE) を使用して接続を確立し、OAuth を使用してユーザーのアカウント上のリソースへの MCP クライアント アクセスを承認します。

• ローカル MCP サーバー MCP クライアントは、ローカル トランスポート方法として標準の入出力を使用して、同じコンピューター上の MCP サーバーに接続します。

[前提条件]

• API センター。 API センターがまだない場合は、API センターの作成に関するクイックスタート を参照してください。
• 登録するリモート MCP サーバー URL エンドポイントまたは MCP サーバー パッケージ。
• (リモート MCP サーバーの場合)MCP サーバーに関連付ける API センター内の 環境 。 環境は、API 管理プラットフォームやコンピューティング サービスなどの MCP サーバーの場所です。

リモート MCP サーバーを登録する

リモート MCP サーバーを登録するには:

1. Azure portal にサインインし、API センターに移動します。
2. サイドバーメニューの[ インベントリ]で[アセット]を選択 します。
3. [ + 資産の登録>MCP サーバーを選択します。
   
4. [ MCP サーバーの登録 ] フォームで、MCP サーバーに関する情報を入力します。
   1. MCP サーバーの タイトル を入力します。 API Center ではタイトルに基づいて ID が 自動的に生成されますが、必要に応じて編集できます。
   2. MCP サーバーの 概要 と 説明 を入力して、詳細なコンテキストを提供します。
   3. 必要に応じて、イメージを MCP サーバーに関連付ける アイコン URL を 入力します。
   4. [ ユース ケース] で、必要に応じて、MCP サーバーの 1 つ以上のユース ケースの名前と説明を指定します。
   5. [ リモート] で、次の操作を行います。
      1. [+ リモートの追加]を選択します。
      2. MCP サーバーの ランタイム URL を 入力します。
      3. API Management プラットフォームやコンピューティング サービスなど、MCP サーバーの場所に対応する API センター 環境 を選択します。
      4. 保存を選びます。
      5. 必要に応じて、MCP サーバーに複数のエンドポイントがある場合、または複数の環境にデプロイされている場合は、前の手順を繰り返してリモートを追加します。
   6. 必要に応じて、[ リポジトリの追加] を選択して、MCP サーバーに関連付けられているコード リポジトリの URL を指定します。
   7. [ バージョン タイトル] で、MCP サーバーの バージョン タイトル、 バージョン ID、および バージョン ライフサイクル を指定します。 API Center のバージョンの詳細を確認します。
   8. 必要に応じて、 ライセンス と 外部のドキュメント リンクと MCP サーバーの関連情報を追加します。
   9. を選択してを作成します。

リモート MCP サーバーの定義

API Center では、リモート MCP サーバーに対して次の OpenAPI 定義が自動的に生成され、登録したサーバー バージョンに関連付けられます。

• エージェント プロトコルとしてサーバー送信イベント (SSE) を使用するための SSE 定義
• トランスポートに依存しないエージェント プロトコルを使用するためのストリーミング可能な定義

ローカル MCP サーバーを登録する

npmやpypiなどのパッケージ マネージャーを使用して、ローカルにインストールされている MCP サーバーを登録できます。

ローカル MCP サーバーを登録するには:

1. Azure portal にサインインし、API センターに移動します。
2. サイドバーメニューの[ インベントリ]で[アセット]を選択 します。
3. [ + 資産の登録>MCP サーバーを選択します。
4. [ MCP サーバーの登録 ] フォームで、MCP サーバーに関する情報を入力します。
   1. MCP サーバーの タイトル を入力します。 API Center ではタイトルに基づいて ID が 自動的に生成されますが、必要に応じて編集できます。
   2. MCP サーバーの 概要 と 説明 を入力して、詳細なコンテキストを提供します。
   3. 必要に応じて、イメージを MCP サーバーに関連付ける アイコン URL を 入力します。
   4. [ ユース ケース] で、必要に応じて、MCP サーバーの 1 つ以上のユース ケースの名前と説明を指定します。
   5. [ パッケージ] で、次の操作を行います。
      1. [ + パッケージの追加] を選択します。
      2. MCP サーバーをインストールするための パッケージ レジストリ を入力します。 たとえば、「 npm 」のように入力します。
      3. パッケージ レジストリの パッケージ名 とバージョンを入力 します。
      4. ランタイム ヒントで、MCP サーバーの実行に使用するランタイム コマンドを入力します。 たとえば、「 npx 」のように入力します。
      5. ランタイム引数では、必要に応じて MCP サーバーの実行時に引数を渡します。
      6. 保存を選びます。
      7. 必要に応じて、MCP サーバーが複数のパッケージ レジストリで使用できる場合、または複数のバージョンがある場合は、前の手順を繰り返してパッケージを追加します。
   6. 必要に応じて、[ リポジトリの追加] を選択して、MCP サーバーに関連付けられているコード リポジトリの URL を指定します。
   7. [ バージョン タイトル] で、MCP サーバーの バージョン タイトル、 バージョン ID、および バージョン ライフサイクル を指定します。 API Center のバージョンの詳細を確認します。
   8. 必要に応じて、 ライセンス と 外部のドキュメント リンクと MCP サーバーの関連情報を追加します。
   9. を選択してを作成します。

パートナー MCP サーバーを登録する

Azure API Center には、API インベントリに追加できるパートナー MCP サーバーのキュレーションされた一覧が用意されています。 この一覧には、Azure Logic Apps、GitHub などの Microsoft サービスの MCP サーバーが含まれています。

API インベントリに 1 つ以上のパートナー MCP サーバーを登録して、開発者や組織内の他の利害関係者が利用できるようにします。

パートナー MCP サーバーを登録するには:

1. Azure portal で、API センターに移動します。
2. サイドバー メニューの [ 検出] で、 MCP (プレビュー) を選択します。
3. 使用可能なパートナー MCP サーバーを参照します。 [ 登録 ] を選択して、MCP サーバーを API インベントリに追加します。 指示が提示されている場合は、画面の案内に従って登録を完了します。

パートナー MCP サーバーを追加すると、API Center によって次の設定が自動的に構成されます。

• API の種類が MCP に設定された API インベントリに API エントリを作成します。
• MCP サーバーの環境とデプロイを作成します。
• パートナーが MCP サーバーを提供する場合は、MCP サーバーの OpenAPI 定義を追加します。

独自の MCP サーバーをビルドして登録する

Azure コンピューティング サービスを使用して MCP サーバーを構築し、API センターに登録するには、次の例を参照してください。

• Logic Apps MCP サーバーをビルドして登録する
• Azure Functions MCP サーバーをビルドして登録する

API Center ポータルを使用して MCP サーバーを検出する

API インベントリ内の MCP サーバーを開発者や組織内の他の利害関係者が検出できるように、API センター ポータル を設定します。 ユーザーは、API センター ポータルから次の操作を行うことができます。

• インベントリ内の MCP サーバーを参照してフィルター処理します。
• リモート MCP サーバーの場合は、MCP サーバーの URL エンドポイントや API 定義などの詳細を表示し、Visual Studio Code 環境に MCP サーバーをインストールします。

MCP サーバーへのアクセスを管理する

必要に応じて、API Center のアクセス管理機能を使用して、インベントリ内の MCP サーバーを表示およびアクセスできるユーザーを管理します。 詳細については、「 API センターで API へのアクセスを承認する」を参照してください。

関連コンテンツ

• API Management の MCP サーバーについて
• API Management から API センターに API をインポートする
• API センター向け Visual Studio 拡張機能を使用して Visual Studio Code から API をビルドして登録する。
• Azure API Center がエンタープライズ対応のプライベート MCP レジストリに電力を供給する方法のライブ例については、 MCP センターを参照してください。