MCP 面试高频考点:给 MCP Server 加日志、指标和分布式追踪,OAuth 2.1 与 JSON Schema 怎么配合?

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。

参考资料

相关推荐
塑料铲子3 小时前
MCP 协议入门,让你的 Agent 连接微信、文档和数据库
mcp·cline
Danny转行做跨境16 小时前
跨境数据CLI怎么用? 一个命令行调61个接口实录
跨境电商·mcp·sorftime
Flynt17 小时前
我让 AI 给掘金首页做了次性能体检:LCP 8.9 秒是真的,但它判读错了一处
chrome·性能优化·mcp
prince_zxill1 天前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
xrlfreedom1 天前
MCP 面试高频考点:给 MCP Server 加日志、指标与分布式追踪,面试追问你能答到第几层?
结构化输出·mcp·mcp server
leer2 天前
我给 agent 加了一道闸,拦住了自己差点删掉的构建目录
mcp
莪_幻尘2 天前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
我不会起名字3223 天前
Agent 总调错工具?MCP 接进 Go 后端的 4 个约束
后端·go·agent·mcp