MCP 与 Harness 接入 ​

MCP 与 Tool Registry 把已发布的 Function 和 Action 暴露为受控工具。Harness 不直接连接 Runtime、数据库或源系统。

接入前提 ​

客户端需要注册身份、允许的租户和委托方式。最终用户授权、Agent 身份和 Harness 客户端身份必须分别记录；客户端提交的身份字段不能替代认证结果。

接入流程 ​

1. 使用受支持的认证方式建立会话和租户上下文。
2. 获取当前主体可见的工具目录及版本。
3. 根据工具 Schema 构造参数，保留模型版本和幂等要求。
4. 只读工具同步返回或按查询协议分页；Action 工具返回 executionId。
5. 保存 traceId，并对异步 Action 查询状态或订阅回调。
6. 工具目录版本变化时重新发现，不缓存无期限的工具描述。

安全规则 ​

• 工具不可见意味着客户端不应获知其名称、参数和敏感描述。
• 工具可见不代表每个资源实例都可访问，执行时仍进行策略决策。
• 有副作用的工具必须声明副作用、幂等和审批可能性。
• Harness 不得把平台返回的敏感数据自动带入其他工具调用，除非策略和用途允许。

兼容性 ​

工具名称和主版本构成稳定身份。新增可选参数可以兼容；删除、重命名、收紧输入、改变副作用或错误语义需要新主版本和迁移说明。