用途：为 Flexport 的两个公开接口面（REST v3 与 MCP 工具）设计类型化适配器，把传输、认证、错误模型与分页差异封装在业务级接口之后，避免将两种载荷强行合并为有损模型。
主要能力：定义业务端口（如 readShipment、browseRisk、evaluateRate）；分别构建 REST 适配器与 MCP 适配器；运行时校验；对两个接口面做契约测试。
使用方式：REST 适配器使用基址 https://api.flexport.com、Bearer 认证、可选 Flexport-Version 头、文档化信封、status/code/message 错误与 link 式分页。MCP 适配器使用 POST https://mcp.flexport.com/mcp 的 Streamable HTTP JSON-RPC，参考页中的每工具路径视为合成文档而非真实 REST 路由。认证上，REST 使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌（audience 为 https://api.flexport.com）或显式接受的宽泛 API 密钥，按工作负载区分凭据且不得记录凭据或令牌；MCP 使用到 https://mcp.flexport.com/mcp 的已认证连接，并受各工具文档化账户权限约束。
适用场景：构建客户端库、响应校验、契约测试，以及需要同时对接 REST 与 MCP 的物流平台集成。
限制：需先盘点所需 REST 端点与 MCP 工具、固定账户/版本行为与模式快照日期，并准备运行时校验、脱敏、超时与测试夹具策略。运行时接受文档化的新增字段，保留不透明标识符与游标，缺失必填字段时隔离响应而非猜测替换。传输结果不明确时应核对操作而非盲目重试变更。输出为可机器审查的回执，不得包含凭据或提供方载荷。具体价格、平台支持范围等资料暂未提供。