重要
SQL MCP Server 以预览版提供，本文档和引擎实现在此评估期间可能会更改。
本快速入门介绍如何使用自定义 MCP 工具将已部署的 SQL MCP 服务器连接到 Azure AI Foundry。 在聊天试玩区中使用聊天模型（如 GPT-5-mini）来测试所有内容 - 无需编程。
注释
新 Foundry 体验当前为预览版。 访问https://ai.azure.com时，需要在页眉中选择预览开关。
先决条件
部署的 SQL MCP 服务器
需要一个部署到启用了公共入口的 Azure 容器应用的 SQL MCP 服务器。 如果还没有部署，请先完成 “将 SQL MCP Server 部署到 Azure 容器应用 ”快速入门。
需要该部署中的 MCP 终结点 URL（例如 https://your-app.azurecontainerapps.io/mcp）。
Azure AI Foundry 项目
需要使用现有项目访问 Azure AI Foundry 并访问聊天模型（例如 GPT-5-mini）。
步骤 1：访问 Azure AI Foundry
- 请导航至 https://ai.azure.com
- 在标头中，选择 新的 Foundry 使用体验（预览模式切换）。
- 选择您的 Foundry 项目。
- 在左侧导航中，选择 Playground。
注释
随着 Azure AI Foundry 的发展，UI 文本和导航可能会有所不同。 有关最新指南，请参阅 Azure AI Foundry 中的 MCP 工具。
步骤 2：创建或打开代理
- 选择现有代理或创建新代理。
- 在代理配置中，找到左侧面板中的 “工具” 部分。
步骤 3：添加模型上下文协议工具
- 在 “工具 ”部分中，选择“ 添加 ”（按钮可能显示下拉列表或 + 图标）。
- 从下拉列表中选择 “添加新工具 ”。
- 此时会打开 “选择工具 ”对话框，其中包含三个选项卡： “已配置”、“ 目录”和 “自定义”。
- 选择顶部的 “自定义 ”选项卡。
- 从可用选项中选择 模型上下文协议（MCP ）。
- 选择“ 创建 ”以继续。
步骤 4：配置 MCP 连接
此时会显示 “添加模型上下文协议”工具 对话框。 填充以下信息：
名称（必填）
输入描述性名称： products-mcp.
远程 MCP 服务器终结点（必需）
请输入 MCP 服务器的 URL：https://<your-container-app-url>/mcp（可从您的 Azure 容器应用部署中获取）。
身份验证（必需）
从下拉列表中选择 “未经身份验证 ”。
注释
此配置之所以有效，是因为 Azure 容器应用在快速入门中已配置了匿名权限（例如anonymous:read）。 撰写本文时，本快速入门使用未经身份验证的模式。 如果在 MCP 服务器上启用身份验证，请相应地配置 MCP 工具（本快速入门未介绍身份验证配置）。
选择 “连接” 以添加该工具。
步骤 5：配置代理程序指令
在代理配置顶部的 “说明 ”部分中，添加或替换以下文本：
You are a helpful product catalog assistant. When answering questions about products, use the products-mcp tool to query the database.
The Products entity contains:
- Id: Product identifier
- Name: Product name
- Inventory: Units in stock
- Price: Retail price in USD
- Cost: Store cost in USD
Always use the schema discovery tool first to understand the schema, then use the query tool to retrieve data.
步骤 6：测试代理
在聊天中尝试以下提示：
示例 1：架构发现
What tables or entities are available in the database?
代理应调用架构发现工具（例如 describe_entities），以查看 Products 实体结构。
示例 2：简单查询
List all products
代理应调用查询工具（如 read_records）来检索产品数据。
示例 3：价格查询
Show me products under $20
代理应查询 Price < 20 的产品。
示例 4：清单检查
Which products are low in stock (less than 30 units)?
代理应筛选库存 < 30。
示例 5：复杂查询
What's the most expensive product, and how many do we have in stock?
代理应：
- 查询按价格降序排序的产品
- 返回库存计数的最高结果
步骤 7：查看工具调用
在聊天游乐场中，您可以看到工具调用及其参数和响应：
- 调用的工具：使用的架构发现或查询工具
- 参数：传递的参数（筛选器、字段等）
- 响应：从 SQL 数据库返回的数据
Troubleshooting
Azure AI Foundry 中未显示的工具
- 验证 MCP URL 是否正确且可访问。
- 检查容器应用是否在启用了公共入口的情况下运行（请参阅 监视指南）。
-
/mcp使用 curl 或 REST 客户端测试终结点，以验证可访问性。
工具调用需要审批
- 在 MCP 工具配置中，确保 将“需要审批 ”设置为
never。
不使用该工具的代理
- 检查系统消息包括有关何时使用该工具的明确说明。
- 请尝试询问与产品数据相关的更具体问题。
有关部署问题，请参阅 Azure 容器应用部署指南中的 故障排除部分 。