Visual Studio Code を使用して、Foundry MCP Server (プレビュー) を開始する

Foundry MCP Server (プレビュー) は、モデルコンテキストプロトコル (MCP) のクラウドホスト型実装です。エージェントがバックエンド API を直接呼び出さずに Foundry サービスに対して読み取り操作と書き込み操作を実行できるようにする、キュレーションされたツールが公開されます。

Visual Studio Code などの MCP 準拠クライアントを使用して、パブリックエンドポイントに接続し、Entra ID で認証し、LLM がツールにアクセスできるようにします。接続後、自然言語プロンプトを使用してこれらのツールを呼び出すエージェントを構築できます。

この記事では、次の方法について説明します。

Visual Studio Code で GitHub Copilot を使用して Foundry MCP サーバーに接続する
Foundry MCP Server ツールをテストし、Azure リソースと対話するためのプロンプトを実行する

注

現在、この機能はパブリックプレビュー段階にあります。このプレビューはサービスレベルアグリーメントなしで提供されており、運用環境ではお勧めしません。特定の機能はサポート対象ではなく、機能が制限されることがあります。詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。

[前提条件]

アクティブなサブスクリプションが含まれる Azure アカウント。お持ちでない場合は、無料の Azure アカウントを作成します。
Foundry のプロジェクト。プロジェクトがない場合は、 Microsoft Foundry SDK クイックスタートを使用してプロジェクトを作成します。
Visual Studio Code (バージョン 1.99 以降)。
GitHub Copilot Visual Studio Code 拡張機能。
アクセスしたい Foundry プロジェクトでは、共同作成者以上の役割が必要です。

Foundry MCP Server の利点

AI ツールオーケストレーション用のクラウドでホストされたインターフェイス: Foundry MCP Server (プレビュー) は、MCP に準拠したクライアントに対してセキュリティで保護されたスケーラブルなエンドポイントを提供します。インフラストラクチャをデプロイする必要がなく、シームレスな統合とマルチエージェントのシナリオが可能になります。
ID とアクセス制御: サーバーは、Microsoft Entra ID を使用して認証と承認を強制します。認証されたユーザーのアクセス許可 (On-Behalf-Of フロー) 内のすべての操作を実行します。
シナリオに重点を置いた拡張可能なツール: Foundry MCP Server では、Foundry のモデル、デプロイ、評価、およびエージェントに対する読み取りと書き込み操作用のツールセットが増え続けています。これらのツールは拡張可能であり、開発者やエージェントはバックエンド API やデータスキーマを知らなくてもサービスと対話できます。
エージェントと開発者の生産性の高速化: 自然言語ワークフロー (MCP クライアントと大規模言語モデルを使用) により、ツールの迅速な検出と呼び出しが可能になり、開発とマルチエージェントオーケストレーションが合理化されます。

Foundry MCP サーバーをインストールして起動する

Visual Studio Code で Foundry MCP Server をインストールするオプションを選択します。

ユーザープロファイル
ワークスペースのインストール

Visual Studio Code のすべてのワークスペースで使用できるように、Foundry MCP Server をユーザープロファイルにインストールします。

コマンドパレットを開きます (Ctrl+Shift+P)。
MCP:Add Server を検索します。
HTTP (Http または Server-Sent イベント) オプションを選択します。
URL として「 https://mcp.ai.azure.com 」と入力します。
foundry-mcp-remote などのフレンドリ名を入力し、Enter キーを押します。 Visual Studio Code では、ユーザープロファイルの下に次のサーバーエントリが追加されます。
```
{ 
  "servers": { 
    "foundry-mcp-remote": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}
```
コマンドパレットを開きます (Ctrl+Shift+P)。
MCP:List Servers を検索して選択します。
追加した Foundry MCP サーバーを選択し、[ サーバーの開始] を選択します。
メッセージが表示されたら、Azure にサインインして、MCP サーバーがサブスクリプション内のサービスと対話できるようにします。
GitHub Copilot を開き、[ エージェントモード] を選択します。
ツールアイコンを選択し、 Foundry を検索して一覧をフィルター処理し、サーバーが表示されたことを確認します。

