HiDeepSeekDev
空闲特惠
教程指南MCPClaude Code长任务Agent 教程

Claude Code MCP 长任务教程:受理、后台运行、恢复与结果核对

按当前官方文档解释服务器任务与普通后台调用的区别,说明 CLI 公测条件、远端和 stdio 的生命周期,以及取消后仍需核对结果的原因。

快速结论

任务已受理不等于完成;远端任务与本地 stdio 的存活条件不同。保持服务器身份与连接设置,恢复原会话后再核对状态和实际产物。

  • 当前文档将 MCP Tasks 标为 Claude Code CLI 公测,要求 v2.1.304 或更新。
  • 服务器必须支持相应任务扩展,客户端也受协议和功能启用条件限制。
  • 取消请求不是服务器已经停止或外部操作回滚的保证。

本次更新:10 月 25 日核对原始来源后新增,注明消息日期、适用版本及验证范围。

本教程于 10 月 25 日核对 Claude Code 官方 MCP 文档。以下是阅读与验收方法,没有配置服务器或执行长任务,也不代表 DeepSeek Harness 已支持相同实现。

1. 先确认使用的能力

服务器返回任务标识后自行继续工作,与客户端把一个耗时调用移到后台,是不同机制。前者需要服务器实现任务扩展;后者不一定能在退出客户端后继续被跟踪。

当前文档将 MCP Tasks 标为 CLI 公测,要求 v2.1.304 或更新,并列有协议、功能开关、会话和调用来源条件。VS Code 扩展、桌面入口及第三方提供方等限制应直接核对当前文档,不能只靠版本数字判断支持。

2. 给任务建立一张记录卡

以下为编辑建议:记录会话、服务器、任务 ID、提交时间、目标产物和预期完成状态。先用不写入业务系统的小任务检查流程,再增加真正的外部动作。

状态 需要核对的证据
已受理 服务器返回任务身份,范围正确
运行中 状态持续可查询,必要输入已处理
已完成 结果可获取,文件或业务对象符合预期
失败或未知 保存错误,先查服务器是否已产生结果

3. 退出与恢复前确认运行位置

远端服务器任务可以在退出后继续;stdio 服务器进程通常随客户端退出,其任务是否继续须看服务器自己的说明。要继续跟踪,保持服务器名称和连接配置,并恢复发起任务的原会话。

不要把新会话打开成功,当作原任务已被重新接管。

4. 等待输入和取消分别处理

任务可能通过 elicitation 请求用户输入。遇到这种状态先确认需要补充什么,不能只靠延长超时处理。

发送取消请求后,服务器可能已经完成部分工作或仍会结束。特别是结果未知时,先查产物与服务器记录,再决定重发,避免重复提交。

5. 验收以结果为准

保存最终状态、错误和产物位置,核对“任务完成”与“用户目标完成”是否一致。这个方法同样适合审查其他 Agent 长工作流,但具体协议与命令仍按各自宿主文档处理。

参考资料

本文依据以下资料整理,版本与接口信息请以来源页面的现行说明为准。

  1. 01Claude Code 官方 MCP Tasks 与生命周期文档code.claude.com
阅读至此返回学习中心