Spring AI 接入 MCP 后,Java 服务可以让模型查询远程资料、调用工具,甚至执行写操作。但一个常见误解是:只要每次请求都携带不同用户的 Token,MCP 会话就自动隔离。Spring AI 1.1 官方文档明确讨论了应用级单例客户端与共享 Session 的边界。本文从工具发现、会话状态、资源授权、隔离方案和测试矩阵讲清风险。
技术范围:Spring Boot 3.x、Java 17+、Spring AI 1.1 MCP Client 文档;代码展示授权设计骨架,具体版本需与项目 BOM 核对。
一、Token、Client 与 Session 必须分开理解
1.1 应用级 Client 不等于用户级 Client
Spring AI MCP Client Boot Starter 自动配置的 McpSyncClient / McpAsyncClient Bean 是应用范围单例。一个配置的 MCP Server 连接通常对应一个 Client,协议 Session 在客户端生命周期中复用。
text
用户 A(Token A) ─┐
├─ Spring Boot / MCP Client 单例
用户 B(Token B) ─┘ │
▼
共享 MCP Session
│
▼
MCP Server
Token 可以按请求传递给 Server 做身份鉴别,但底层 Session 并不会因为用户变化就自动分裂。Session 不是租户隔离边界。
1.2 什么情况下可能发生跨用户状态污染
如果 Server 仅按 Session 保存"当前项目""工作目录""分页游标""上次选中的文档",用户 A 改变状态后,用户 B 复用同一 Session 就可能受到影响。这是需要验证的架构风险,不是宣称 Spring AI 已发生某个真实漏洞。
是否造成泄露,取决于 MCP Server 是否每次请求都鉴权,以及服务端是否把用户敏感状态错误地挂在共享 Session 上。
二、工具发现与工具执行是两道不同的权限关
2.1 tools/list 可能只在连接初始化时运行
官方文档指出,自动配置 Client 的 initialize 和 tools/list 通常在连接时执行一次。如果 Server 按连接初始身份返回不同工具清单,后续其他用户共享 Client 时看到的工具定义可能不符合其权限。
text
应用启动 → initialize / tools/list
↓
工具元数据缓存
↓
用户 B 请求 → 模型选择工具 → tools/call
注意: 能看到工具不代表有权执行工具。MCP Server 必须在每一次 tools/call 中重新校验用户、租户、操作和资源。
2.2 不要把模型参数当成身份
java
// 反例:tenantId 可由模型或请求参数伪造
public List<Document> search(String tenantId, String query) {
return repository.search(tenantId, query);
}
正确设计是从可信认证上下文提取调用者身份:
java
public List<Document> search(AuthenticatedPrincipal caller,
String query) {
return repository.searchAuthorized(
caller.tenantId(), caller.userId(), query
);
}
这里 AuthenticatedPrincipal 与 repository 是业务抽象,不是 Spring AI 内置类。Server 必须先验证 JWT/OAuth2 令牌的签名、issuer、audience、过期时间和权限,再构建 Principal;绝不能让模型生成 Principal。
三、三种会话隔离方案如何选择
| 模式 | Session | 必须满足 |
|---|---|---|
| 共享 Client + 无状态 Server | 共享 | 每次请求鉴权,无用户会话状态 |
| 共享 Client + 按身份隔离状态 | 共享 | 状态读写按用户/租户授权 |
| 每用户/租户独立 Client | 独立 | 自行管理连接生命周期,仍需逐请求鉴权 |
官方说明自动配置 Bean 不适合需要独立用户 Session 的场景。独立 Session 需要程序自行创建 Transport 和 Client,并负责关闭、回收、限流;不要假设 Spring AI 默认提供按用户池化。
3.1 先关掉自动暴露工具,再建立授权网关
xml
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-mcp-client</artifactId>
</dependency>
yaml
spring:
ai:
mcp:
client:
enabled: true
type: SYNC
request-timeout: 20s
toolcallback:
enabled: false
上面示例假设版本由 Spring AI BOM 管理。toolcallback.enabled=false 可关闭 MCP 工具回调自动集成,但不会自动建立权限控制;需要业务代码显式选择可暴露工具并在调用前授权。
3.2 工具网关骨架
java
public record ToolRequest(
String toolName, String resourceId,
Map<String, Object> arguments) {}
public interface ToolPolicy {
void authorize(AuthenticatedPrincipal caller,
ToolRequest request);
}
public final class GuardedToolGateway {
private final ToolPolicy policy;
private final McpInvoker invoker;
public GuardedToolGateway(ToolPolicy policy, McpInvoker invoker) {
this.policy = policy;
this.invoker = invoker;
}
public Object execute(AuthenticatedPrincipal caller,
ToolRequest request) {
policy.authorize(caller, request);
return invoker.call(caller, request);
}
}
McpInvoker 是本文自定义的抽象,用于封装真实 MCP Client 调用。该骨架不是可直接启动的完整 Spring AI 项目;必须保证所有工具调用都经过网关,且 MCP Server 端仍独立执行资源鉴权,避免绕过客户端。
四、两种最容易遗漏的共享状态
4.1 服务端发起的交互
MCP 允许服务端发起部分交互,例如 sampling 和 elicitation。共享 Session 的服务端发起请求可能无法单凭 Session 确定用户归属。需要在可信业务层绑定请求 ID、用户、租户、操作摘要、超时和一次性审批记录。
危险做法: 将共享 Session 上的审批请求随意发给当前在线用户,或者把模型自行生成的"用户已同意"视为授权。
4.2 工具清单与权限缓存
如果工具可见性因用户而异,却只按 serverId 缓存 tools/list,可能让不同用户看到错误的工具信息。缓存只能保存身份无关的工具定义,或者按用户/租户/权限版本分区并设置失效策略。不要把原始 Bearer Token 写进日志或长期缓存。
五、设计一组能够暴露串租户问题的测试
| 测试 | 操作 | 预期 |
|---|---|---|
| 正常读取 | A 读 A 的文档 | 允许 |
| 越权读取 | A 读 B 的文档 | 拒绝 |
| 会话污染 | A 设置当前目录,B 再读取 | B 不可见 A 状态 |
| 并发交错 | A/B 同时调用同一工具 | 无数据交叉 |
| 工具发现差异 | 初始化 A,后续 B 调用 | B 无法执行未授权工具 |
| Token 过期 | Session 仍然存活 | 新调用拒绝 |
| 参数伪造 | 模型传 tenantId=B | 不改变真实身份 |
| Server 重启 | Session 失效后重连 | 重新鉴权,无旧状态泄漏 |
5.1 最小授权测试骨架
java
@Test
void rejectCrossTenantRead() {
AuthenticatedPrincipal alice =
new AuthenticatedPrincipal("alice", "tenant-a");
ToolRequest request = new ToolRequest(
"document.read", "tenant-b:doc-42", Map.of());
assertThrows(AccessDeniedException.class,
() -> gateway.execute(alice, request));
verifyNoInteractions(invoker);
}
这里 AuthenticatedPrincipal 是业务 record,gateway 和 invoker 是 Mockito 测试夹具。该片段需要 JUnit 5、Mockito、Spring Security 与业务策略实现才能编译。重点断言是:拒绝授权后根本没有发起远程工具调用。
集成测试可使用一个故意按 Session 存 currentTenant 的模拟 MCP Server,让 A、B 交错操作,对比共享 Client 和隔离 Client 的行为。不要使用生产 Token 或客户数据测试。
六、生产落地的四道防线
身份: 每次 Tool Call 验证 issuer、audience、签名、过期时间和 scope,不信任模型传入的 tenantId。
权限: 客户端网关与 Server 双重校验,尤其是导出、删除、发送通知等写操作。高风险动作必须由可信后端审批,不能仅靠提示词约束。
隔离: 明确 Session、tools/list、缓存、工作目录、订阅和审计的归属;未知第三方 Server 优先做隔离评估。
恢复: Session 失效、HTTP 404、Token 轮换后安全重建连接;有副作用的 Tool Call 需要幂等键,避免超时重试重复执行。
七、常见误区与版本边界
- "传不同 Token 就隔离了":只代表请求身份可能不同,不保证 Session 状态隔离。
- "tools/list 不显示就不能调用":隐藏清单不等于授权,Server 必须独立检查。
- "提示词写明租户就安全":提示词不能替代可信的身份和数据层权限。
- "每个用户都必须独立 Client":无状态、逐请求授权的 Server 可以安全共享,关键是验证其行为。
本文以 Spring AI 1.1 参考文档为主要依据,不把 SNAPSHOT 文档特性当作稳定发布 API;第三方 MCP Server 的实现可能不同,实际依赖版本与传输方式必须核实。
结论: MCP 多租户安全首先是身份、会话状态与工具权限的边界问题。先弄清 Client 生命周期,再决定共享或隔离 Session,并通过交错并发测试验证,才能避免把模型工具接入变成数据越权入口。