用途：为 Flexport 集成提供参考架构，把 REST v3、MCP 与 Webhook 三类接口明确分离，避免契约混淆。
主要能力：区分 REST v3 资源操作、MCP Streamable HTTP JSON-RPC 权限化助手工具、签名 Webhook 通知；按读取、变更、事件、助手工具拆分能力清单；划分身份、账户、环境与数据流边界。
使用方式：先画出 api.flexport.com、mcp.flexport.com/mcp 与公网 HTTPS Webhook 入口三个外部节点；按端点划分 OAuth 客户端、MCP 会话与独立 Webhook 密钥；在预订/贸易变更前放置业务审批与策略；持久化操作键、提供方引用、事件去重状态、游标检查点与脱敏结果；用授权 REST 读取对账事件与不确定结果；验证令牌缓存失败、权限拒绝、模式变更、重复/丢失事件、模糊变更与回滚等失败路径。REST 使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌，受众为 https://api.flexport.com，或明确接受的宽泛 API 密钥；MCP 使用 https://mcp.flexport.com/mcp 的已认证连接。
适用场景：需要审批、操作台账、队列与恢复要求的物流集成设计。
限制：不得记录凭据或令牌；Webhook 投递不可作为唯一事实来源；不得进行未批准的 Flexport 侧变更。具体价格、平台与效果资料暂未提供。