1. 什么是任务？ #

任务是 MCP 的实验性功能，用于处理长时间运行的操作。请求方发送任务增强请求后，接收方立即返回任务 ID，实际结果通过轮询或延迟获取拿到。

协议版本：2025-11-25

2. 本章你将学到 #

• 任务的定义与角色
• 能力声明与工具级协商
• 创建、轮询、获取结果、取消的协议消息
• 任务状态与行为要求
• 错误处理与安全要点

3. 快速导航 #

4. 定义与角色 #

请求方驱动：请求方负责轮询；接收方控制哪些请求支持任务、并管理任务生命周期。

5. 能力 #

双方必须在初始化时声明 tasks 能力，才能使用任务增强。

5.1 服务端能力 #

5.2 客户端能力 #

5.3 工具级协商 #

工具在 tools/list 中通过 execution.taskSupport 声明：

6. 协议消息 #

6.1 创建任务 #

在请求的 params 中加入 task 字段：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": { "city": "New York" },
    "task": { "ttl": 60000 }
  }
}

响应：接收方返回 CreateTaskResult，包含 taskId、status、pollInterval 等，不包含实际结果。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "task": {
      "taskId": "786512e2-9e0d-44bd-8f29-789f320fe840",
      "status": "working",
      "statusMessage": "The operation is now in progress.",
      "createdAt": "2025-11-25T10:30:00Z",
      "lastUpdatedAt": "2025-11-25T10:40:00Z",
      "ttl": 60000,
      "pollInterval": 5000
    }
  }
}

6.2 轮询状态（tasks/get） #

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tasks/get",
  "params": { "taskId": "786512e2-9e0d-44bd-8f29-789f320fe840" }
}

请求方应当按 pollInterval 轮询，直至任务达到终止状态或 input_required。

6.3 获取结果（tasks/result） #

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tasks/result",
  "params": { "taskId": "786512e2-9e0d-44bd-8f29-789f320fe840" }
}

• 任务已终止：立即返回实际结果（或错误）
• 任务未终止：阻塞直至终止后返回

6.4 取消任务（tasks/cancel） #

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tasks/cancel",
  "params": { "taskId": "786512e2-9e0d-44bd-8f29-789f320fe840" }
}

必须使用 tasks/cancel 取消任务，不得使用 notifications/cancelled。

7. 任务状态 #

状态转换：working ↔ input_required → 终止状态（completed / failed / cancelled）。终止状态不可再转换。

8. 行为要点 #

9. 流程示意 #

10. 错误处理 #

10.1 协议错误 #

10.2 任务执行错误 #

底层请求失败时，任务进入 failed 状态；statusMessage 可包含诊断信息。tasks/result 返回底层请求原本会返回的内容（成功或错误）。

11. 安全要点 #