使用模型上下文协议连接到 Dataverse

模型上下文协议(MCP)是一种开放协议,可在大型语言模型(LLM)应用程序和外部数据源和工具之间实现无缝集成。 Microsoft Dataverse 可以充当 MCP 服务器,为各种 MCP 客户端提供对表和记录的智能访问,例如 Copilot Studio 代理、Visual Studio (VS) Code GitHub Copilot、GitHub Copilot CLI、Claude 桌面、Claude Code 等。 此集成标准化并简化了 AI 模型与 Dataverse 数据之间的交互,使开发人员能够更高效地将 Dataverse 的丰富数据能力应用于其 AI 驱动的应用程序中。

若要将 Dataverse 用作 MCP 服务器,需要为 Power Platform 环境启用和配置 MCP 服务器和允许的客户端。 配置后,可以使用不同的 MCP 客户端连接到 Dataverse MCP 服务器。 详细信息: 为环境配置 Dataverse MCP 服务器

Dataverse MCP 服务器 URL

Dataverse MCP 远程服务器 URL 遵循以下格式:

https://{dataverseOrgName}.crm.dynamics.com/api/mcp

例如,如果 Dataverse 组织名称为 contoso,则 MCP 服务器 URL 为:

https://contoso.crm.dynamics.com/api/mcp

连接到 Dataverse MCP 服务器

可通过多种方式连接到 Dataverse MCP 服务器:

工具列表

连接到 Dataverse MCP 服务器后,可以从 Power Platform 环境中的以下工具中进行选择。

工具 说明
search_data 搜索结构化和非结构化数据。
search 按关键字搜索表架构和业务技能。
create_record 向 Dataverse 表插入新行并返回 GUID。
update_record 更新 Dataverse 表中的现有行。
delete_record 仅在获得用户明确同意后,才删除一行。
create_table 创建具有指定架构的新表。
update_table 修改现有表的架构或元数据。
delete_table 仅在获得用户明确批准后,才会从 Dataverse 中删除一个表。
read_query 运行支持的 Dataverse SQL SELECT 查询。
describe 从表、记录、架构、技能和应用的搜索结果中获取详细信息。
upsert_skill 添加或更新 Dataverse 技能或操作手册。
delete_skill 按名称删除 Dataverse 技能/操作指南。
init_file_upload 生成用于文件上传的 SAS URL。
commit_file_upload 确认上传文件。
file_download 生成用于文件下载的 SAS URL。

Important

Dataverse MCP 服务器工具图面已更改。 以下工具已被移除,其功能已由上表中的工具替代:describe_tablelist_tablesfetch(由 describe 替代);以及之前用于搜索 Dataverse 数据的 search 工具(已重命名为 search_data)。 当前 search 工具搜索元数据。 如果按工具名称维护 MCP 客户端中的允许或拒绝列表,请查看配置,以便新工具名称反映预期权限。 更多信息:使用模型上下文协议连接到 Dataverse 常见问题解答

注释

从 2025 年 12 月 15 日开始,在 Microsoft Copilot Studio 外部创建的 AI 代理访问 Dataverse MCP 工具时,将收取费用。 如果你有 Dynamics 365 Premium 许可证(例如 Dynamics 365 Sales Premium、Finance Premium、Supply Chain Premium 和 Customer Service Premium)或 智能 Microsoft 365 Copilot 副驾驶® 用户订阅许可证(USL),则即使从 Microsoft Copilot Studio 外部访问该数据,也不会收取访问 Dynamics 365 数据的费用。

search_data 工具的计费标准与租户图谱锚定采用相同的 Copilot 额度率。 所有其他工具(包括元数据 search 工具)均遵循“文本和生成式 AI 工具(基础版)”的每 10 次响应 Copilot 额度率标准。 有关 Copilot 计费的信息,请转到 计费费率和管理

后续步骤

为环境配置 Dataverse MCP 服务器