Azure API Center MCP サーバーを使用して API を検出する

Azure API Center MCP サーバーは、組織の API カタログを AI エージェントとエージェント ワークフローのネイティブ ツール サーフェスとして公開します。 API Center MCP サーバーを有効にすると、Visual Studio Code Copilot、Claude Code、カスタム エージェントなど、MCP と互換性のある AI クライアントのエコシステムの拡大によって API と AI 資産を検出できるようになります。

Azure API Center MCP サーバーは、エージェントが API センターのインベントリ (レジストリ) から資産を検出および取得するために使用する次のツールを公開します。

ツール Description
mcp_registry_search API Center レジストリを検索して、名前、種類、またはメタデータで API と AI 資産を検出します。 資産の種類 (REST、MCP、プラグイン、スキル)、ライフサイクルの状態、説明など、一致する結果を返します。
mcp_registry_fetch デプロイ エンドポイント、バージョン、定義、関連する仕様など、特定の API または AI 資産に関する詳細情報をレジストリからフェッチします。

Prerequisites

Azure API Center MCP サーバーを有効にする

Azure ポータルを使用して MCP サーバーを有効にするには:

  1. Azure ポータルで、API センターに移動します。
  2. サイドバー メニューの [ 従量課金] で、[ データ API の設定] を選択します。
  3. [MCP エンドポイント] で、[API センター MCP エンドポイントを有効にする] を選択します。

ポータルの API Center MCP エンドポイントのスクリーンショット。

MCP サーバー エンドポイントは、次の形式に従います。

https://<service name>.data.<region>.azure-apicenter.ms/mcp

例: https://myapicenter.data.eastus.azure-apicenter.ms/mcp

Important

MCPエンドポイントは標準層でのみ有効化できます。 APIセンターが無料プランの場合は、MCPサーバーを有効にするためにStandardにアップグレードする必要があります。 APIセンターのアップグレードに関する詳細は FAQをご覧ください。

MCP サーバーに接続する

API Center MCP サーバーを有効にすると、開発者は API センター ポータルにサインインするときに MCP サーバー エンドポイントを検出できます。 開発者は、Visual Studio Codeや MCP CLI などの MCP クライアントを使用して MCP サーバーに接続できます。 接続には、MCP サーバー エンドポイントと適切な認証資格情報 (構成されている場合) が必要です。

Claude Code を使用して MCP サーバーに接続するには、「 Claude Code に MCP サーバーを追加する」を参照してください。

VS Code 経由で接続する

開発者は、settings.json キーの下の Visual Studio Code mcp ファイルに MCP サーバー構成を追加できます。

  1. Visual Studio Codeを開き、Ctrl+Shift+P (Mac では Cmd+Shift+P) を押します。

  2. Open User Settings (JSON) を検索します。

  3. mcp キーの下に次のスニペットを貼り付けて、ファイルを保存します。 url値を API Center MCP サーバー エンドポイントに置き換えます。

    {
      "servers": {
        "api-center": {
          "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
          "type": "http"
        }
      },
      "inputs": []
    }
    
  4. VS Code Copilotは、MCP サーバーを自動的に検出して接続します。

CLI 経由で接続する

開発者は、MCP CLI を使用してサーバーに直接接続し、レジストリ ツールを呼び出すことができます。

  1. 次の例のようなコマンドを使用して、MCP サーバーに接続します。 URL を API Center MCP サーバー エンドポイントに置き換えます。

    mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp
    
  2. レジストリで資産を検索します。

    mcp run mcp_registry_search --query "customer-support"
    
  3. 特定のアセットの詳細を取得します:

    mcp run mcp_registry_fetch --id "my-agent-skill"