用途:在一个 API 组合范围内,把一条统一(canonical)策略一次性应用到多个网关(Kong、Apigee、Azure、AWS、MuleSoft)上的多个 API 实例。触发场景包括“让我所有 finance 标签的 API 都启用 JWT 校验”“组合范围”“缺少此策略”“统一/规范策略”等。不适用于查询已有防护、修改已应用的原生策略、单实例原生插件、走 Anypoint REST、需要先创建实例或部署网关,以及移除、解绑、启用/禁用策略。
前置条件:需连接 MuleSoft Platform MCP Server(urn:mcp:mulesoft-platform)。先调用 list_universal_policies 探测;若工具不在目录中,停止并说明该主机目录尚无统一策略工具,不得改用 Anypoint REST;若返回未配置(not_configured 或带该消息的空策略列表),说明并停止;遇到 403/权限错误,说明无权限并停止,不得静默切换提供方或组织。
使用方式:第一步发现与缺口探查,调用 find_assets,传 query、asset_type(api)、user_query、include_applied_policies=true、policy_name_filter、必要时提高 max_results(默认 20);若 userOrgAssets 为空则说明未找到并停止。展示按实例列表,按 policyCoverage 判断:all 跳过,partial/none 只对 instancesMissingPolicy 中并集实例应用,unknown 用 view_api_instance_policies 复查,不算缺失。等待用户明确确认后再继续。第二步选择统一策略并展示配置 schema,调用 list_universal_policies;多个模板匹配时让用户选择,丢弃 provider 不在 supportedProviders 的目标实例。第三步展示原生映射预览后确认,调用 apply_universal_policy 一次,传 policy_name、instance_ids、configuration。第四步等待完成:accepted 时轮询 get_policy_operation_status 直到 COMPLETED 或 FAILED;ok 为同步成功直接报告;partial 报告部分成功;FAILED 时说明 error.retryable 是否可重试。
限制:策略附着于已部署实例而非 API,判断覆盖需用 policyCoverage 与 instancesMissingPolicy,不能仅凭 hasPolicy;展示字段需按 references/payloads.md 关联,不得凭空编造名称或提供方;不允许循环调用 apply_policy_to_instance 处理统一模板;不支持撤销、移除、解绑或启停策略;每个环境策略行为可能受组织权限与分页上限影响。