把 MCP 服务器接入 CI/CD 时,一个容易被忽略的假设是:只要客户端能发现并调用工具,这个工具就已经可信。实际上,一次看似简单的“读取构建日志”调用,可能同时牵涉工具描述、服务进程权限、下游令牌、模型上下文和流水线日志。接入前要审计的不是“能不能调用”,而是这次调用究竟能做什么、能看到什么,以及出错后能否收回权限。
本文以一个只读取指定构建日志的工具为例,沿“流水线任务 → MCP 客户端 → MCP 服务器 → 构建日志服务”的调用链,整理接入前的检查和回归方法。示例是安全策略示意,不代表任何特定 MCP 客户端或服务器的配置格式。

准备:先限定一次调用的边界
假设团队希望在测试流水线中,让助手通过 read_build_log 工具读取某次构建的日志,辅助定位失败原因。预期操作只有一项:读取测试项目中明确指定的构建记录;不应读取其他项目、修改构建、触发部署或访问生产密钥。
开始前,先确定以下条件:
- 授权与环境:取得服务器和下游服务负责人的测试许可,在隔离的测试项目中准备脱敏日志和测试账号。
- 调用链负责人:明确客户端、MCP 服务器、令牌签发方和日志服务各自的维护人;服务器被调用不等于下游服务已正确授权。
- 基线与证据:记录服务器来源、版本或镜像摘要、启动参数、工具定义快照、网络出口和现有权限。不要把令牌值写入证据。
- 停止条件:出现越权读取、未批准的外联、敏感数据进入上下文或日志时,停止测试并按应急流程处理。
- 恢复准备:保留已知安全的配置和部署版本,确认禁用连接、撤销令牌及恢复流水线的负责人和操作路径。
可以先把允许行为写成一份简短的策略基线,再将其映射到实际产品支持的配置与授权机制:
# 示意策略,不可直接作为 MCP 产品配置使用
server: build-log-reader
environment: test
allowed_tools:
- read_build_log
allowed_project: test-project
allowed_operations:
- read_build_log
denied_operations:
- modify_build
- trigger_deployment
context:
share_across_jobs: false这份基线只是审计目标。即使客户端只展示了一个工具,也要检查服务进程和下游凭据是否真的只能执行上述操作。
审计:从工具定义追到实际权限
盘点工具,而不只看名称
取得服务器实际提供的工具清单,为每项工具记录名称、描述、输入参数、输出类型、预期调用方和下游操作。对 read_build_log,至少核对:
- 参数是否限定项目和构建标识;调用方能否传入任意路径、地址或其他项目标识。
- 工具实现是否只调用日志读取接口,是否还会启动子进程、访问本地文件或向外发送请求。
- 返回结果是否经过必要的裁剪与脱敏,错误信息是否可能包含凭据或内部环境信息。
- 同一服务器是否还提供未被业务使用的写入、命令执行或部署工具。
工具清单是声明,不是权限证明。还需核对服务器的运行身份、文件挂载、网络出口和下游授权。工具参数中的项目限制也不能代替日志服务侧的访问控制。
检查工具描述是否可能被投毒
工具描述会影响客户端或模型如何选择和使用工具,但它不应成为覆盖系统策略的指令来源。审查时,将名称、描述和参数说明与已批准的快照比较,重点关注描述中是否出现要求改变任务目标、读取额外数据、发送结果到其他位置或忽略既定限制的内容。
对发现的变化,应结合服务器版本、发布记录和代码审查判断,不能只凭一条自然语言描述认定恶意。批准更新后重新生成基线;无法解释的变化则暂停接入。模型对描述的理解可能不稳定,因此关键限制仍应由调用网关、服务器和下游服务强制执行。
核验令牌作用域与复用路径
沿调用链分别标记客户端身份、服务器身份和服务器访问日志服务所用的凭据。不要假设客户端能调用某个工具,就意味着服务器持有的令牌同样受到该工具的限制。
| 检查项 | 验证问题 | 期望结果 |
|---|---|---|
| 资源范围 | 令牌能否访问其他项目或其他环境? | 仅限测试项目中必要的资源 |
| 操作范围 | 令牌能否修改构建、触发任务或部署? | 除日志读取外的操作被下游拒绝 |
| 使用位置 | 同一令牌能否从其他任务、客户端或服务使用? | 能实施的身份、受众或环境限制均已落实;无法绑定的风险有补偿控制 |
| 生命周期 | 令牌是否可过期、撤销和轮换? | 优先使用短期凭据,并验证撤销生效 |
| 暴露位置 | 凭据是否出现在模型上下文、工具输出或日志中? | 凭据由受控组件处理,不进入模型可见内容 |
令牌是否具备受众限制、调用方绑定或细粒度项目权限,取决于具体身份系统和下游服务,不能仅凭配置名称判断。对支持的限制做实际拒绝测试;对不支持的能力,记录残余风险,必要时通过独立服务账号、网络限制和缩短有效期补偿。
限制上下文共享
构建日志本身也可能包含令牌、内部地址或用户数据。即便读取经过授权,也不意味着整份日志都应进入模型上下文,更不意味着它可以跨流水线任务共享。
按任务只提供排障所需的日志片段,设置输出大小限制与脱敏规则;将外部日志、工具输出和检索内容视为不可信数据,而不是新的操作指令。检查缓存、持久记忆和调试记录是否按任务隔离,并定义保留与清理期限。脱敏规则可能漏报,也可能遮蔽必要的错误信息,因此需要用测试样本同时检查两种情况。
查找影子 MCP 服务器
已登记的服务器只是起点。结合开发环境、流水线配置、运行时进程、容器工作负载和网络出口记录,寻找未进入台账的 MCP 连接或服务实例。对每个候选项确认负责人、来源、用途、凭据、可用工具和是否连接生产资源。
发现未登记实例时,不应直接认定其恶意:先联系负责人、确认业务影响,再按变更流程隔离或下线。对暂时无法确认用途的实例,优先限制其高风险权限和外部访问,并保留调查证据。
执行:用一次正常调用和几组拒绝测试验证
在隔离环境中,先通过实际客户端发起一次正常的 read_build_log 调用,使用测试项目和已知构建标识。记录请求关联标识、调用工具、目标资源、结果状态及下游授权结果;不要记录令牌值和不必要的日志正文。
随后改变一个条件,逐项复测:
| 测试 | 预期结果 | 需要核对的证据 |
|---|---|---|
| 读取允许的测试构建 | 成功,返回必要片段 | 客户端、服务器和日志服务记录可关联 |
| 请求其他项目的构建 | 被拒绝,或按既定策略隐藏资源 | 下游授权拒绝记录,而非仅靠模型拒绝 |
| 尝试修改构建或触发部署 | 不存在可用入口,且下游拒绝越权操作 | 工具清单、服务权限及下游结果 |
| 从未授权任务或调用方使用测试令牌 | 按实际设计被拒绝;若仍可用,记录复用风险 | 令牌策略与下游访问记录 |
| 在测试日志中放入无害的指令样本 | 内容作为数据处理,不引发额外工具调用 | 调用轨迹和最终输出 |
| 撤销测试令牌后再次读取 | 在服务规定的生效条件下被拒绝 | 撤销记录、缓存或会话状态及复测结果 |
拒绝测试尤其重要:如果只是模型回答“不可以”,但直接调用服务器或下游接口仍能成功,就不能算作权限边界生效。反过来,一次失败也不一定证明控制有效;网络故障、资源不存在或测试身份配置错误都可能产生误判,应检查具体拒绝原因。
修复、门禁与风险回归
发现权限过宽时,优先缩小下游令牌和服务身份的资源、操作范围,再关闭不需要的工具及网络出口。对于描述异常或来源不明的服务器,先暂停接入,核验来源和变更后再决定是否恢复。涉及写入、部署或其他高影响动作时,应增加独立授权或人工审批,而不是让模型自行判断是否执行。
修复后重新运行正常调用和拒绝测试,并检查工具定义、运行配置和审计记录是否与批准基线一致。可以把以下变化纳入 CI/CD 安全门禁:
- 工具新增、删除,或描述、参数发生未批准的变化。
- 服务身份、令牌权限、资源范围或网络出口扩大。
- 隔离测试中的跨项目访问、越权操作或撤销验证未达到预期。
- 必要审计事件缺失,导致无法关联调用方、工具和下游结果。
门禁可先以报告模式运行,确认差异检测的准确性,再对经过验证的高风险条件实施阻断。合法版本更新、描述调整或日志格式变化都可能触发告警;例外应记录原因、负责人、有效期和复核计划,不能永久关闭整条检查。扫描结果也只能覆盖已实现的规则,不能替代人工审查和运行时授权测试。
OWASP MCP Top 10 适合作为风险回归的检查框架,而不是通过认证的证明。可以用它提示团队检查身份与权限、工具和供应链、上下文以及审计治理等方面;但具体条目和表述应以项目当时发布的版本为准。本文提供的资料未包含可核验的官方项目页面及版本,因此不在此列出编号或声称覆盖全部条目。实际验收仍须针对所用 MCP 实现、版本、身份系统和部署配置建立证据。
留好回滚证据,而不只是保存调用日志
一次可复核的审计记录,至少应能回答:谁在什么时间,通过哪个客户端和服务器版本,对哪个工具及资源发起调用,采用了哪个策略版本,结果是什么,下游是否允许,以及对应的变更或审批是什么。使用关联标识串联各层记录,并限制日志访问、保留必要期限;参数和输出只保存排查所必需的脱敏信息。
如果上线后发现异常,按预先演练的顺序处置:
- 禁用受影响的 MCP 连接或工具入口,暂停相关自动化任务。
- 撤销或轮换可能暴露的凭据,并确认已有会话、缓存或短期令牌的实际失效状态。
- 恢复到已验证的服务器版本、工具定义和最小权限策略;不要仅回滚客户端而保留过宽的下游令牌。
- 核查调用记录和下游操作,评估数据访问或业务变更影响;必要时按事件响应流程升级。
- 用测试身份重新执行正常与拒绝测试,经负责人批准后再逐步恢复接入。
最终验收的重点不是清单上有多少勾,而是这条调用链上的每一项能力都有明确用途、独立控制和可验证证据:允许的读取能完成,不允许的访问在模型之外也会被拒绝,异常发生时团队知道如何停止、追查和恢复。
- CI/CD
- it2021
- it2021.com
- OWASP
- test
- 访问控制

![[TcaplusDB知识库]TcaplusDB架构描述](https://www.it2021.com/wp-content/uploads/thumbnail/20210323151258-5fed3-280x210.jpeg)



1F
只看工具名称确实容易漏掉底层权限
2F
令牌撤销后的缓存失效时间怎么测?
3F
日志脱敏和排障信息保留挺难平衡的