月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
接入 MCP 服务器
本页说明如何把一个远程 MCP 服务器接入 Foundry 智能体，让智能体使用其中的工具。门户中的具体界面位置以官方文档为准，本页只给出通用步骤与待核实项。
适用场景
- 希望 Foundry 智能体调用外部系统的工具，例如 Azure DevOps MCP Server。
- 希望把部署在 Azure Functions 上的自定义工具暴露给智能体。
前提
- 已有 Foundry 项目，并有可用的模型部署。
- 已确认目标 MCP 服务器的端点与认证方式（远程服务器通常使用 Streamable HTTP）。
- 已确认账户或托管身份具备所需的访问权限。
步骤
- 明确要接入的服务器和需要的工具，只选择必要的子集。
- 在智能体的工具配置中添加远程 MCP 服务器，填写端点。
- 选择认证方式，并配置凭据或权限范围（scope）。
- 只勾选允许智能体使用的工具，以控制它能执行的动作。
- 在 playground 中测试工具的连通性、权限与行为，确认后再发布。
参数表
参数 | 说明 | 取值 |
端点 | 远程 MCP 服务器的地址 | 以服务器文档为准（待核实） |
传输 | 远程服务器的传输方式 | Streamable HTTP |
认证方式 | 访问服务器的身份 | 密钥（Key）、Microsoft Entra（智能体或项目的托管身份）、OAuth 身份透传（On-Behalf-Of）、无认证（视场景而定） |
工具子集 | 允许智能体调用的工具 | 按需勾选 |
对 Azure Functions 托管的 MCP 服务器，官方页面给出的端点形式为 Functions MCP webhook（
/runtime/webhooks/mcp）。验证
- 在 playground 中，智能体能够列出服务器提供的工具。
- 发起一次只读工具调用，能返回预期结果。
- 在追踪中能看到对应的工具调用记录（追踪的具体界面待核实）。
排错表
现象 | 可能原因 | 处理方向 |
工具不出现 | 端点不可达，或工具未勾选 | 检查端点与工具子集配置 |
访问被拒绝 | 认证方式或权限范围不正确，或角色不足 | 核对认证方式、scope 与 RBAC，按最小权限授予 |
工具列表没有更新 | 服务器未声明或客户端未订阅变更通知；通知为尽力而为 | 客户端应定期重新列出工具（MCP 架构页建议结合轮询） |
工具结果异常 | 工具返回了不可信内容或不符合参数约定 | 校验参数与返回内容，只连接可信服务器 |
安全注意
- 只接入可信的 MCP 服务器；工具返回的内容可能包含诱导模型执行非预期操作的文本。
- 对会产生实际影响的工具（写入、发送、删除等），在执行前加入人工确认。
- 凭据与密钥应放在平台的连接配置中，不要写入代码或文档。
来源与核对
- 来源：
- https://learn.microsoft.com/en-us/azure/foundry/agents/overview
- https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture
- https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/function-calling
- read_scope：正文已读（概览页中的 MCP 连接与认证说明、MCP 架构页的传输与通知说明、function calling 页的安全建议）。门户中的具体操作界面与菜单位置未在本页读取，待核实（2026-11-05 获取）。
上一篇
Chat / Workflow / Agent 选型
下一篇
Skills 概念
Loading...