SuperAPI AI 工具集

power-automate-mcp

智能体与模型

查看项目

更新于 10-16 01:39

技能介绍

该技能是 Power Automate 通过 FlowStudio MCP 接入的“管道层”,让 AI 代理可靠连接 MCP 服务器、发现可用工具并干净地解析响应。实际工作流逻辑由四个专业子技能承载:power-automate-build(构建、修改、修复、部署流)、power-automate-debug(对失败运行做根因分析)、power-automate-monitoring(租户级流健康、失败率、资产清单,Pro+)、power-automate-governance(标记、审计、分类、评分、下线流,Pro+)。

前置条件:FlowStudio MCP 订阅或兼容的 Power Automate MCP 服务器;MCP 端点为 https://mcp.flowstudio.app/mcp;需要 API密钥/JWT(放在 x-api-key 头,不是 Bearer);以及 Power Platform 环境名(形如 Default-<tenant-guid>)。在 ChatGPT 或 claude.ai 中无需密钥,添加 https://mcp.flowstudio.app/mcp/oauth 作为连接器并用 Microsoft 登录。

工具发现:服务器(v1.1.5+)提供两个非计费元工具。冷启动时可调用 list_skills 查看可用包(build-flow、create-flow、debug-flow、monitor-flow、discover、governance);用 tool_search 查询 skill:<name> 加载某一包的完整模式,或用 select:tool1,tool2 按名加载特定工具,也可用自由文本关键词搜索。优先使用这些元工具,而非 tools/list 或猜测工具名。

推荐使用 Python 或 Node.js 编写核心助手。Python 用标准库 urllib.request,无需 pip 安装;Node.js 需 18+,使用内置 fetch。两者都处理 JSON-RPC 封装、认证与响应解析。认证头为 x-api-key:<JWT>,令牌为普通 JWT,不要剥离、修改或加前缀。大响应场景(如 get_live_flow_run_action_outputs)建议超时 ≥120 秒。

常见错误:HTTP 401/403 表示令牌缺失、过期或格式错误,需获取新的 JWT;HTTP 400 表示 JSON-RPC 载荷格式错误,检查 Content-Type: application/json 与请求体结构;MCP 错误 -32602 表示工具参数错误或缺失,可用 tool_search 的 select:<toolname> 确认schema。

响应过大处理:describe_live_connector(100-600KB,完整 Swagger)、get_live_dynamic_properties(50-500KB)、get_live_flow_run_action_outputs 不带 actionName(50KB 至数 MB)、get_live_flow(大型流 50-500KB)、list_live_flows(大型租户 50-200KB)都可能溢出上下文。代理框架会把超大响应保存到临时文件,文件为双重包裹,需两次解析:先 json.loads 读文件,再取 [0]["text"] 解析内层 JSON。原则:只提取所需字段,不要回显全量;调用 get_live_flow_run_action_outputs 时始终传 actionName(否则获取所有顶级动作,foreach 内动作不带 iterationIndex 会返回每次重复);同一会话内缓存并复用溢出文件;不要直接 grep 溢出文件的 JSON 键,因为字符串被 JSON 转义,应先解析再过滤;向用户摘要而非原始 JSON。

限制:本文档未提供定价、具体价格、实际效果数据或完整使用步骤,这些信息暂未提供。文档与真实 API 响应冲突时以 API 为准,工具 schema 可能滞后,调用前可用 tool_search 确认当前形态。