用途:为 Flexport 集成建立 CI 门禁,要求必需通道在无 Flexport 密钥下运行且对 fork 安全,实时验证放在受保护、非 fork、只读且需环境审批的可选通道中。
主要能力与用法:第一步构建必需通道,完全基于夹具校验模式、容忍性附加字段、分页、错误分类、webhook 原始正文签名与变更防护;第二步测试密钥缺失,断言默认测试无法解析 Flexport 凭据或触达实时变更适配器;第三步保护 fork 执行,绝不对不可信 PR 代码暴露仓库或环境密钥,必需检查保持无凭据;第四步定义可选实时通道,仅在可信引用且环境审批后运行,注入限定范围凭据并允许一次有记录的只读验证;第五步阻止变更,在适配器层强制 CI 策略,即使存在凭据也拒绝 booking、document、invoice 或 purchase-order 写入;第六步发布凭据,附上测试数量、夹具/来源日期、发布 SHA 与已脱敏的实时结果,绝不上传令牌或提供方载荷。
认证与限制:REST 调用使用缓存的 OAuth 2.0 客户端凭据 Bearer 令牌(audience 为 https://api.flexport.com)或明确接受的宽泛 API 密钥;MCP 调用使用对 https://mcp.flexport.com/mcp 的已认证连接,仍受各工具账户权限约束。需为不同工作负载使用不同凭据,不得记录凭据或令牌。发现用 Read 和 Grep,Write/Edit 仅用于本工作流批准的产物,不得做未批准的 Flexport 侧变更。输出需为限定范围的决策或实现产物、脱敏的操作与验证凭据、失败回滚与后续责任记录。错误处理包括:fork 可读密钥须立即停用并修复权限;夹具含生产数据须替换并清除;实时作业可变更须令策略门禁失败并移除写路径;出现模式漂移须依据最新一方文档更新并添加回归夹具。