MCP Server

角色

McpServer 是稳定可治理的 MCP server 身份对象，可被 AgentRevision.callableRefs[] 以 bindingMode=inject 引用，也可作为 Run.resourceType=mcp_server 的直接执行目标创建托管 MCP session。

具体的 MCP capability、私有 tool catalog、运行画像和鉴权策略定义在不可变 McpServerRevision 上。

核心字段

• mcpServerId
• orgId
• name
• description
• defaultReleaseChannelId
• latestRevisionId
• enabled
• metadata

规范要求

• McpServer MUST 有稳定身份，不随 revision 切换而漂移
• McpServer 作为 direct run target 时，CreateRun.input MUST 使用 MCP session bootstrap 输入形状，而不是 agent message 或 tool arguments
• Agent 注入 MCP 能力时 MUST 通过 AgentRevision.callableRefs[] 引用稳定的 McpServer 身份，且 bindingMode 为 inject
• McpServer 的对外 MCP 暴露 MUST 通过 McpServerRevision 与 ProtocolBinding(protocol=mcp) 组合完成

设计说明

• McpServer 负责 server 身份、目录入口与治理元数据
• McpServerRevision 负责 MCP capability、私有目录、运行画像和鉴权策略
• ReleaseChannel 负责 direct run 或 Agent 注入时解析到哪个 McpServerRevision
• 由 Agent 使用某个 MCP server 时，平台 SHOULD 为其创建独立的 mcp_server 子 run 和独立 RunSpace
• ProtocolBinding 负责 MCP endpoint、transport 和安全要求