エージェントモードの詳細については、 Visual Studio Code のドキュメントを参照してください。

特定のワークスペースの Foundry MCP サーバーをインストールして、そのフォルダーにスコープを設定します。

Visual Studio Code で空のフォルダーまたは既存のプロジェクトフォルダーを開きます。
フォルダールートに、 .vscode フォルダーが存在しない場合は作成します。

.vscode フォルダー内に、mcp.jsonという名前のファイルを作成し、次の JSON を追加します。

{ 
  "servers": { 
    "azure-ai-foundry-mcp-preview": { 
      "type": "http", 
      "url": "https://mcp.ai.azure.com" 
    } 
  } 
}

変更内容を mcp.jsonに保存します。
新しいサーバーエントリの上にある [スタート] ボタンを選択します。
メッセージが表示されたら、MCP サーバーがサブスクリプション内のサービスと対話できるようにサインインします。
GitHub Copilot を開き、[エージェントモード] を選択します。
ツールアイコンを選択し、 Foundry を検索して結果をフィルター処理し、サーバーが表示されたことを確認します。

エージェントモードの詳細については、 Visual Studio Code のドキュメントを参照してください。

プロンプトを使用して Foundry MCP サーバーをテストする

GitHub Copilot チャットパネルを開き、 エージェントモード が選択されていることを確認します。
Foundry MCP サーバーツールを使用するプロンプトを入力します。たとえば、 Foundry の最新モデルについて教えてください。
Copilot は、必要な Foundry MCP サーバー操作を実行するためのアクセス許可を要求します。 [ 続行] を選択するか、矢印を使用して、より具体的な動作を選択します。
- 現在のセッション では、常に現在の GitHub Copilot エージェントモードセッションで操作が実行されます。
- 現在のワークスペース では、常に現在の Visual Studio Code ワークスペースのコマンドが実行されます。
- 常に許可すると 、GitHub Copilot エージェントモードセッションまたは Visual Studio Code ワークスペースに対して常に実行するように操作が設定されます。
応答は、次の短縮された出力のようになります。実際の結果は、現在のモデルの可用性によって異なります。
```
Latest / Notable Foundry Models (Preview Snapshot)

1. Frontier & Reasoning Models
gpt-4o (2024-11-20) – Flagship multimodal model; strong multi-turn coherence.
o3 (2025-04-16) – Balanced reasoning with good accuracy/quality trade-off.
o4-mini (2025-04-16) – Strong quality with better latency than o3.
Phi-4 – Microsoft small frontier open model; competitive quality at lower cost.

// Further output omitted
```

Foundry MCP Server の操作を、次のような他のプロンプトで調べてテストします。

What tools can I use from Foundry MCP Server (preview)?
Tell me about the latest models on Foundry
Show me details about the GPT-4o model on Foundry

トラブルシューティング

問題点	解決策
サーバーが起動しない	URL `https://mcp.ai.azure.com` 正しく入力したことを確認します。コマンドパレットを開き、MCP: List Servers を実行してサーバーの状態を確認します。
認証プロンプトが表示されない	GitHub Copilot 拡張機能がインストールされていて、Azure サブスクリプションにアクセスできる Microsoft アカウントを使用して Visual Studio Code にサインインしていることを確認します。
Foundry ツールがエージェントモードで表示されない	サーバーが実行されていることを確認します ( MCP の緑色のインジケーター: サーバーの一覧表示)。 Copilot チャットパネルで [エージェントモード ] を選択したことを確認し、ツールアイコンを選択して Foundry を検索します。
"アクセスが拒否されました" またはアクセス許可エラー	Foundry プロジェクトで共同作成者以上の役割があることを確認します。サーバーは、Entra ID 資格情報と共に On-Behalf-Of フローを使用します。

Foundry MCP サーバーの削除

サーバー構成を削除するには:

ユーザープロファイル: コマンドパレットを開き、 MCP: List Servers を実行し、Foundry サーバーを選択して、[ サーバーの削除] を選択します。
ワークスペース: プロジェクトフォルダー内の .vscode/mcp.json ファイルからサーバーエントリを削除します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-02-28