在非Microsoft客户端中使用模型上下文协议连接到 Dataverse

使用非Microsoft模型上下文协议 (MCP) 客户端连接到 Microsoft Dataverse。 此示例介绍如何使用 Claude 进行连接。

先决条件

以下是将 Dataverse MCP 服务器与 Claude 配合使用的先决条件。

注释

目前仅支持 Claude 桌面。

为 MCP 配置创建 Dataverse 连接

  1. 转到 Power Automate。 如有必要,请从右上角选择环境,将其更改为正确的环境。

  2. 在左侧导航栏中选择连接,然后在命令栏中选择+ 新建连接

  3. 在搜索框中键入 Dataverse,然后选择 Microsoft Dataverse 连接器。

  4. 完成屏幕上的说明。

    记下连接 名称中的用户名,这应与之前用于创建环境的名称相同。

  5. 选择该连接,将其打开。 出现提示时粘贴此 URL。 https://make.preprod.powerautomate.com/environments/fb6637eb-601d-e9d2-b7f0-1613fca29e7e/connections?apiName=shared_commondataserviceforapps&connectionName=64244f45b6f045299463becb30bcd9b8

安装 Dataverse MCP 服务器本地代理

这些步骤将安装由 MCP 客户端(如 Claude 桌面或 VS Code GitHub Copilot)使用的 Dataverse MCP 服务器本地智能体。

  1. 从下载或使用此 PowerShell 命令安装 .NET SDK 8.0。

    winget install Microsoft.DotNet.SDK.8

  2. 在 Windows 终端窗口中,运行以下命令以安装Microsoft PowerPlatform.Dataverse.MCP 本地代理。

    dotnet tool install --global --add-source https://api.nuget.org/v3/index.json Microsoft.PowerPlatform.Dataverse.MCP

获取 Dataverse 环境的租户 ID

在为 Claude 桌面或 VS Code GitHub 配置 Dataverse MCP 服务器时,您需要提供 TenantID 值。

下面是获取租户 ID 详细信息的一种方法:

  1. 转到 Power Apps
  2. 选择右上角的设置(齿轮图标),然后选择会话详细信息
  3. 租户 ID 的值从 Power Apps 会话详细信息 复制到 Windows 剪贴板。 记下此 GUID,因为它将在稍后的配置步骤中使用。

在 Claude 中配置并使用 Dataverse MCP 服务器

Claude AI 是由 Anthropic 开发的大型语言模型 (LLM) 和聊天机器人。 它擅长自然语言处理并且是多模态的,这意味着它可以处理文本、音频和视频输入。 Claude 可以回答问题、总结文档、生成文本,甚至创建图表、动画和代码。

下载 Claude 桌面版

如果尚未这样做, 请下载并安装 Claude 桌面

安装 Claude 桌面后,可以从桌面找到并启动 Claude。

在 Claude 桌面中配置 Dataverse MCP 服务器

  1. 打开 Claude 桌面并转到文件>设置

  2. 如果您之前未在 Claude 桌面中配置过任何 MCP 服务器,将看到设置对话框。 选择编辑配置

  3. Claude 桌面文件将显示。 使用你喜欢的 claude_desktop_config.json JSON 编辑器打开该文件。

  4. 将连接 URL 和租户 ID 替换为<>< 和>租户 ID,并将 JSON 代码片段粘贴到文件的相应部分。 更多信息:创建 MCP 配置的 Dataverse 连接获取您 Dataverse 环境的租户 ID

    为您的 Dataverse MCP 服务器设置一个易于记忆的<友好名称>,例如:MyDataverseMCPServer

{
     "mcpServers": {
    "<friendly name>": {
      "command": "Microsoft.PowerPlatform.Dataverse.MCP",
      "args": [
        "--ConnectionUrl",
        "<URL for Dataverse connection>",
        "--MCPServerName",
        "DataverseMCPServer",
        "--TenantId",
        "<Tenant Id GUID>",
        "--EnableHttpLogging",
        "true",
        "--EnableMsalLogging",
        "false",
        "--Debug",
        "false",
        "--BackendProtocol",
        "HTTP"
         ]
       }
     }
   }
  1. 保存此文件并返回 Claude 桌面。

在 Claude 桌面软件中验证并与连接交互

  1. 重启 Claude 桌面并确保更改生效。 请选择“文件”>“退出”。
  2. 现在打开 Claude 桌面,因为之前的步骤中已经完成了 Dataverse MCP 服务器的配置。 您需要使用您的凭据登录到您的 Dataverse 环境。
  3. 通过选择搜索和工具,验证您是否可以查看 Dataverse MCP 服务器和工具。 您应该能够看到 Dataverse MCP 服务器的友好名称,例如 MyDataverseMCPServer 验证与 Dataverse 的 Claude 桌面连接
  4. 选择 MCP 服务器(MyDataverseMCPServer)可以查看该 MCP 服务器支持的工具列表。

小窍门

您可以为在 Claude 注册的每个 MCP 服务器启用和禁用单独的工具。 这使您可以控制要使用的工具。

在 Claude 桌面与 Dataverse MCP 服务器交互

如果您在 Dataverse 环境中有数据,可以通过 列出 Dataverse 中的表描述帐户表、或 我有多少账户 等等来开始测试您的设置。 更多信息:添加和删除示例数据

小窍门

如果已将其他 MCP 服务器注册到 Claude,最好在提示中添加 Dataverse,具体说明要使用的 MCP 服务器。

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