// 报错 · 给 agent 接工具（MCP、CLI、鉴权）
远程 MCP 服务器 OAuth 授权失败
远程（HTTP）MCP 服务器通常用 OAuth 授权。授权失败多半是客户端不支持对应流程、回调地址不匹配，或令牌过期没有刷新。
核实于 2026-10-102 个官方来源
现象
- 浏览器授权页打不开或报 redirect_uri 错误
- 授权成功后一段时间工具调用返回 401
常见原因
- 客户端版本不支持远程 MCP 的 OAuth 或动态客户端注册（DCR）
- 在服务方后台登记的回调地址和客户端实际使用的不一致
- 令牌过期，客户端没有自动刷新
- 请求的权限范围（scope）不够
解决步骤
- 确认客户端文档写明支持远程 MCP 授权；不支持时改用服务方提供的个人访问令牌（PAT）方式
- 用 MCP Inspector 连接同一个远程地址，单独走一遍授权流程，区分是服务端还是客户端的问题
- 核对服务方后台登记的回调地址
- 在客户端里清除该服务器的授权状态后重新登录
- 只申请任务需要的最小权限范围
注意
- 令牌等同密码，不要写进仓库
官方参考
2026-10-10 根据官方文档和公开讨论整理，尚未在本站环境复现；与官方文档不一致时以官方为准。