Visual Studio Codeを使用して Foundry MCP Server (プレビュー) を始めましょう

Foundry MCP Server (プレビュー) は、モデルコンテキストプロトコル (MCP) のクラウドホスト型実装です。エージェントがバックエンド API を直接呼び出さずに Foundry サービスに対して読み取り操作と書き込み操作を実行できるようにする、キュレーションされたツールが公開されます。インフラストラクチャをデプロイする必要はありません。サーバーは、Microsoft Entra IDによる組み込み認証を使用して、セキュリティで保護されたスケーラブルなエンドポイントを提供します。

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

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

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

このガイドの所要時間は約 5 分です。

メモ

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

前提条件

Azure アカウントに有効なサブスクリプションが必要です。お持ちでない場合は、無料のAzureアカウントを作成します。
Foundry プロジェクト。プロジェクトがない場合は、Microsoft Foundry SDK クイックスタートでプロジェクトを作成します。
Visual Studio Code (バージョン 1.99 以降)。
GitHub Copilot サブスクリプション (個人、ビジネス、エンタープライズ)。
GitHub Copilot Visual Studio Code 拡張機能。
アクセスしたい Foundry プロジェクトで共同作成者以上の役割を持っていること。

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

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

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

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

コマンドパレットを開きます (Ctrl+Shift+P)。
MCP: サーバーの追加を検索します。
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 サーバーを選択し、[ サーバーの開始] を選択します。
MCP のサーバー名の横に緑色のインジケーターが表示されます 。サーバーを一覧表示し、接続がアクティブであることを確認します。
メッセージが表示されたら、Azureにサインインして、MCP サーバーがサブスクリプション内のサービスと対話できるようにします。
GitHub Copilotを開き、Agent Mode を選択します。
ツールアイコンを選択し、 Foundry を検索して一覧をフィルター処理し、サーバーが表示されたことを確認します。

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

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

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

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

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

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

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

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

GitHub Copilotチャットパネルを開き、Agent モードが選択されていることを確認します。
Foundry MCP サーバーツールを使用するプロンプトを入力します。たとえば、 Foundry の最新モデルについて教えてください。
Copilotは、必要な Foundry MCP サーバー操作を実行するためのアクセス許可を要求します。 [ 続行] を選択するか、矢印を使用して、より具体的な動作を選択します。
- 現在のセッションは、常に現在の GitHub Copilot エージェントモードセッションで操作を実行します。
- 現在のワークスペースは常に、現在のVisual Studio Code ワークスペースに対してコマンドを実行します。
- Always allow は、任意の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 チャットパネルで Agent Mode を選択したことを確認し、ツールアイコンを選択し、Foundry を検索します。
"アクセスが拒否されました" またはアクセス許可エラー	Foundry プロジェクトに対する共同作成者以上のロールがあることを確認します。サーバーは、Entra ID の資格情報で On-Behalf-Of フローを使用します。

リソースのクリーンアップ

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

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

Foundry MCP サーバーツールとプロンプトの例

フィードバック

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

Last updated on 2026-05-05