Agent 生态的外挂能力正在快速扩张，本周 GitHub 周榜十一个席位里八个是 agent 技能与插件仓库。能力扩张把接线成本推到了台前：每个 agent 一份手写 MCP 配置，端点、传输、鉴权与来源追踪 header 全靠抄文档。阿里云百炼 CLI 的 bl mcp connect 子命令把接线做成了平台能力：connect 生成配置并记账，tools 与 call 提供终端预验，disconnect 受保护卸载。组内鉴权分工为 connect/tools/call 走 API Key、disconnect 为 No Auth 纯本地；help 另明示模型 base-url 不改变 MCP 端点（本版本注册官方中国站端点），接线层与模型调用层解耦。本文从平台能力栈视角说明这组命令的工程边界。
能力栈位置：接线层独立于模型调用层
bl 的命令面里，模型调用（text、image、video、omni 等）与接线（mcp 组）是两层。接线层不产生模型调用，它管理"agent 如何发现并访问百炼侧 MCP 服务"：connect 把服务码解析为官方端点，写入 agent 私有配置的 mcpServers 条目，含 httpUrl 与四个 header（Authorization 加三个来源追踪 header）；同时在主目录维护 managed 账本，记录端点、传输、路径、sha256 指纹、CLI 版本与更新时间。
这带来三个平台级性质：配置生成器化（header 集合由 CLI 维护，文档变更不落到用户抄写层）、重接幂等（未改动重接返回 unchanged）、卸载可审计（disconnect 依指纹判定，只删自己写的那份）。
生命周期与保护边界
隔离环境实测四态：added、unchanged、conflict、removed。预置的非托管条目在 connect 前后逐字节不变，与帮助文本"既存非托管条目永不被覆盖"一致。唯一不自愈路径是手改受管条目：connect 与 disconnect 均返回退出码 1 的 conflict，要求手工解决，不覆盖用户修改。企业落地时应把"受管条目禁止手改"写入配置管理规范。
遥测与审计面
connect 的写入之外还有两条平台级留痕。其一，managed 账本字段完整可审计：endpoint、transport、path、sha256 fingerprint、cliVersion、updatedAt，卸载判定依指纹而非配置内容。其二，telemetry.jsonl 逐命令追加（命令名、durationMs、success、authMethod），实测 connect 一行 1204ms 与 apiKey，可作为接入审计的现成数据源；该文件与密钥副本同处主目录，治理边界应与配置文件一致。
终端预验：把可用性检查左移
tools 子命令对端点发 tools/list，返回工具名与完整 inputSchema；call 子命令以 server.tool 为 target 真调，实测一次图像生成调用四点四秒返回 isError=false，返回体 content 的 text 为二次 JSON 字符串，集成方需再 parse 一层。预验把"服务是否开通、工具名与参数形状是否正确"从 agent 会话试错前移到终端断言，适合写进 CI 式的接入校验。schema 侧的硬边界同样应进校验：正向提示词八百字符截断、反向五百截断、尺寸缺省 1328*1328、数量缺省 1；call 返回的 request_id 与签名临时 URL（实测图 1024 见方、1,133,265 字节、带过期时间）应进留痕规范。
错误分层与鉴权边界
错误阶梯三层：客户端白名单错退出码 2（报错枚举合法值）；服务端业务错退出码 1（错服务码回 404「MCP服务不存在」、错工具名回 Tool Not Found）；鉴权面错退出码 3（list 目录枚举需 Console 登录）。当日 Console 会话过期，目录枚举不可用，服务码来源限于帮助示例与市场页，此边界应在接入文档中明示。自建非百炼端点可经 tools/call 的 url override 直连，但不在 connect 的托管与指纹保护范围内。
四态状态字（added/unchanged/conflict/removed）与遥测行（durationMs、success、authMethod）均可直接进监控断言与接入审计报表；建议将「connect 后断言状态字、call 后断言 isError」作为接入流水线的两个机器检查点。
适用建议
多 agent 并行、需统一接入同一批百炼 MCP 服务的团队，connect 把 N 份手写配置收敛为 N 次命令加一本账本，卸载可审计；单 agent 且服务数少的场景，图形化入口更直观。安全侧三条规范必须随接入下发：agent 配置文件中的 Authorization 为 Key 明文副本，按密钥文件管理；受管条目禁止手改、要改先 disconnect；接入后先 tools 后 call、isError 为 false 才放量。版本治理另记一条：CLI 启动横幅提示可升级（本包取数 2.5.0），升级后重跑四态与错误阶梯探针。接入入口见CLI 安装页与控制台密钥管理页。
