使用 Visual Studio Code 開始使用 Foundry MCP Server（預覽版）

Foundry MCP Server（預覽版）是模型情境協定（MCP）的雲端託管實作，讓您的代理程式能安全存取 Foundry 服務。它公開了經過精選的工具，讓你的代理程式能在不直接呼叫後端 API 的情況下，對 Foundry 服務進行讀寫操作。你不需要部署基礎設施——伺服器提供一個安全且可擴展的端點，並透過 Microsoft Entra ID 內建認證功能。

使用符合 MCP 標準的客戶端，如 Visual Studio Code，連接公共端點，使用 Entra ID 認證，並讓大型語言模型（LLM）存取這些工具。連線後，你可以建立代理，透過自然語言提示來呼叫這些工具。

在本文中，您將學習如何：

在 Visual Studio Code 中使用 GitHub Copilot 連接 Foundry MCP 伺服器
執行提示來測試 Foundry MCP Server 工具並與 Azure 資源互動

這份指南大約需要5分鐘完成。

註

此功能目前正處於公開預覽階段。此預覽版未簽訂服務水準協議，且不建議用於生產工作負載。某些功能可能不被支援或功能受限。欲了解更多資訊，請參閱Microsoft Azure預覽補充使用條款。

先決條件

Azure 帳號且有有效訂閱。如果你沒有，建立免費Azure帳號。
一個鑄造廠的專案。如果你還沒有專案，可以用 Microsoft Foundry SDK Quickstarter 建立一個。
Visual Studio Code（版本 1.99 或更新版本）。
GitHub Copilot訂閱（個人、商業或企業）。
GitHub Copilot Visual Studio Code擴充套件。
對您想存取的 Foundry 專案具備 Contributor 或以上角色。

安裝並啟動 Foundry MCP 伺服器

選擇在 Visual Studio Code 中安裝 Foundry MCP Server。

使用者簡介
工作空間安裝

在你的使用者設定檔安裝 Foundry MCP Server，讓它能在 Visual Studio Code 的所有工作區使用。

打開 指令面板 （Ctrl+Shift+P）。
搜尋 MCP：新增伺服器。
選擇 HTTP（HTTP 或伺服器傳送事件）選項。
輸入 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：列表伺服器。
選擇你新增的 Foundry MCP 伺服器，然後選擇 開始伺服器。
在 MCP：List Server 中，伺服器名稱旁會出現綠色指示，確認連線為有效。
當被要求時，登入 Azure，讓 MCP 伺服器能與你訂閱中的服務互動。
打開GitHub Copilot並選擇 Agent Mode。
選擇工具圖示，搜尋 Foundry 來篩選清單，並確認伺服器是否出現。

想了解更多關於代理模式的資訊，請參閱 Visual Studio Code 文件。

在特定工作區的資料夾中安裝 Foundry MCP Server 以使其範圍限定於此資料夾：

在 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 Mode。
輸入一個使用 Foundry MCP Server 工具的提示——例如「告訴我 Foundry 上的最新模型」。
Copilot 請求執行所需的 Foundry MCP 伺服器操作權限。選擇繼續或使用箭頭選擇更具體的行為：
- Current session 總是在目前的 GitHub Copilot 代理模式會話中執行該操作。
- Current workspace 總是執行目前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 伺服器的操作，並搭配其他提示，例如：

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

故障排除

問題	解決方法
伺服器無法啟動	確認你輸入的網址 `https://mcp.ai.azure.com` 是正確的。打開指令面板並執行 MCP： List Server 以檢查伺服器狀態。
驗證提示不出現	請確認已安裝 GitHub Copilot 擴充功能，並且你已用 Microsoft 帳戶登入 Visual Studio Code，該帳號能存取你的 Azure 訂閱。
Foundry 工具不會出現在代理模式中	確認伺服器正在運行（ MCP：列表伺服器中的綠色指示器）。請確認你在Copilot聊天面板中選擇了 Agent Mode，然後選擇工具圖示，搜尋 Foundry。
「存取被拒」或權限錯誤	請確認您在 Foundry 專案上具有 Contributor 或更高角色。伺服器使用您的 Entra ID 認證進行 On-Behalf-Of 流程。

如果這些步驟仍無法解決產品或服務問題，請建立 Azure 支援請求。選擇「技術」作為問題類型，選擇 Microsoft Foundry 作為服務，「選擇 Foundry MCP 伺服器」作為問題類型。如需文件回饋，請使用本頁的回饋控制。如有操作問題，請在 Microsoft Q&A 向社群提問。

清理資源

要移除伺服器設定：

使用者設定：打開指令面板，執行 MCP：列表伺服器，選擇 Foundry 伺服器，然後選擇移除伺服器。
工作區：刪除專案資料夾中 .vscode/mcp.json 檔案的伺服器條目。

Foundry MCP 伺服器工具與範例提示

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-08-19