为GitHub Copilot配置Dataverse MCP

本Skill用于为GitHub Copilot配置与你的组织环境URL关联的Dataverse MCP服务器。每个组织都会基于组织标识符注册一个唯一的服务器名称（例如：

DataverseMcporgbc9a965c

）。如果用户提供了URL，该URL为：$ARGUMENTS。

操作步骤

0. 询问MCP作用范围

请问你希望将MCP服务器配置为全局可用还是仅当前项目可用：

请问你希望配置Dataverse MCP服务器的范围：

全局（所有项目中可用）

仅项目（仅当前项目中可用）

根据用户的选择设置

CONFIG_PATH

变量：

全局：
```
~/.copilot/mcp-config.json
```
（使用用户的主目录）
项目：
```
.mcp/copilot/mcp.json
```
（相对于当前工作目录）

保存此路径，以便在步骤1和步骤6中使用。

1. 检查已配置的MCP服务器

读取步骤0中确定的

CONFIG_PATH

路径下的MCP配置文件，检查已配置的服务器。

配置文件为JSON格式，结构如下：

json

{
  "mcpServers": {
    "ServerName1": {
      "type": "http",
      "url": "https://example.com/api/mcp"
    }
  }
}

或者，顶层键可能使用

"servers"

而非

"mcpServers"

。

提取所有已配置服务器的

url

值并存储为

CONFIGURED_URLS

。例如：

json

["https://orgfbb52bb7.crm.dynamics.com/api/mcp"]

如果文件不存在或为空，则将

CONFIGURED_URLS

视为空数组（

[]

）。此步骤不得阻塞Skill的执行。

2. 询问环境URL的提供方式

询问用户：

你希望如何提供Dataverse环境URL？

自动发现 — 从你的Azure账户列出可用环境（需要Azure CLI）

手动输入 — 直接输入URL

根据用户的选择：

如果选择自动发现：继续执行步骤2a
如果选择手动输入：跳至步骤2b

2a. 自动发现环境

检查前置条件：

验证Azure CLI（
```
az
```
）是否已安装（在Windows上使用
```
which az
```
或
```
where az
```
检查）
如果未安装，告知用户并回退到步骤2b

调用API：

检查用户是否已登录Azure CLI：
bash
```
az account show
```
如果此命令失败，提示用户登录：
bash
```
az login
```

获取Power Apps API的访问令牌：

bash

az account get-access-token --resource https://service.powerapps.com/ --query accessToken --output tsv

调用Power Apps API列出环境：

GET https://api.powerapps.com/providers/Microsoft.PowerApps/environments?api-version=2016-11-01
Authorization: Bearer {token}
Accept: application/json

解析JSON响应，过滤出

properties?.linkedEnvironmentMetadata?.instanceUrl

不为空的环境。

对于每个匹配的环境，提取：

```
properties.displayName
```
作为
```
displayName
```

properties.linkedEnvironmentMetadata.instanceUrl

（移除末尾斜杠）作为

instanceUrl

按以下格式创建环境列表：

json

[
  { "displayName": "我的组织（默认）", "instanceUrl": "https://orgfbb52bb7.crm.dynamics.com" },
  { "displayName": "其他环境", "instanceUrl": "https://orgabc123.crm.dynamics.com" }
]

如果API调用成功，继续执行步骤3。

如果API调用失败（用户未登录、网络错误、未找到环境或其他任何错误），告知用户错误原因并回退到步骤2b。

2b. 手动输入 — 请求用户提供URL

请用户直接提供环境URL：

请输入你的Dataverse环境URL。
示例：
https://myorg.crm10.dynamics.com
你可以在Power Platform管理中心的“环境”页面找到该URL。

然后跳至步骤4。

3. 请用户选择环境

将环境以编号列表的形式展示。对于每个环境，检查

CONFIGURED_URLS

中是否有以该环境的

instanceUrl

开头的URL，如果有，则在该行末尾追加**（已配置）**。

我在你的账户中找到了以下Dataverse环境。你希望配置哪一个？
我的组织（默认） —
https://orgfbb52bb7.crm.dynamics.com
（已配置）
其他环境 —
https://orgabc123.crm.dynamics.com
输入你选择的编号，或输入“manual”手动输入URL。

