今日 TL;DR
今天是周日复盘,不另开新协议主题。过去一周我们从MCP边界、工具原语和任务检查点走到记忆删除与OAuth授权;共同结论是,模型可以提出下一步,但身份、授权、数据生命周期和副作用必须由可信服务端控制。仓库没有找到10月31日的周六项目课文件,因此不假装昨天已交付项目;本课提供可补做的验收入口。
- MCP负责连接能力,不能替你认证用户或决定资源归属。
- 检查点只保存任务恢复进度;长期记忆另有授权、版本与删除规则。
- OAuth令牌要限定受众和scope,读取具体对象时还要核ACL;撤权后恢复必须重新授权。
- 作品集应展示真实拒绝路径、状态变化和可读审计记录,不能只截一张“连接成功”。
为什么今天学这个
周五学习OAuth与最小权限,周四讨论记忆可删除性,周三讨论检查点恢复,周二梳理MCP的Resources、Tools与Prompts,周一先划清MCP协议和业务权限的边界。它们不是四个互不相关的概念,而是同一条跨工具任务的四道门:能不能连接、这次任务从哪里继续、哪些信息可以保留、当前调用者是否仍获准访问。
课程表把周六安排为项目、周日安排复盘。当前目录中最近一周课程文件止于10月30日,未发现10月31日已发布课程。按课程提示,历史缺课时按日历继续,不伪造完成记录。今天把跨工具准备台作为本周复盘对象;若你尚未做周六项目,可先从下方练习补起,再用这张清单验收。
把它想成一个受控的面试准备助手:用户授权它读取自己的岗位说明和简历,模型抽取技能缺口并生成练习计划;任务暂停时保存检查点;用户断开资料服务后,后台任务恢复时必须停止读取。MCP让客户端发现和调用工具,检查点让流程从特定节点恢复,记忆让某些跨任务偏好可复用,OAuth提供有限访问票。但四者都不能把“曾经获准”自动变成“现在仍获准”。
今天要区分事实与建议:协议和标准文档定义接口、授权和令牌约束;版本号、授权对象和任务状态字段是工程实现选择;具体权限策略应由产品的数据敏感度和风险决定。最小权限不是“scope越少越好”这么简单,而是让权限刚好覆盖明确任务,并能被检查、撤销和解释。
一张图讲清楚
MCP调用成功只是“接口完成了一次交换”,不代表业务访问已被授权。检查点保存的是任务状态,不是访问令牌的永久通行证。记忆是跨任务保存的资料,必须有单独的用途与生命周期。恢复时重新验证授权,才能避免任务在撤权后继续读取。
三个核心要点
- 先把身份放在可信边界。 用户身份来自登录会话或受验证的令牌,不来自模型生成的
user_id、tenant_id或工具参数。MCP Server和业务API按真实主体、租户、对象与动作复核权限;JSON Schema只验证字段形状,不证明请求合理或有权。 - 把任务恢复与跨任务记忆分开。 检查点可以存任务步骤、输入摘要、已完成动作和幂等键;长期记忆保存可复用偏好或用户事实。两者的访问控制、保留期限、删除方式和审计要求不同。恢复旧检查点不能复活过期令牌或已删除资料。
- 副作用要有边界和证据。 读取、写入和对外发送是不同风险等级。写操作要有服务端幂等、状态查询、审计与必要的人类确认;超时后结果未知时,不可盲目重试。日志记录请求ID和决策摘要,避免存放令牌原文或不必要的个人资料。
最小可运行示例
下面的Python 3.10+示例不实现MCP网络协议或OAuth服务器,只把本周学到的恢复边界做成可运行状态决策。保存为weekly_boundary.py,执行python3 weekly_boundary.py。输入是一个可信会话、工具参数、当前授权版本和检查点;输出允许读取或明确拒绝。所有数据都在内存中,不连接网络。
from dataclasses import dataclass
@dataclass(frozen=True)
class Session:
user: str
tenant: str
audience: str
scopes: frozenset[str]
grant_version: int
revoked: bool = False
@dataclass(frozen=True)
class Checkpoint:
task_id: str
user: str
tenant: str
grant_version: int
next_step: str
DOCS = {
"job-a": {"tenant": "t1", "owner": "u1", "text": "岗位要求:Python与RAG"},
"cv-b": {"tenant": "t1", "owner": "u2", "text": "他人的简历"},
}
SERVICE = "https://docs.example.org"
CURRENT_GRANT_VERSION = {("t1", "u1"): 4}
def read_job(session: Session, document_id: str) -> str:
if session.revoked:
raise PermissionError("grant revoked")
if session.audience != SERVICE:
raise PermissionError("wrong audience")
if "docs:read" not in session.scopes:
raise PermissionError("missing scope")
if CURRENT_GRANT_VERSION.get((session.tenant, session.user)) != session.grant_version:
raise PermissionError("stale grant version")
doc = DOCS.get(document_id)
if not doc or (doc["tenant"], doc["owner"]) != (session.tenant, session.user):
raise PermissionError("resource denied")
return doc["text"]
def resume(session: Session, checkpoint: Checkpoint) -> str:
if (checkpoint.user, checkpoint.tenant) != (session.user, session.tenant):
raise PermissionError("checkpoint owner mismatch")
# 恢复任务只读取状态;每个敏感工具调用仍重新检查当前授权。
return read_job(session, "job-a")
active = Session("u1", "t1", SERVICE, frozenset({"docs:read"}), 4)
cp = Checkpoint("task-17", "u1", "t1", 4, "draft_questions")
print(resume(active, cp))
for label, changed in [
("revoked", Session("u1", "t1", SERVICE, frozenset({"docs:read"}), 4, True)),
("wrong audience", Session("u1", "t1", "https://mail.example.org", frozenset({"docs:read"}), 4)),
]:
try:
resume(changed, cp)
except PermissionError as error:
print(label, "->", error)
else:
raise AssertionError("unauthorized resume")
try:
read_job(active, "cv-b")
except PermissionError as error:
print("foreign document ->", error)
else:
raise AssertionError("cross-owner read succeeded")
预期第一行输出“岗位要求:Python与RAG”,随后显示撤权、受众不匹配和他人资料三种拒绝。生产系统还要验证签名或向授权服务器内省令牌、处理过期时间、租户ACL和请求审计。内存字典只演示边界,不能用于真实多用户服务;示例也没有数据库事务、并发控制、删除记忆或调用真正MCP Server。
生产环境会怎么翻车
- 撤权后任务仍能继续。 症状是用户断开资料服务后后台任务还能读取。根因是只在启动时检查授权,恢复使用缓存的旧上下文。处理是每次敏感调用和恢复时核当前grant版本;异步任务拿到“撤权”结果后转为暂停或失败,不用旧令牌绕行。
- 检查点误存秘密。 症状是任务快照中出现access token、简历全文或不必要个人信息。根因是把整个请求对象直接序列化。处理是白名单字段投影、令牌引用而非令牌原文、加密和保留期;恢复读取时还要重新鉴权。
- 同租户ID替换导致越权。 症状是模型把
document_id换成同事简历仍取得内容。根因是只校验租户,没有对象所有者或共享ACL。处理是用可信主体查权限,权限判断放在数据读取服务端,不能让模型提供owner来代替授权。 - 超时重试重复产生副作用。 症状是创建两份计划或发送两封邮件。根因是客户端把超时当成“服务端没执行”。处理是幂等键、操作状态查询和明确的未知结果;高风险发送还应让用户确认目标、内容与执行时间。
- 删除只清主表,旧资料又回来。 症状是删除记忆后搜索摘要仍出现,或恢复备份时资料复活。根因是遗漏向量索引、缓存、检查点、日志与备份。处理是先让读取层拒绝,再逐副本清理并留回执;备份恢复前重放删除记录。物理擦除能力要按存储系统实际机制表述。
动手练习
用20分钟给示例增加write_interview_plan(),只允许创建用户自己的计划。输入包括任务ID、计划内容和幂等键;执行前检查当前授权版本和plans:write,同一幂等键重复请求返回原结果而不创建第二份。之后先执行一次写入,再撤销授权并尝试从检查点恢复。
完成条件:合法只读可以读取本人岗位资料;错误audience、缺scope、读取他人资料、grant版本过期、用户撤权和检查点主体不符都会拒绝;同一个写入幂等键只产生一条记录;拒绝后计划表状态不变。记录每个案例的请求ID、决策理由和可见结果。若周六项目还没做,把上述练习当补课入口,并把“外部网络服务未接入”标注为未验收,不声称已经完成真实OAuth或MCP集成。
面试表达
30 秒回答
我把跨工具Agent拆成连接、授权、任务状态与记忆四个边界。MCP负责发现和调用接口,但主体和对象权限由服务端检查;检查点帮助任务恢复,不能存永久访问权;长期记忆需要独立授权、版本和删除流程。恢复时重新校验当前授权,写操作通过幂等、审计与确认保护副作用。
追问与 3 分钟回答
追问:为什么不把OAuth令牌放进检查点,恢复时直接使用?
检查点的生命周期通常与任务相关,而令牌的受众、scope、到期和撤权状态由授权服务控制。把令牌原文持久化会扩大泄露面,也可能在撤权后继续访问。我会存授权连接的受控引用或grant版本,恢复时由服务端重新换取或验证短期凭据。若授权已过期或撤销,任务进入需要重新授权的状态,而不是悄悄降级到高权限身份。
追问:MCP Server已经认证过用户,还需要业务层ACL吗?
需要。认证回答“请求是谁发起的”,ACL回答“这个主体对这个对象能做什么”。工具参数可能是模型生成的,不能把owner或tenant当成可信值。业务服务从认证上下文取身份,再核对对象所有权、共享关系和动作权限。对于写入,还要处理幂等、重试、审计和用户确认。接口协议统一并不能消除业务权限差异。
追问:删除记忆后怎样保证不会复活?
先让在线读取入口按删除状态拒绝,再清理原文、摘要、向量、缓存和任务检查点;后台任务写入需要匹配当前版本,避免旧快照覆盖删除。备份有自己的保留期,恢复时需要重放删除事件。对用户分别报告“已不可检索”和“副本清理完成”,只承诺系统实际能证明的状态。
今日自测
1. 基础理解
MCP工具返回了一个有效的岗位文档ID,这是否足以证明当前用户可以读取?
查看答案
不足。ID只标识对象,仍需用可信登录主体检查租户、所有权或共享ACL,以及当前动作权限。
2. 工程取舍
保存检查点时,为什么更适合保存grant版本或连接引用,而不是access token原文?
查看答案
令牌有受众、scope、有效期和撤权状态;将原文持久化扩大泄露面且可能绕过撤权。恢复时应由服务端重新验证当前授权。
3. 场景应用
某工具调用超时,界面没有收到成功结果。是否可以直接用新请求ID再试一次?
查看答案
不应盲目重试,因为服务端可能已经完成写入。先用幂等键查询操作状态;无法确认时明确显示结果未知,并按风险决定是否人工介入。
市场雷达
本期无新增市场信号。本周主题是协议边界和权限治理;没有在本轮核验到最近30天内、与该技能直接相关且可引用的一手招聘JD变化,因此不补写岗位数量、薪资或招聘公司案例。
权威来源
- MCP HTTP授权规范 — 资源标识、授权发现和令牌受众边界。
- RFC 9700 OAuth 2.0安全最佳实践 — OAuth客户端与令牌保护建议。
- RFC 7636 PKCE — verifier与challenge的授权码保护机制。
- LangGraph Memory概念文档 — 区分任务范围状态和跨任务记忆的工程参考。
以上为标准与官方文档;本课的数据流、代码和练习是教学设计,不代表已接入或实测真实授权服务。
明天会用到
周一进入第9周“证明AI系统真的有效”:先把本周准备台的权限拒绝、撤权恢复和幂等写入整理成Golden Set,再区分协议正确、业务正确与用户任务成功。今天留下的审计字段和可重复状态,将用于下一周的错误分类与离线评测。