智能体

把“安装成功”拆成依赖版本、启动命令、进程状态和客户端初始化四个可检查结果。

在接入模型前，用初始化、工具发现、合法参数和错误参数四步测试 MCP 链路，缩小排错范围。

用工具风险分级、调用预算和确认点约束智能体，而不是依赖“模型会谨慎”的假设。

解释初始化与能力协商为何应先于工具、资源和提示模板调用，并给出客户端功能检查的最小顺序。

给出首次接入 MCP 服务的顺序：确认客户端支持的传输、初始化、能力发现、只读调用和错误留档。

说明为什么标准输出的协议流不能混入调试日志，以及如何把诊断日志与业务审计拆开，方便定位调用链。

为可能耗时的 MCP 工具设计进度、取消与最终结果检查点，让客户端不会把等待误判为失败或完成。

说明工具结果为何需要区分结构化数据、给模型阅读的说明和 isError 语义，避免把失败伪装成空结果。

通过工具名称、输入 schema 版本、弃用标记和回归用例维护 MCP 工具库，减少客户端升级后的调用漂移。

用 prompts/list、prompts/get 的思路设计可复用任务模板，明确参数、引用材料和调用后的人工核对项。