你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Visual Studio Code 开始使用 Foundry MCP 服务器（预览版）

Foundry MCP 服务器（预览版）是模型上下文协议（MCP）的云托管实现，使代理能够安全访问 Foundry 服务。它公开了特选工具，使代理无需直接调用后端 API 即可针对 Foundry 服务执行读取和写入操作。无需部署基础结构 - 服务器通过Microsoft Entra ID提供具有内置身份验证的安全可缩放终结点。

使用符合 MCP 的客户端（例如Visual Studio Code）连接到公共终结点、使用Entra ID进行身份验证，并允许 LLM 访问这些工具。连接后，可以生成使用自然语言提示调用这些工具的代理。

在本文中，您将学到如何：

在 Visual Studio Code 中使用 GitHub Copilot 连接到 Foundry MCP 服务器
运行提示以测试 Foundry MCP 服务器工具并与Azure资源交互

本指南需要大约 5 分钟才能完成。

注意

此功能目前以公共预览版提供。此预览版在没有服务级别协议的情况下提供，不建议将其用于生产工作负荷。某些功能可能不受支持，或者可能具有受限功能。有关详细信息，请参阅 Microsoft Azure 预览版的使用条款。

先决条件

具有有效订阅的 Azure 帐户。如果没有帐户，创建免费的Azure帐户。
一个铸造项目。如果没有项目，请使用 Microsoft Foundry SDK 快速入门创建一个项目。
Visual Studio Code（版本 1.99 或更高版本）。
GitHub Copilot 订阅（个人、企业或企业）。
GitHub Copilot Visual Studio Code扩展。
你要访问的 Foundry 项目的参与者或更高角色。

安装和启动 Foundry MCP 服务器

选择在 Visual Studio Code 中安装 Foundry MCP 服务器的选项。

用户配置文件
工作区安装

在用户配置文件中安装 Foundry MCP 服务器，使其可供Visual Studio Code中的所有工作区使用。

打开 命令面板 （Ctrl+Shift+P）。
搜索 MCP：添加服务器。
选择 HTTP（HTTP 或 Server-Sent Events） 选项。
输入 https://mcp.ai.azure.com 为 URL。
输入易记名称（如 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 Mode。
输入使用 Foundry MCP 服务器工具的提示—例如 ，告诉我 Foundry 上的最新模型。
Copilot请求运行所需 Foundry MCP 服务器操作的权限。选择 “继续 ”或使用箭头选择更具体的行为：
- 当前会话始终在当前GitHub Copilot代理模式会话中运行操作。
- Current workspace始终运行当前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 服务器操作，例如：

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：列出服务器以检查服务器状态。
身份验证提示未显示	请确保已安装 GitHub Copilot 扩展，并且已使用有权访问 Azure 订阅的 Microsoft 帐户登录到 Visual Studio Code。
Foundry 工具未显示在代理模式下	确认服务器正在运行（MCP 中的绿色指示器：列出服务器）。检查是否在Copilot聊天面板中选择了 Agent Mode，然后选择工具图标并搜索 Foundry。
“访问被拒绝”或权限错误	验证对 Foundry 项目是否具有参与者或更高角色。服务器使用代表用户 (OBO) 流和你的 Entra ID 凭据。

如果这些步骤无法解决产品或服务问题，请创建Azure 支持请求。对于问题类型，选择技术；对于服务，选择Microsoft Foundry；对于问题类型，选择Foundry MCP Server。有关文档反馈，请使用此页面上的反馈控件。对于操作方法类问题，请在Microsoft Q&A向社区提问。

清理资源

若要删除服务器配置，请执行以下操作：

用户配置文件：打开 命令面板，运行 MCP：列出服务器，选择 Foundry 服务器，然后选择 “删除服务器”。
工作区：从 .vscode/mcp.json 项目文件夹中的文件中删除服务器条目。

Foundry MCP 服务器工具和示例提示

反馈

此页面是否有帮助？

Last updated on 2026-08-19