MCP 连接只显示 Cancelled via...（真实 401 认证错误被掩盖）

你会遇到什么

Agent 里接 MCP server，连接失败只给你一句 Cancelled via...——没有 401、没有权限提示，看起来像"被取消了"。你按"取消"排查（重试、看超时），方向全错：真实错误是 HTTP 401 认证失败，只是被错误处理层包装成了取消语义。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

先给结论：MCP 错误处理缺陷——HTTP auth 401 被包装成 Cancelled via...，真实错误名丢失（issue #7699/#7704/#7656，open 2026-08，维护者正在修复为命名真实错误）。

链路：MCP client 发起 HTTP 请求 → 服务端返回 401 → 客户端错误包装层 → 显示为「Cancelled」。断点在第三步：错误语义映射缺失——你看到的是包装后的症状，不是根因。

推论：看到 Cancelled 不要按取消语义排查；先验证凭据与权限（大多数真实原因就是 401/scope 不足），或用 curl -i 直连 MCP HTTP 端点直接看状态码——绕开包装层，拿到原始错误。

未实测说明：完整链路需要 LLM provider/Azure Foundry，本环境未实测（如实标注）；判定依据 = 上游 issue（三家编号同现象）+ 错误处理机制。

一步步来

1. 直连端点验证 — 必做

curl -i 看状态码：401/403 = 凭据问题（真实根因）；200 但仍 Cancelled = 继续查下一条。

2. 核对凭据与权限 — 必做

API key/头是否带对、scope 是否覆盖该 MCP server 的能力面。

3. 升级到修复版 — 按场景

上游修复（命名真实错误）合入并发版后，升级 agent-framework 即恢复可读错误信息。

4. 仍无法定位 — 排查

抓 MCP client 侧日志/抓包确认请求确实到达端点；带上原始请求信息跟进 issue。

怎么确认修好了

• 连接失败时报出真实的 401/403/命名错误，而不是 Cancelled；
• 凭据修正后 MCP 连接正常建立。

其它环境的表现

• 企业/Azure Foundry 链路：认证层更多，401 掩盖更容易误导排查；
• 本地 stdio 型 MCP：错误形态不同（无 HTTP 状态码），本条目主要覆盖 HTTP 传输型；

症状

MCP 连接失败，客户端只显示 "Cancelled via..."，看不到真实认证错误（401）。

原因

MCP 错误处理缺陷：HTTP auth 401 被包装成 "Cancelled via..."（issue #7699/#7704/#7656，open 2026-08），维护者正在修复为命名真实错误。

解法

1. 先核对凭据与 scope（真实原因多为 401/权限不足），不要按 Cancelled 语义排查。
2. 升级 agent-framework 到含错误修复的版本（修复合入后）；临时绕开：直接 curl MCP HTTP 端点验证凭据（curl -i 看 401/403）。