1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | power-platform-mcp-connector-suite-github-awesome-copilot |
| 作者/维护者 | GitHub 官方组织账号（github/awesome-copilot，社区贡献内容经官方仓库审核合并） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/power-platform-mcp-connector-suite |
| 许可证 | MIT（仓库级，GitHub API 实测确认） |
| GitHub Stars | 合集仓库整体 38,977 stars（GitHub API 实测）；该数字属整个合集，不代表本技能自身热度 |
| Forks | 合集仓库整体 4,939 |
| 最新版本 | 无独立版本号，随仓库滚动更新（本技能文件最近一次修改于批量转换提交，仓库整体持续活跃维护） |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill power-platform-mcp-connector-suite，或克隆仓库后复制 skills/power-platform-mcp-connector-suite/ 到本地 skills 目录 |
2. 功能介绍与亮点
该技能面向已在开发 Model Context Protocol（MCP）服务的开发者，指导生成一套完整的 Power Platform 自定义连接器，用于把该 MCP 服务接入 Microsoft Copilot Studio。核心产出包括四个文件：apiDefinition.swagger.json（含 x-ms-agentic-protocol: mcp-streamable-1.0 协议头）、apiProperties.json（连接器元数据与鉴权配置）、script.csx（JSON-RPC 2.0 消息转换逻辑）与配套 readme.md。
技能提供六种工作模式：从零生成新连接器、校验既有 schema 是否符合 Copilot Studio 约束（禁止 $ref 引用类型、字段必须单一类型等）、诊断集成故障、为既有连接器追加 MCP 能力、准备微软官方认证提交材料，以及按 MCP 安全最佳实践加固 OAuth 2.0（含 token 受众校验、状态参数防 CSRF、防“confused deputy”攻击等具体条款）。技能本身只生成配置与代码文件，不代替用户执行 paconn / pac CLI 命令，生成物需要用户自行运行官方工具完成校验与发布。
3. 适用场景
所属分类：集成与工作流自动化
适用于已经拥有一个可运行 MCP 服务、需要把它接入 Microsoft Copilot Studio 智能体的 Power Platform 开发者与解决方案架构师。典型场景包括：为企业内部系统（CRM、工单系统等）新建 MCP 连接器、修复现有连接器在 Copilot Studio 中“工具被过滤”“连接失败”等常见故障、把连接器提交微软官方连接器市场认证，以及为已上线连接器补齐 OAuth 安全加固。
4. 跨 Agent 兼容性
| 生态 | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | SKILL.md 仅含 name/description 两个 YAML 字段，符合通用 Agent Skills 规范，可直接放入 .claude/skills/ |
| Codex | ✅ 原生支持 | Codex CLI 从 .codex/skills/ 或 .agents/skills/ 读取同规范 SKILL.md（官方文档确认） |
| OpenClaw | ✅ 原生支持 | OpenClaw 官方文档确认支持在 .agents/skills/ 目录下按深度扫描发现 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 遵循 agentskills.io 开放标准，官方生态资料确认与 OpenClaw/Hermes Agent 均兼容 |
5. 推荐理由
该技能系统覆盖“MCP 服务接入 Copilot Studio 连接器”全链路（生成→校验→排障→认证→安全加固），六种模式对应开发生命周期的不同阶段，内置的 Copilot Studio schema 硬约束清单（禁止引用类型、单一类型字段等）是官方文档里分散的细节，被整理成可直接核对的检查表，能替开发者省去反复试错的过程。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 GitHub 是公认的一线科技厂商，本仓库由其官方组织账号直接维护；未查到该技能自身独立于合集之外的第三方评价或采用数据 |
| 可用性 | 7 | 步骤清晰、六种模式分工明确，但需要读者已具备 MCP 服务与 Power Platform 连接器基础知识，并自行安装 paconn/pac CLI 完成校验发布 |
| 安全性 | 9 | 纯提示词/模板类技能，仅生成配置与代码文件，不执行任何命令、不联网外发数据；MIT 许可证明确，无可疑指令 |
综合评分：7.67
安全检查清单逐项结果：① 不执行 shell 命令，仅生成待用户自行运行的代码/配置文件 ② 技能本身不联网 ③ 生成物支持 OAuth2/API Key 等鉴权方案，但只是生成指导，不涉及本机凭据存储 ④ 未发现可疑指令或隐蔽外发 ⑤ 官方审核合并的仓库，作者信誉良好 ⑥ MIT 许可证明确 ⑦ 仓库持续活跃维护。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| mcp-copilot-studio-server-generator | 生成面向 Copilot Studio 的 MCP 服务器骨架代码 | 只覆盖服务器端脚手架搭建，不含连接器 schema 校验、故障诊断与认证发布流程 |
| Swift/Kotlin/Go 等语言版 MCP Server Generator 系列 | 按目标编程语言生成通用 MCP 服务器实现 | 面向服务器实现本身，不涉及 Power Platform 连接器层与 Copilot Studio 的对接细节 |
| mcp-create-adaptive-cards | 为已接入的 MCP 插件生成 Adaptive Card 可视化响应模板 | 解决的是响应展示层问题，前提是连接器已经打通，与本技能处于链路的不同环节 |
三者与本技能大致构成“MCP 服务器实现 → Power Platform 连接器接入 → 富媒体响应展示”的链路，各自服务不同阶段，功能互补而非重叠。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；公开可查的引用均为技能聚合站点对 SKILL.md 内容的转载，未见独立使用体验描述。
9. 安装使用方式
- 方式一（推荐）：
npx skills add https://github.com/github/awesome-copilot --skill power-platform-mcp-connector-suite - 方式二：克隆
github/awesome-copilot仓库，将skills/power-platform-mcp-connector-suite/目录复制到本地 agent 的 skills 目录下（如.claude/skills/、.codex/skills/、.agents/skills/） - 安装后无需重启，在对话中提及“生成 Power Platform MCP 连接器”等意图即可触发；使用前需已具备可运行的 MCP 服务，并本机安装微软官方
paconn（Power Platform Connector CLI）与pac（Power Platform CLI）工具用于后续校验与发布。
10. 注意事项
- 技能只生成文件与操作指引，不会自动执行
paconn validate/pac connector create等命令，仍需用户在本机具备相应 CLI 环境； - Copilot Studio 当前仅支持 MCP 的 Tools 与 Resources 能力，Prompts 尚不支持，生成的连接器会受此限制；
- 提交微软官方认证前的图标规格（PNG，230×230 或 500×500）等细节需额外核对，技能仅列出清单，不做自动校验。