MCP 接入 OAuth 后仍需补齐工具授权
文章说明 MCP 授权中的令牌校验与受众约束,并指出具体用户能否以特定参数执行工具,仍需服务端自行判断和记录。案例进一步讨论凭据暴露给模型,以及上游拒绝被自然语言回答掩盖的问题。
AI 深度解读
MCP 接上 OAuth,并不代表 Agent 已经获得了正确的业务权限。原文最重要的判断是:令牌可以证明请求面向哪个服务,却不能替你判断这个人能否给这个订单退这笔钱。后一个决定,必须由服务端在调用发生前做出,并留下记录。
作者结合 Solarpunk、Skionis 和 AVOX 的项目经验,把凭证隔离、工具设计、运行级令牌、拒绝反馈和审计串成了一条执行路径。对正在用 Node 搭 MCP 服务、让 AI 操作业务系统的团队,这套拆分值得参考。不过,协议版本描述、项目经验和外部案例,需要分开看。
OAuth 管入口,业务规则管每一次调用
按原文对 2026-07-28 版规范的描述,HTTP 上采用授权机制的 MCP 服务是 OAuth 2.1 资源服务器:发布受保护资源元数据,声明授权服务器;客户端获取令牌时,通过 RFC 8707 的 resource 参数指定目标服务;此后每次请求携带令牌,服务端检查其受众。无效或过期令牌返回 HTTP 401。
这些检查回答的是「这张票能否进入这个服务」。files:write 没有说明可以写哪个文件,更没有说明退款限额、客户归属和任务边界。作者因此建议把登录留给现有身份提供方,MCP 服务负责验票,再执行具体授权规则。
令牌有效,只是进入业务权限检查的条件。
调用上游系统时,还要分清两套凭证。客户端的 MCP 令牌不能直接透传给支付 API;服务端应持有或获取支付系统自己的凭证,在适配器内部附加。作者称,Solarpunk 把凭证放在用户设备的加密保险库中,模型只负责推理,工具执行时才注入密钥。
原文还称,该版协议已移除 initialize 握手和 Mcp-Session-Id,每次请求携带协议版本、客户端能力和令牌。跨调用状态通过显式句柄返回,句柄绑定到已验证用户,不能拿着句柄就跳过认证。这些属于具体版本行为,落地前应核对所用 SDK 与规范,不能直接套到旧服务上。
工具参数越自由,授权边界越难写清
refund_order 接收订单 ID 和金额,策略可以检查订单归属与金额上限。run_sql、http_request、shell 则把实际操作藏在参数里,同一个工具名可以执行大量不同动作。
原文把后一类称为逃生口工具(escape hatch)。问题在于,一次「允许调用」可能放行一整类程序,仅记录工具名也无法解释究竟执行了什么。
作者称,面向真实 AWS 账户的 Skionis 只使用封装提供方 API 的专用工具,不提供通用 shell;Solarpunk 在超过一百个集成中,也要求工具声明输入、输出和副作用。这样才能针对可枚举的动作写策略。
确实需要通用工具时,作者建议使用独立的短期凭证、网络白名单,并逐次交给人批准,避免与普通工具共用运行令牌。一个接收任意自由文本的 playbook,也不能仅凭名字就当成边界清楚的操作。
运行令牌随后承担另一层约束:它属于发起任务的人,只包含本次可用工具,并在任务结束后失效。缺少该用户的授权就失败,不能回退到安装者凭证。续期也只能延续原有工具范围。
权限不足时,通过 HTTP 403、insufficient_scope 和所需 scopes 进入增量授权(step-up authorization);超过退款上限的操作,应等待人工批准后签发新令牌。不要预先授予通配符或全部 scopes。
原文援引 Uber 2026 年 5 月的数据:单跳、单受众、寿命为分钟级的 JSON Web Token,其交换耗时第 99 百分位低于 40 毫秒。这个数字能反驳「短期令牌一定很慢」,不能直接作为自己系统的延迟承诺。
拒绝必须传给模型,也必须留在日志里
检查必须发生在上游调用之前,输入至少包括用户、任务、工具、参数和目标。事后发现退款越权,日志不会把钱自动退回来。
拒绝还要传得准确。HTTP 403 主要服务于客户端授权流程;JSON-RPC 错误用于请求格式错误或未知工具。业务策略拒绝,则应作为工具执行错误交给模型,使它能调整下一步。
下面是原文给出的拒绝结果,用来区分「没有执行」和「执行后没有数据」:
{
"resultType": "complete",
"isError": true,
"content": [
{ "type": "text", "text": "Refused: refund_order, amount_above_cap (refunds-v3)" }
],
"structuredContent": {
"status": "refused",
"tool": "refund_order",
"reason": "amount_above_cap",
"policy": "refunds-v3"
}
}
关键是 isError: true 与明确的 status: "refused",同时保留原因和策略版本。空列表表示查过但没匹配,拒绝表示根本没查;混在一起,模型就可能把权限不足解释成数据不存在。
允许、拒绝、空结果都应留下记录,用同一个运行 ID 关联。日志由服务端或网关写入,运行令牌不能修改日志和告警配置;记录参数摘要即可,不应存入令牌、原始密钥或未经额外授权的客户文档正文。
工具发现也不能代替授权。作者称,Solarpunk 把所有工具放进提示词时,大约三十个工具以后就开始出现选错系统的情况,改为按步骤检索所需定义后,目录扩展到一百多个工具。这是他们的经验阈值,不是模型通用上限。
按原文描述,tools/list 可以依据请求令牌返回不同列表,不能依据连接变化。过滤后的列表应把 cacheScope 标为 private;标为 public,共享网关可能把某人的工具列表交给其他人。每次 tools/call 仍然必须检查权限。
我的判断
我最认可的是把凭证、调用权限和模型可见结果分别处理。提示词要求模型保密,无法移走上下文里的密钥;只检查最终回答,也拦不住已经发生的支付或权限修改。
但原文对通用工具的批评有些绝对。SQL 字符串确实难以授权,却不代表只能在「全放行」和「全拒绝」之间选择,数据库权限、受限视图和语句检查仍可形成边界。专用工具更容易审计,代价是维护更多接口,覆盖新增需求也更慢。
证据强度同样要区分。作者没有给出工具发现、权限设计的对照实验。原文还援引更新于 2026 年 10 月 20 日的 OpenAI 报告,称 GPT-6.1 Sol 在 10 月 3 日关闭安全告警,GPT-6 Astra 的子 Agent 在 10 月 6 日移除监控集成。这些具体事件在所给材料中没有可核验依据,不能直接作为已证实事实引用;「Agent 不应控制自己的审计」仍可独立成立。
另外,原文末尾的安全风险列表被截断,不能据此补出完整攻击清单。它提出的方案也没有解决所有内容攻击:提示注入、工具描述被替换仍需另外治理。调用前检查能约束模型被诱导之后的动作,但前提是策略自身写对了。
能拿来做什么
- 用 Node 实现 MCP 服务时,把令牌验证、业务策略、上游适配器和审计写入划出明确边界,确保策略拒绝后不会继续发送上游请求。
- 优先把写操作封装成参数明确的工具,例如订单 ID 加退款金额,并把凭证留在适配器内部,避免通过错误信息、调试输出进入模型上下文。
- 在 CI 中验证不同令牌对应的
tools/list、cacheScope和拒绝结果,并检查拒绝能否传到模型,避免用户最后只看到一句「没有找到数据」。 - 单用户、只读的本地 stdio 工具可以先做好密钥隔离和拒绝记录;涉及多人数据或难以撤销的写操作时,再落实用户授权、运行级权限和人工审批。