内容
# pa-flow-mcp
免费、开源的MCP服务器，用于**实时编辑Power Automate云流**，可与GitHub Copilot、Codex或Claude Code等AI助手配合使用——类似于Power Apps外部工具，但适用于流程。在浏览器中打开流程，粘贴其网址，您的AI助手即可读取/写入流程定义、管理连接器并同步更改。
## 为什么
目前没有官方的Power Automate“外部工具”。此MCP提供与设计器相同的API，并让任何AI助手都能进行身份验证。免费供所有人使用。
## 功能
- **适用于Copilot和Claude Code的插件**：提供技能（`/configure-pa-flow-mcp`、`/edit-flow`、`/add-connector-action`、`/manage-runs`、`/report-issue`）和`flow-builder`子代理——与Microsoft的Power Platform技能具有相同的插件结构。
- **身份验证**：交互式浏览器登录（环回端口）、Azure CLI公共客户端、缓存令牌。无需az CLI或应用注册。
- **1250+连接器**：实时发现（`list_connectors`）+精选目录（SharePoint、Dataverse、SQL、Outlook、Excel、Teams）。
- **无连接引用错误**：`add_connector_action`自动连接`connectionReferences`和`parameters.$connections`。
- **本地 ↔ 流程同步**：拉取到`.pa-flow/<id>.json`，编辑，验证，推送。
- **设置向导**：URL + 登录 + 助手（Copilot/Codex/Claude）。
- **清晰的错误**：无访问权限/未找到时。
## 要求（最终用户）
- **Node.js 18+**（`node -v`）。
- **Power Automate许可证** + 访问您要编辑的流程。
- **GitHub Copilot CLI/Chat** 或 **Claude Code**（最新版）。
- 用于一次性登录的浏览器。无需管理员权限，无需Azure CLI。
## 安装
### A. 作为插件（推荐）
克隆并构建一次，然后在您的AI工具中注册本地市场。
```bash
git clone https://github.com/Mr-M-tastic/Power-Automate-MCP && cd pa-flow-mcp
npm install && npm run build
```
**Claude Code** — 从仓库文件夹：
```shell
/plugin marketplace add .
/plugin install power-automate@pa-flow
```
插件自动注册`pa-flow` MCP服务器（`.mcp.json`使用`${CLAUDE_PLUGIN_ROOT}`）并加载技能。然后运行`/configure-pa-flow-mcp`或直接说 *"编辑我的流程"*。
**GitHub Copilot** — 将 [.vscode/mcp.json](.vscode/mcp.json) 复制到您的项目中（已经提供）。重新加载VS Code；`pa-flow`工具和`skills/`下的技能将自动被拾取。
### B. 手动MCP配置
如果您不使用插件加载器，请直接让您的助手指向构建的服务器：
```json
{ "servers": { "pa-flow": { "command": "node", "args": ["dist/index.js"] } } }
```
Claude Code/Codex使用`mcpServers`键和`dist/index.js`的绝对路径。`AGENTS.md` / `CLAUDE.md`自动读取以供使用。
## 对流程运行（步骤）
您不需要手动运行命令 — 您与助手聊天，助手调用工具。
1. **在Power Automate中打开流程**，从地址栏复制网址：
`https://make.powerautomate.com/environments/<env>/flows/<flowId>`
2. **开始会话** — 告诉助手： *"为`<粘贴网址>`配置会话"* → 运行`configure_session`。
3. **拉取流程** — *"拉取流程"* → `sync_pull`。**第一次打开浏览器 — 使用工作账户登录。**令牌被缓存，因此登录仅需一次。工作副本写入`.pa-flow/<flowId>.json`。
4. **编辑** — 可以用纯英文询问（ *"添加SharePoint获取项目操作"* → `add_connector_action`，自动连接）或直接编辑`.pa-flow/<flowId>.json`。
5. **验证和推送** — *"验证然后推送"* → `validate_flow`然后`sync_push`。
6. **刷新浏览器标签页** — 您的编辑现在在设计器中生效。
### 在您的机器上创建的内容
- 工作副本：`.pa-flow/<flowId>.json`（安全的手动编辑）
- 缓存登录：`~/.pa-flow-mcp-token.json`
### 注意
- 无需Azure CLI、管理员权限或应用注册。
- 如果连接器显示 *"在创建者门户中创建连接"*，请在Power Automate中创建一次，然后重试推送。
## 可选环境变量
`PA_CLIENT_ID`、`PA_PORT`、`PA_API_BASE`、`PA_API_VERSION` — 如有需要，覆盖默认值。
## 技能（斜杠命令）
| 命令 | 描述 |
|---------|-------------|
| `/configure-pa-flow-mcp` | 从其设计器网址连接流程，登录，拉取本地 |
| `/edit-flow` | 拉取 → 编辑（操作/条件/触发器）→ 验证 → 推送 |
| `/add-connector-action` | 添加SharePoint/Dataverse/SQL/Outlook/Excel/Teams（或任意）连接器步骤 |
| `/manage-runs` | 开启/关闭流程，列出运行，重新提交，取消 |
| `/report-issue` | 打开带有诊断信息的预填充GitHub问题 |
参考文档，代理实时读取 [references/](references/) (`FlowAuthoring.md`、`Connectors.md`)；`flow-builder`子代理在 [agents/](agents/) 中一次应用一个批准的更改。
## 工具
`configure_session, setup_wizard, list_environments, list_flows, get_flow, update_flow, turn_on/off_flow, list_runs, resubmit_run, cancel_run, list_connectors, list_connections, ensure_connection, add_connector_action, sync_pull, validate_flow, sync_push`
## 相关的Microsoft工具
此插件遵循Microsoft的 [power-platform-skills](https://github.com/microsoft/power-platform-skills) （画布应用、模型应用、Power Pages）的约定。它专注于**云流程**；对于解决方案ALM、环境和Dataverse，请使用 [Power Platform CLI (PAC)](https://learn.microsoft.com/power-platform/developer/cli/introduction) 和 [Power Platform Tools VS Code扩展](https://learn.microsoft.com/power-platform/developer/howto/install-vs-code-extension)。
## 许可证
MIT
