MCP 面试高频考点:给 MCP Server 加日志、指标和分布式追踪,OAuth 2.1 与 JSON Schema 怎么配合?
面向有基础开发经验的读者,本文用一场"由浅入深"的追问,把一个真实工程问题拆开:远程 MCP Server 上线后,如何补齐日志、指标、分布式追踪,同时让 OAuth 2.1 授权与 JSON Schema 校验各司其职,而不是互相替代。 文中涉及 SDK 能力时只写资料明确给出的部分,其余用版本无关的接口设计或伪代码表达。
面试场景
面试官:我们有一个远程 MCP Server,通过 Streamable HTTP 暴露若干 Tools,客户端是公司内的 AI 应用。现在要上线可观测性:出问题时能定位到"哪个用户、哪次会话、调了哪个 Tool、参数是否合法、授权是否通过、下游慢在哪"。你先说整体思路。
候选人:先给结论------把"身份与授权""结构校验""可观测性"分成三层,用同一个关联标识串起来。OAuth 2.1 负责"这次请求代表谁、被允许做什么";JSON Schema 负责"Tool 入参结构是否合法";日志、指标、追踪负责"发生了什么、花了多久、失败在哪一环"。三者不能互相顶替:schema 合法不代表有权限,有令牌不代表参数安全,有追踪也不代表审计合规。
基础问题:三类信号各自记什么
面试官:具体说说日志、指标、追踪的分工。
候选人:
- 日志:面向审计与排错。记录谁(授权主体)、什么时间、调用了哪个 Tool、关键资源范围、结果状态,敏感字段脱敏。MCP 基础知识明确指出,审计日志应记录谁在什么时间调用了哪个 Tool、关键资源范围与结果状态,并对敏感字段脱敏 资料2。
- 指标:面向趋势与告警。按 Tool 名、结果状态、错误类型做维度聚合,观察调用量、错误率和耗时分布。
- 追踪:面向单次请求的链路。把"接收请求---鉴权---schema 校验---执行 Tool---访问下游"串成一条链,跨异步边界传递关联 ID 与追踪状态。
面试官:SDK 自带这些实现吗?
候选人:不带。MCP Java SDK 的公开 API 只通过 SLF4J 打日志,不内置后端;可观测性元数据通过 Reactor 管道流动;SDK 本身不提供指标或追踪实现,定位是与 Micrometer、OpenTelemetry 等系统集成 资料1。所以我们要自己做埋点适配,而不是期待 SDK 开箱即用。
第一轮追问:OAuth 2.1 在链路里落在哪
面试官:为什么这里一定要提 OAuth 2.1?只判断"用户已登录"不行吗?
候选人:不行。远程 MCP Server 应对每次请求执行授权检查,不能只判断用户是否已登录 资料2。规范层面,授权服务器必须实现带相应安全措施的 OAuth 2.1,覆盖机密客户端与公共客户端;授权服务器与 MCP 客户端应支持 Client ID Metadata Documents,也可选支持动态客户端注册,但后者已标记为弃用、仅为向后兼容保留 资料4。
面试官:那追踪里要不要放访问令牌?
候选人:绝对不放。凭据不应出现在日志、Tool 返回值或模型上下文中 资料2。追踪和日志里只放授权主体标识、客户端标识、授权决策结果这类可审计但不泄密的字段;令牌本身既不进 span 属性,也不进日志。
面试官:如果鉴权失败,你怎么记?
候选人:结论是"失败也要留痕,但只留判定信息"。记录主体(若可识别)、目标 Tool、拒绝原因分类(如令牌无效、范围不足),不记录令牌原文。指标上按拒绝原因打标签,便于发现异常调用模式。
第二轮追问:JSON Schema 校验与授权谁先谁后
面试官:Tool 入参有 schema,是不是 schema 过了就可以放心执行?
候选人:不是。Tool 的参数 schema 只是结构约束,不能代替服务端校验和授权;Server 必须把模型传入的文本视为不可信输入,对文件路径、URL、SQL、Shell 参数和资源标识符进行约束 资料2。MCP 在协议消息中广泛使用 JSON Schema 做校验,并且规范对可用的 schema 方言有明确规则 资料3。
面试官:顺序上怎么排?先鉴权还是先校验?
候选人:我的取舍是先做轻量的身份与授权判定,再做 schema 校验,最后做业务级安全校验。理由:未授权请求不应消耗昂贵的校验与下游资源;schema 校验失败属于客户端错误,应快速返回且不计入"下游故障"指标;业务级约束(路径、URL 白名单)必须在 schema 之后单独做,因为 schema 管不了语义安全。
面试官:如果出现异常呢?比如 schema 校验器本身抛错。
候选人:要区分"输入不合法"和"校验组件故障"。前者是可预期的 4xx 类结果,指标按 Tool 维度计数;后者是服务端异常,应触发告警并带追踪 ID 返回,方便用户报障时直接定位。这条边界如果不分清,错误率指标会被污染。
方案设计:一条可落地的请求链路
面试官:把这套东西画成链路。
候选人:用版本无关的伪代码表达,重点是顺序与埋点位置,不绑定具体类名或方法名。
handle(request):
traceId = 从入站上下文提取或新建
span = startSpan("mcp.request", traceId)
# 1. 授权:每次请求都判定
subject = authorize(request) # 失败 -> 记录拒绝原因,结束
span.set("subject.id", subject.id) # 不放令牌
span.set("client.id", subject.clientId)
# 2. 结构校验:JSON Schema
if not validateSchema(toolName, request.params):
recordMetric("tool.schema_invalid", tool=toolName)
endSpan(span, "invalid_argument"); return 客户端错误
# 3. 业务级安全校验:路径/URL/SQL 约束
if not checkResourceScope(subject, request.params):
recordMetric("tool.scope_denied", tool=toolName)
endSpan(span, "denied"); return 拒绝
# 4. 执行,跨异步边界透传 traceId
result = executeTool(toolName, request.params, traceId)
recordMetric("tool.call", tool=toolName, status=result.status)
auditLog(subject.id, toolName, 资源范围, result.status) # 脱敏
endSpan(span, result.status)
return result
面试官:跨异步边界怎么保证 traceId 不丢?
候选人:MCP Java SDK 的可观测性元数据通过 Reactor 管道流动,用于在异步边界间传递关联 ID 与追踪状态,从而与现代可观测框架互通 资料1。实践上就是把 traceId 作为上下文的一部分随管道传递,而不是靠线程本地变量硬扛。
面试官:stdio 场景也要这么搞吗?
候选人:stdio 传输适合 Host 在本机启动子进程的场景,此时 Server 的标准输出用于协议消息,调试日志必须写标准错误,否则可能破坏通信 资料2。这一条是很容易踩的坑:本机场景下随手往标准输出打日志,直接把协议流搞坏。
面试官点评
考察点:是否理解 OAuth 2.1、JSON Schema、可观测性三者的真实协作关系;是否知道 SDK 的能力边界;是否能把安全校验放在正确的位置;是否具备异常分类与审计意识。
合格回答:能说清授权每次请求都要做、schema 不能替代授权与业务校验、凭据不进日志、stdio 下日志走标准错误、SDK 不内置指标与追踪实现。
加分项:主动区分"输入不合法"与"校验组件故障",避免污染错误率指标;把审计日志与调试日志分开设计;明确 traceId 跨异步透传;指出动态客户端注册已弃用、优先 Client ID Metadata Documents 资料4。
适用边界与关键取舍
- 适用:远程部署、多客户端接入、需要审计与排障的 MCP Server;本机 stdio 场景同样需要日志规范,但链路追踪可适度简化。
- 取舍:授权前置能省资源,但会让"参数错误"和"无权限"在用户视角难以区分,需要在返回信息上做平衡;全量追踪能定位问题,但采样与存储成本需按业务 SLA 与风险确定,文中不给出具体数值。
- 易踩坑:把 schema 校验当成安全边界;把令牌写进 span 或日志;stdio 下日志误写标准输出破坏协议通信。
总结
给 MCP Server 加可观测性,不是"多打几行日志",而是把身份与授权、结构校验、链路观测三层用统一关联标识缝合起来:OAuth 2.1 回答"是谁、能不能做",JSON Schema 回答"结构对不对",业务级校验回答"语义安不安全",日志、指标、追踪回答"发生了什么、慢在哪"。SDK 只提供日志门面与元数据传递通道,后端集成与埋点策略要自己设计 资料1;参数 schema 永远不能替代服务端校验与授权 资料2。
参考资料
- MCP Java SDK:https://github.com/modelcontextprotocol/java-sdk
- MCP 基础知识
- Overview | MCP Specification:https://modelcontextprotocol.io/specification/2026-07-28/basic
- Authorization | MCP Specification:https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization