MCP server 在 OpenClaw 中是会话作用域（session-scoped）的：每个会话拥有自己独立的一组 MCP 客户端连接。两个并行会话即使读取同一份服务器配置，也会各自建立 Client + Transport，互不串扰。这样工具调用的状态、子进程、长连接都被严格隔离在会话边界内，会话销毁时连接随之拆除。

但连接的生命周期并不与会话一对一绑死。运行时之上有一个进程级的单例 manager（由 SESSION_MCP_RUNTIME_MANAGER_KEY 锚定），它负责为各会话登记、复用与回收连接。当一个会话的 MCP 配置指纹未变化时，已有连接被直接复用，避免重复握手与子进程冷启动；只有配置真正变化或会话空闲超时，才会触发重建或回收。

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";

type BundleMcpSession = {
  serverName: string;
  client: Client;
  transport: Transport;
  transportType: "stdio" | "sse" | "streamable-http";
  requestTimeoutMs: number;
  supportsParallelToolCalls: boolean;
  detachStderr?: () => void;
};

const SESSION_MCP_RUNTIME_MANAGER_KEY = Symbol.for("openclaw.sessionMcpRuntimeManager");

• serverName — 该连接对应的 MCP server 在配置中的逻辑名，用作工具命名空间前缀与日志标识。
• client — SDK 的 Client 实例，承载 listTools() / callTool() 等协议级请求。
• transport — 实现 Transport 接口的底层载体，client 通过它收发 JSON-RPC 消息。
• transportType — 三选一的字面量联合，标明该连接走的是 stdio、sse 还是 streamable-http。
• requestTimeoutMs — 单次协议请求的超时上限，源自服务器配置，避免请求无限挂起。
• supportsParallelToolCalls — 是否允许对该 server 并发派发多个工具调用，作为并行执行的开关。
• detachStderr — 可选回调，仅 stdio 传输有意义，用于在拆除连接时解除对子进程 stderr 的监听。

配置入口在 embedded-agent-mcp.ts 的 loadEmbeddedAgentMcpConfig()：它读取并物化嵌入式 agent 的 MCP 服务器声明。读出的配置记录交由 mcp-config-shared.ts 的 isMcpConfigRecord() 做结构校验，确保每条 server 记录字段合法。真正把一条配置记录解析为可用的 Transport 实例，则发生在 mcp-transport.ts 中——它根据记录里声明的传输形态分派构造对应的 transport。

工具调用链路始于 Client.listTools()——拉取 server 暴露的工具列表，把每个工具的名称与 JSON Schema 注册进 agent 的工具空间。实际执行时调用 Client.callTool()，传入工具名与参数，结果以 SDK 的 CallToolResult 类型返回（含内容块与可选的 isError 标记）。两步都受 requestTimeoutMs 约束。

export function createBundleMcpJsonSchemaValidator(): jsonSchemaValidator;
export function resolveSessionMcpConfigSummary(params: {...}): {...};
export function resolveSessionMcpConfigFingerprint(params: {...}): string;
function resolveSessionMcpRuntimeIdleTtlMs(cfg?: OpenClawConfig): number; // 默认 10 分钟

resolveSessionMcpConfigFingerprint() 把会话级 MCP 配置（服务器集合、传输声明、超时等）哈希成一个稳定的指纹字符串。每次会话需要 MCP 运行时，manager 先比对指纹：若与登记中的连接指纹一致，则直接复用现有 Client 与 Transport，跳过重新握手与 listTools() 目录拉取；只有指纹变化才会拆除旧连接并重建会话。

空闲的会话连接由 resolveSessionMcpRuntimeIdleTtlMs() 给出的 TTL（默认 10 分钟）管控——超过该窗口仍无调用的连接被回收，stdio 子进程随之关闭、detachStderr 被调用。工具参数的合法性则由 createBundleMcpJsonSchemaValidator() 产出的校验器按 server 暴露的 JSON Schema 把关。