如果用户选择了已配置的环境，在继续之前需确认用户是否要重新注册（例如，更改端点类型）。

如果用户输入“manual”，则回退到步骤2b。

4. 确认所选URL

获取所选环境的

instanceUrl

（或手动输入的URL），并移除末尾的斜杠。此URL将作为后续Skill执行中的

USER_URL

。

5. 确认用户希望使用“预览版”还是“正式版（GA）”端点

询问用户：

你希望使用哪个端点？
正式版（GA） —
/api/mcp
（推荐）
预览版 —
/api/mcp_preview
（包含最新功能，可能不稳定）

根据用户的选择：

如果选择正式版（GA）：将
```
MCP_URL
```
设置为
```
{USER_URL}/api/mcp
```
如果选择预览版：将
```
MCP_URL
```
设置为
```
{USER_URL}/api/mcp_preview
```

6. 注册MCP服务器

更新步骤0中确定的

CONFIG_PATH

路径下的MCP配置文件，添加新服务器。

从
USER_URL
生成唯一的服务器名称：

从URL中提取子域名（组织标识符）
- 示例：
```
https://orgbc9a965c.crm10.dynamics.com
```
  →
```
orgbc9a965c
```
在前面添加
```
DataverseMcp
```
以创建服务器名称
- 示例：
```
DataverseMcporgbc9a965c
```

此名称即为

SERVER_NAME

。

更新配置文件：

如果
```
CONFIG_PATH
```
是项目范围的配置文件（
```
.mcp/copilot/mcp.json
```
），请先确保目录存在：
bash
```
mkdir -p .mcp/copilot
```
读取
```
CONFIG_PATH
```
路径下的现有配置文件，如果文件不存在则创建一个空配置：
json
```
{}
```
确定要使用的顶层键：
- 如果配置文件中已存在
```
"servers"
```
  ，则使用该键
- 否则，使用
```
"mcpServers"
```

添加或更新服务器条目：

json

{
  "mcpServers": {
    "{SERVER_NAME}": {
      "type": "http",
      "url": "{MCP_URL}"
    }
  }
}

将更新后的配置以正确的JSON格式（2空格缩进）写回
```
CONFIG_PATH
```
。

重要注意事项：

不得覆盖配置文件中的其他条目
保留现有结构和格式
如果
```
SERVER_NAME
```
已存在，使用新的
```
MCP_URL
```
更新该条目

继续执行步骤7。

7. 确认配置成功并提示重启编辑器

告知用户：

✅ 已为GitHub Copilot配置Dataverse MCP服务器，地址为
{MCP_URL}
。
配置已保存至：
{CONFIG_PATH}
重要提示：你必须重启编辑器才能使更改生效。

重启编辑器或重新加载窗口后，你将能够：

列出Dataverse环境中的所有表

查询任意表中的记录

创建、更新或删除记录

浏览你的数据架构和关系

8. 故障排除

如果出现问题，帮助用户检查以下内容：

URL格式是否正确（
```
https://<组织>.<区域>.dynamics.com
```
）
他们是否有权访问该Dataverse环境
环境URL是否与Power Platform管理中心中显示的一致
他们的环境管理员是否已在“允许的客户端”列表中启用了“Dataverse CLI MCP”
他们的环境是否已启用Dataverse MCP，如果使用预览版端点，该端点是否已启用
对于项目范围的配置，确保
```
.mcp/copilot/mcp.json
```
文件已成功创建
对于全局配置，检查
```
~/.copilot/
```
目录的权限

mcp-configure

NPX安装

标签

SKILL.md 内容（中文）

为GitHub Copilot配置Dataverse MCP

操作步骤

0. 询问MCP作用范围

1. 检查已配置的MCP服务器

2. 询问环境URL的提供方式

2a. 自动发现环境

2b. 手动输入 — 请求用户提供URL

3. 请用户选择环境

4. 确认所选URL

5. 确认用户希望使用“预览版”还是“正式版（GA）”端点

6. 注册MCP服务器

7. 确认配置成功并提示重启编辑器

8. 故障排除