MCP 新特性:长任务(Tasks)+ Elicitation(中途向用户要输入)
By 陈成 · Published October 29, 2026
MCP 新的长任务(Tasks)和中途向用户要输入(Elicitation)是什么,Claude Code 怎么实现,其他 agent 和 qodercli 跟进到哪了?
整理日期:2026-10-29 来源:X 书签、X 搜索、Claude Code 官方文档、MCP 规范、azukiazusa 的实测文章、Reddit r/mcp 讨论、Claude Code v2.1.312 解包源码(第 6 节)、qodercli 源码(第 7 节)、pi / opencode / Codex / pi-mcp-adapter 源码(第 8 节)
一句话
2026-10-24,Anthropic 宣布 Claude 支持 MCP Tasks 和 Elicitations,先在 Claude Code CLI 上线(v2.1.304+,public beta)。Tasks 让 MCP 服务器把耗时的调用变成“先返回任务 ID,之后再轮询结果”,Claude 不用干等;Elicitation 让服务器在执行途中弹窗问用户(确认退款、选账号、浏览器登录)。两者能组合:长任务跑到一半进入 input_required,弹出 Elicitation 对话框,用户答完任务继续跑。
关于书签
在 x.com/i/history 的书签里搜了 MCP、elicitation、MCP tasks、long-running,没有直接讲这个话题的书签。相关度最高的几条只是背景:
- @_philschmid:MCP 没死,是你用错了(按需加载 MCP、交给子代理)
- @ClaudeDevs:插件 = MCP + Skills,MCP 使用量今年涨了 110 倍
- @OpenAIDevs:Agents SDK 支持长任务 agent
所以下面的内容主要来自 X 搜索、官方文档和 Reddit。
1. 发布信息
| 项目 | 内容 |
|---|---|
| 发布 | @ClaudeDevs 2026-10-24(62 万浏览,5.9K 赞) |
| 可用范围 | Claude Code 终端 CLI、Agent SDK、GitHub Actions;VS Code 插件和桌面端暂不支持,其他 Claude 产品“陆续上线” |
| 版本 | Claude Code v2.1.304+,MCP Tasks 为 public beta |
| 协议版本 | Tasks 要求连接使用 MCP 协议修订版 2026-07-28 |
| 规范 | Tasks 是扩展 io.modelcontextprotocol/tasks(SEP-2663,ext-tasks 仓库);Elicitation 是核心规范的一部分,2025-06-18 引入,URL 模式见 SEP-1036 |
官方原话:
- Tasks:让 Claude 把深度调研之类的长任务交给插件,做完再回报。
- Elicitations:让插件在任务途中向用户要输入,比如确认一笔退款、补一个缺失的字段。
2. MCP Tasks:解决什么问题
MCP 的 tools/call 本来是同步的:请求发出去,连接一直挂着等结果。几秒的事没问题,跑测试、导出报表、构建镜像这种几分钟到几小时的任务就不行了,客户端和中间层有超时,连接一断结果就丢了。
@stretchcloud 的说法:这就是后端团队十年前用 Celery/Sidekiq 解决过的任务队列模式,现在搬到了 agent 和工具之间的协议层。
Tasks 的做法:
- 服务器按请求决定是否返回任务。不需要给每个工具单独打标记,客户端只要在能力里声明一次支持。
- 返回
resultType: "task"加一个持久的taskId,客户端用tasks/get轮询。 - 状态有 5 种:
working/input_required/completed/failed/cancelled,后三种是终态。 - 任务 ID 在断线、重启之后仍然有效,可以接着轮询。
tasks/cancel是协作式的:服务器只是收到了取消请求,可以照样把活干完。
时序图
sequenceDiagram
participant U as 用户
participant C as Claude Code(客户端)
participant S as MCP 服务器
C->>S: tools/call(_meta 声明支持 tasks 扩展)
S-->>C: resultType:"task", taskId, status:working, pollIntervalMs
Note over C: Claude 拿到 taskId 立即继续干别的<br/>底栏显示 "1 MCP task"
loop 每 pollIntervalMs(默认 2s,限制 250ms~30s)
C->>S: tasks/get(taskId)
S-->>C: status:working, statusMessage:"40/212 files"
end
S-->>C: status:input_required, inputRequests{ key: elicitation/create }
C->>U: 弹出 Elicitation 对话框(暂停轮询)
U-->>C: accept / decline / cancel
C->>S: tasks/update(taskId, inputResponses{ key: ... })
loop 继续轮询
C->>S: tasks/get(taskId)
end
S-->>C: status:completed, result{ content: [...] }
Note over C: 对话里出现<br/>"MCP task <id> (server/tool) completed."
状态机
stateDiagram-v2
[*] --> working: tools/call 返回 CreateTaskResult
working --> input_required: 需要用户输入
input_required --> working: tasks/update 提交回答
working --> completed: 正常完成(含 isError:true 的工具结果)
working --> failed: JSON-RPC 错误
working --> cancelled: tasks/cancel(服务器可不理会)
input_required --> cancelled
completed --> [*]
failed --> [*]
cancelled --> [*]
注意:工具返回 isError: true 时任务状态是 completed,不是 failed。协议层面这次调用是成功的,failed 只表示 JSON-RPC 错误。
3. Claude Code 里的实际行为(官方文档要点)
来源:Connect Claude Code to tools via MCP
两种“后台”要区分
| 自动后台化(普通调用) | MCP Task(服务器端任务) | |
|---|---|---|
| 触发 | 主会话里的 MCP 调用超过 2 分钟还没返回 | 服务器支持 tasks 扩展,返回了 task |
| 跑在哪 | 客户端还挂着这个请求 | 服务器自己跑 |
| 退出会话后 | 丢失 | 远程服务器上的任务继续跑,claude --resume 原会话可以重新接上 |
| 超时 | 仍受 wall-clock 和 idle timeout 约束 | 返回 task 之后,Claude Code 默认不设时间限制 |
| 调整 | CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS(设 0 关闭) |
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1 让 Claude 等结果 |
操作
- 底栏显示
1 MCP task;/tasks里能看到 statusMessage,选中按x取消(会发tasks/cancel)。按 Esc 停不掉后台任务。 - 任务结束时对话里出现:
MCP task <server task id> (<server>/<tool>) completed. /tasks开着的时候 Elicitation 对话框是隐藏的,关掉/tasks才能回答。
什么情况下拿不到 MCP Task
- 一次性的
claude -p "<prompt>"不支持(进程可能在结果回来之前就退出了) - 子代理里发起的调用
- 第三方模型提供方(如 Bedrock)或关闭了 feature flag 拉取
- VS Code 插件、桌面端
- stdio 服务器:Claude Code 退出时进程也跟着停,所以任务活不过会话
退出、清空、恢复
| 场景 | 结果 |
|---|---|
/clear、/branch、/resume 到别的会话,但 Claude Code 没退出 |
结果会进入当前对话 |
| 退出 Claude Code | 远程任务不会被取消,想停要先在 /tasks 里停 |
claude --resume / --continue 交互式回到原会话 |
服务器连上后继续跟踪,已完成的结果也能拿到 |
新会话或 --fork-session |
不跟踪 |
| 改了服务器名或连接配置 | 报 reconfigured to a different transport,要改回原配置 |
非交互模式下的 Elicitation
任务在非交互会话里请求用户输入时,Claude Code 会直接要求服务器取消任务,不跑 Elicitation hooks,也不调用 Agent SDK 的 onElicitation。@DevilDogSaga 的建议:过夜任务在启动前就把需要的信息问清楚,免得调研跑了一小时才发现卡在一个没人回答的问题上。
4. Elicitation:中途向人要输入
两种模式
| 模式 | 用途 | 数据流 |
|---|---|---|
| form | 服务器用 JSON Schema 定义表单(只能是扁平对象:字符串 / 数字 / 布尔 / 枚举),客户端渲染对话框 | 数据经过客户端发给服务器 |
| url | 让用户在浏览器里打开链接完成操作(典型场景是 OAuth 登录、支付) | 敏感数据不经过客户端 |
规范要求(MUST NOT):密码、API key、token、支付信息不能用 form 模式收集,必须走 URL 模式。这样也避免了“客户端拿到 token 再转给服务器”这种 token passthrough 反模式。
用户的回答有三种 action:accept(提交)、decline(明确拒绝)、cancel(直接关掉,比如按 Esc)。在 Claude Code 里,拒绝和 Esc 也会作为回答发给服务器,由服务器决定任务是否继续。
2026-07-28 规范的变化:没有会话了
旧规范(2025-11-25 及以前)里服务器是主动往客户端发 elicitation/create 请求的,这要求有会话和双向通道。2026-07-28 去掉了 initialize 握手和会话(@choopyplug1 提到 MCP 2.0 “killed sessions”,所以服务器能直接部署到 Lambda / Workers),客户端改为每次请求在 _meta 里带上自己的能力。Elicitation 因此有两条路径:
flowchart LR
A[服务器需要用户输入] --> B{这次调用是长任务吗?}
B -- 否,几秒内的交互 --> M["MRTR<br/>tools/call 返回 resultType:input_required<br/>客户端带 inputResponses 用新 ID 重发 tools/call"]
B -- 是 --> T["Task input_required<br/>tasks/get 响应里带 inputRequests<br/>客户端用 tasks/update 回答"]
M --> D[Claude 一直等对话框结果]
T --> E[Claude 可以继续干别的<br/>对话框出现时轮询暂停]
两条路径里 inputRequests 的格式一样,都是 key → { method, params }。
Claude Code 声明的 Elicitation 能力
- 2026-07-28 连接,以及旧协议下用户自己配置的 stdio/sse/http/ws 服务器(v2.1.287+):
elicitation: {form: {}, url: {}} - 旧协议下的 claude.ai connector:只有
elicitation: {},即只支持 form - 想不弹窗自动回答,用 Elicitation hook
- Java MCP SDK ≤ 0.17.0 可能会拒绝带 form+url 的能力声明
5. 服务器作者要点
// tools/call 的响应:返回一个任务
{
"resultType": "task",
"taskId": "build-7f3a9c2e",
"status": "working",
"statusMessage": "Compiling, 40 of 212 files done",
"createdAt": "2026-10-22T14:03:07Z",
"lastUpdatedAt": "2026-10-22T14:03:07Z",
"ttlMs": null,
"pollIntervalMs": 5000
}
// tasks/get 响应:需要用户选择
{
"resultType": "complete",
"taskId": "6c2f...",
"status": "input_required",
"inputRequests": {
"audience": {
"method": "elicitation/create",
"params": {
"mode": "form",
"message": "调研完成,请选择报告的公开范围",
"requestedSchema": {
"type": "object",
"properties": {
"audience": { "type": "string", "oneOf": [
{ "const": "team", "title": "团队内" },
{ "const": "company", "title": "全公司" } ] }
},
"required": ["audience"]
}
}
}
}
}
检查清单:
- 只在请求带了扩展时才返回 task(看
params._meta["io.modelcontextprotocol/clientCapabilities"].extensions),否则 Claude 会报Unsupported result type 'task' for tools/call。 taskId、status、createdAt、lastUpdatedAt、ttlMs都是必填(ttlMs可以是 null);taskId≤128 个可打印 ASCII 字符、不含空格,而且跨连接都要能查到,因为 resume 之后是新连接。- HTTP / connector 服务器要先接下任务、马上返回,再开始干活,task 响应必须在单请求超时内发出。
- 先把任务持久化,确保
tasks/get能查到,再返回 CreateTaskResult。 - Claude Code 不用
tasks/result、tasks/list、notifications/tasks,结果都放在tasks/get的响应里。 - 每个任务最多处理 16 个
inputRequestskey;Claude Code 里elicitation/create只在交互式终端会话中处理,roots/list任何地方都处理。 - 对未知 ID 返回
-32602。Claude Code 会重试 5 分钟,之后告诉 Claude 结果未知(outcome unknown),此时再调一次工具可能会重复执行。 - SDK 现状:截至 10-25,TypeScript SDK v2 服务端还没实现 Tasks 扩展(typescript-sdk#2189),
tasks/get等方法要自己写成自定义方法。
实测(azukiazusa)
Claude Code で MCP Tasks と Elicitation を試す:用 @modelcontextprotocol/server@2.3.1 写了 deep_research(返回 task,中途用 Elicitation 选公开范围)和 share_report(不用 task,走 MRTR 确认)两个工具。观察到的现象:
- Claude 调用后马上回复“开始调研了”就结束这一轮,底栏出现
1 MCP task - 服务器日志里
tasks/get每 2 秒一次 - 进入
input_required后弹出对话框,oneOf.title作为选项文案;对话框打开期间轮询暂停,Accept 之后先发tasks/update再恢复轮询 - MRTR 路径显示
Fulfilling input required by 'tools/call' (round 1),Claude 会一直等到对话框有结果
6. 源码印证:Claude Code v2.1.312 的实现
读的是 claude-code-versions/versions/2.1.312-unbundled/extracted 里解包出来的 chunk。变量名被压缩过,但有几个模块保留了导出名,能对上号:
| 模块 | 文件 | 作用 |
|---|---|---|
driveMcpTask、clampPollInterval、CreateTaskResultSchema、AGENT_TASK_META_KEY |
chunk-mr62jrpa.js(经 chunk-ymt900z1.js 导出) |
单个任务的轮询 / 回答 / 取消循环,协议 schema |
registerOrAdoptSep2663Task、startSep2663BackgroundDrive、restoreSep2663Tasks、buildSep2663EndingNotice |
chunk-wng7abg0.js |
后台任务注册、断线重连、resume 恢复、结束通知 |
callTool 里的 task 分支、resolveInputRequest |
chunk-81h7g826.js(v2 MCP 客户端) |
决定是否声明 tasks、拿到 task 后走后台还是内联轮询 |
buildMcpTaskNotification、restoreMcpTasks |
chunk-jyg2qka3.js |
对话里那条 MCP task ... completed. 通知 |
handleElicitationRequest、runElicitationHooks |
chunk-fxn6vs2j.js |
Elicitation 对话框和 hooks |
| MRTR 循环 | chunk-8gvpcjtj.js(内置的 MCP SDK) |
Fulfilling input required by '...' (round N) |
6.1 和文档一致的常量
| 文档说法 | 源码 |
|---|---|
| 轮询间隔默认 2s,限制在 250ms~30s | clampPollInterval = min(30000, max(250, ms ?? 2000)),每次 tasks/get 响应里的 pollIntervalMs 都会重新取值 |
| 状态 5 种 | zod 判别联合:working / input_required(带 inputRequests)/ completed(带 result)/ failed(带 error{code,message,data})/ cancelled |
taskId ≤128 个可打印 ASCII、无空格 |
max(128) + /^[\x21-\x7e]+$/ |
| 每个任务最多 16 个 input key | 常量 L = 16,超出后新 key 直接忽略,只记一次日志 |
| 普通调用 2 分钟自动后台化 | getMcpAutoBackgroundMs 默认 120000 |
-32602 之后重试 5 分钟,然后 outcome unknown |
reconnectDeadlineMs = 300000;到期后给 Claude 的通知原文是 “Task outcome unknown ... Calling the tool again may repeat the work, so first check what was done ...” |
不用 tasks/result / tasks/list |
客户端只发 tasks/get、tasks/update、tasks/cancel 三个方法 |
| MRTR 一直等对话框 | SDK 默认 autoFulfill: true、maxRounds: 10,超过 10 轮抛 InputRequiredRoundsExceeded |
6.2 什么时候声明 tasks 扩展
callTool 里的判断大致是:
tasksOn = tengu_glowing_lark // 总开关(feature flag,默认关)
disallow = 子代理调用(agentId 存在)
|| (非交互会话 && 没有后台任务上下文)
|| ...
allowTask = tasksOn && !disallow && 服务器不在远程环境的禁用名单里
声明扩展 = allowTask && 连接的协议代际是 "modern"(2026-07-28)
- 子代理、
claude -p不声明扩展,所以合规的服务器不会返回 task。这就是文档里“拿不到 MCP Task”那几条的实现方式。 - 设了
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1时仍然声明扩展,但拿到 task 后内联轮询(日志polling inline),把状态当 progress 显示,Claude 一直等到结束。 - 还有一个 MCP 客户端代际开关:
MCP_SDK_GENERATION=v1|v2,或 flagtengu_brindle_causeway(默认 v2)。SEP-2663 Tasks 只在 v2 客户端里有,切回 v1 就没有 Tasks。 - 恢复会话时,旧的 2025-11-25 版 tasks 协议留下的记录会被直接删掉,日志写明“this version no longer supports; the task was not cancelled on the server”。
6.3 一次 task 调用的完整路径
flowchart TD
A[tools/call 返回] --> B{CreateTaskResult 合法?}
B -- "resultType:task 但字段不全" --> B1[尝试 tasks/cancel<br/>返回 isError:malformed task handle]
B -- 是 --> C{有后台上下文?}
C -- 否 --> D[内联 driveMcpTask<br/>progress 显示状态]
C -- 是 --> E[注册 mcp_task<br/>写 sidecar 元数据供 --resume]
E --> F[立即返回占位结果给 Claude<br/>“moved to the background as task X”]
E --> G[startSep2663BackgroundDrive]
G --> H[driveMcpTask 循环]
H -- completed --> I[渲染 result → task-notification]
H -- input_required --> J[resolveInputRequest]
J -- 交互式 --> K[Elicitation 对话框] --> L[tasks/update] --> H
J -- 非交互 / URL 模式被关 --> M[TaskInputUnservableError → tasks/cancel]
H -- 连续 5 次轮询失败 --> N[等服务器重连,最多 5 分钟]
N -- 重连成功 --> H
N -- 超时 / 换了 transport / 协议降级 --> P[任务 parked,不通知 Claude]
几个文档里没写的细节:
- 轮询请求带
Mcp-Name: <taskId>头。tasks/get、tasks/update、tasks/cancel都带,方便无状态部署按任务路由。 - 回答按 key 缓存。同一个 key 回答过就不会再弹框;
tasks/update返回非服务器类的 JSON-RPC 错误时,把这些 key 标记为“被拒”,250ms 后重新拉状态;如果服务器还在要同一个 key,就报unsupported_input并取消任务。 tasks/update网络失败最多重试 5 次;tasks/get还能通但答案一直交不上去时,报update_unreachable。- 结果太大:轮询响应超出 HTTP body 上限时报
answer_too_large,提示 Claude “工具可能已经跑过,重跑前先确认,并请求更少数据”。 - 断线不等于失败。重连失败、需要重新登录、服务器换了 transport(
identity_mismatch)、重连后协议降级(era_mismatch)、TTL 过期、会话退出(shutting_down)这些情况,任务被标记为 parked,不会给 Claude 发失败通知,--resume时会重新接上(after_park/after_restart)。有些模式下 parked 之后还会以 30s~5min 的指数退避继续慢速轮询。 - 退出 Claude Code 不会发
tasks/cancel。退出时任务以shutting_down停下,日志写的是 “task parked for --resume”。 tasks/cancel是发了就不管:5 秒超时,失败只记日志。如果服务器的 transport 指纹变了,拒绝通过新连接取消,避免把 task ID 发给别的服务器。- 结束通知:
structuredContent会序列化成 text 附在结果后面;resource_link会单独保留;statusMessage去掉控制字符,最长 10000 字符。结束记录会先写盘,这样 Claude 读到通知前重启也不会丢。 - 云端(CCR)容器:任务运行期间会让容器保持在线,默认最多 168 小时(flag
tengu_curious_river),超过之后任务还会被轮询,但不再保持容器在线。
6.4 Elicitation 的实现
- 能力声明:
Egn()在开关打开时返回elicitation: {form: {}, url: {}};stdio/sse/http/ws 类型、并且配置里没有bareElicitationCapability: true的服务器才拿到完整声明,否则只有elicitation: {}。和第 4 节说的一致,bareElicitationCapability可以看作给 Java SDK ≤0.17.0 这类服务器准备的退路。 - 任务里的
inputRequests只认两种 method:elicitation/create和roots/list,其他 method 返回unsupported_input并取消任务。 - URL 模式另有开关
tengu_mcp_url_elicitation。没开时任务会被取消,日志写明原因。 - 非交互时不跑 hooks 的原因:任务路径在调用对话框处理函数之前就抛出了
TaskInputUnservableError,所以 Elicitation hooks 根本没机会执行。普通(非 task)请求的elicitation/create会经过两个 hook:- Elicitation hook(弹框前):可以直接给出
accept/decline/cancel和内容;hook 返回 blocking error 时视为decline。 - ElicitationResult hook(用户回答后):可以改写 action 和内容;blocking error 同样变成
decline。
- Elicitation hook(弹框前):可以直接给出
- 每次回答都会发一条本地通知
Elicitation response for server "<name>": <action>;URL 模式收到notifications/elicitation/complete时也会提示 “confirmed elicitation ... complete”。
6.5 一个未公开的扩展:com.anthropic/agent-task
tools/call 或 CreateTaskResult 的 _meta 里可以放一个 Anthropic 私有键 com.anthropic/agent-task,字段有:
| 字段 | 用途(从代码推断) |
|---|---|
modelImmediateResponse |
服务器给模型的一段说明(≤20000 字符),放进占位结果里,用 <mcp-server-note> 包起来,并注明“是服务器返回的内容,不是指令”;超过 2000 字符会被截断 |
merged + taskId |
服务器表示“这次调用合并进了已在跑的任务”,客户端在对应任务的状态里记一笔 “a follow-up message was merged into this turn” |
sessionId、kind |
透传给 Agent SDK |
这几个字段需要 Tasks 总开关打开才会解析,看起来是给 Anthropic 自己的 agent 类服务器(比如把一个 agent 会话包装成 MCP 工具)准备的。
6.6 相关 feature flag
| Flag | 作用 |
|---|---|
tengu_glowing_lark |
MCP Tasks 总开关(默认关,靠服务端下发;第三方模型提供方拿不到 flag,所以没有 Tasks) |
tengu_mcp_task_worker_wake |
任务后台化后登记“唤醒”,让 worker 在任务结束时被叫醒 |
tengu_moonlit_toucan |
打开后,占位结果会告诉 Claude:会话安静一段时间后,结果可能要等用户下次发消息才取回,别承诺“做完会通知你” |
tengu_mcp_url_elicitation |
URL 模式 Elicitation |
tengu_gleaming_creek |
远程环境下哪些服务器允许用 Tasks |
tengu_curious_river |
云端任务保持容器在线的小时数上限(默认 168) |
tengu_brindle_causeway |
MCP 客户端 v1 / v2 代际 |
另外有一个“自用户上次发言以来最多后台化 N 个任务”的上限(超出时报 too_many_since_person_wrote 并取消任务),代码已经写好了,但这个版本里没有地方给它设值,所以没有生效。
7. 对 qodercli 意味着什么
看的是 ~/Projects/qodercli 的 develop 分支(HEAD 782cbb8ab6)。结论先说:qodercli 目前没有 Tasks,Elicitation 只做了一半,而且两者都卡在同一个前置条件上:还没升级到 2026-07-28 协议。
7.1 现状对照
| 项目 | Claude Code v2.1.312 | qodercli |
|---|---|---|
| MCP SDK / 协议 | 自带 v2 客户端,支持 2026-07-28(protocolEra: "modern") |
@modelcontextprotocol/sdk@1.29.0,LATEST_PROTOCOL_VERSION = '2025-11-25';源码里没有 server/discover,2026-07-28 只出现在设计文档(docs/design/2026-08-15-mcp-qoder-auth-state-extension.md)里 |
| Tasks(SEP-2663) | 有:后台任务、/tasks、resume 恢复 |
没有。源码里搜不到 tasks/get、CreateTaskResult、resultType,也不声明 tasks 扩展 |
| 长调用 | 2 分钟后自动后台化 | 一直同步等。硬超时默认 100_000_000ms(约 27.8 小时,可用服务器 timeout 或 MCP_TOOL_TIMEOUT 调整);idle 超时 stdio 30 分钟、远程 5 分钟(QODER_MCP_TOOL_IDLE_TIMEOUT),收到 progress 通知会重置计时(packages/core/src/mcp/tools/mcp-timeouts.ts) |
| Elicitation 能力声明 | {form:{}, url:{}},对兼容性差的服务器退回 {} |
固定 elicitation: {}(connectMcpServer.ts 的 buildClientCapabilities)。注释写明是为了不让 Spring AI / Java SDK 服务器报错。按规范,{} 等于只支持 form,所以服务器不会发 URL 模式 |
| 哪些服务器能 Elicitation | 用户配置的 stdio/sse/http/ws 服务器、claude.ai connector | 只有会话自己的服务器:dynamic(agent 内联)和 SDK 注入的。用户 / 项目 / local / 插件配置的服务器走进程级共享连接池,根本不声明 elicitation |
| 交互式终端里的对话框 | 有 | 没有。只有 --output-format stream-json 时才装 ElicitationBridge(cli/src/thread-manager/thread-session/host/elicitationBridge.ts),把请求作为 elicitation 控制消息转给宿主(SDK / IDE / remote-control)。TUI 里没有 hook 接管时,一律回 {action:'cancel'} |
| Elicitation hooks | Elicitation / ElicitationResult |
同名同语义,代码注释写的是 “Mirror of cc-src services/mcp/elicitationHandler.ts”。blocking error → decline,result hook 可以改写 action/content |
| 对话框期间的超时 | 对话框打开时不算 idle | 一样:弹框前 pauseIdleTimeouts(),结束后恢复 |
| 后台任务基础设施 | mcp_task 是任务注册表里的一种类型 |
已有 UnifiedTask 注册表(local_bash、local_agent、local_workflow 等)、/tasks 命令、stop_task 控制消息和 task notification,只是没有 mcp_task 类型 |
还有一点:视频生成的设计文档(docs/design/2026-08-28-video-generation-design.md)明确说“复用既有权限管线,不引入第二套 elicitation 机制”。也就是说,qodercli 目前把“昂贵操作前确认”放在自己的权限系统里做,而不是走 MCP Elicitation。
7.2 用户和服务器作者实际会遇到什么
- **为 Claude Code 写的 Tasks 服务器,在 qodercli 里会退回同步调用。**qodercli 不声明扩展,合规的服务器不会返回 task(见第 5 节检查清单第 1 条)。如果服务器不检查就返回 task,SDK 1.29 不认识
resultType: "task",调用会失败。 - **远程服务器上的长任务,5 分钟内没有 progress 通知就会被 idle 超时打断。**Tasks 在 Claude Code 里解决的问题,在 qodercli 里要靠服务器自己发 progress,或者服务器提供 job id + 状态工具。
- **用户在
settings.json里配的服务器不会弹 Elicitation。**它们不声明能力,合规服务器会走自己的兜底逻辑;不合规的服务器发elicitation/create,SDK 会因为客户端没有注册 handler 而拒绝。 - TUI 用户即使碰到 agent 内联的服务器,Elicitation 也会被静默取消,除非配了 Elicitation hook。只有 IDE、SDK 这些 stream-json 宿主能真正把问题交给人。
- URL 模式(OAuth、支付)实际不可用:能力只声明了
{},桥代码虽然会透传mode/url,但合规服务器不会发 URL 模式请求。
7.3 要跟上需要做什么(按依赖顺序)
- **TUI 里的 Elicitation 对话框。**最便宜、收益最直接。宿主侧的数据结构和 hooks 都有了,缺的是一个 Ink 组件,加上在交互模式下
setElicitationBridge。对话框要显示是哪个服务器在问(第 9 节 @m0rtitech 的意见)。 - **让磁盘配置的服务器也能 Elicitation。**难点在于共享连接池:一个连接被多个会话复用,
elicitation/create要能路由回发起这次tools/call的会话。可以按请求关联(progress token / request id → session),也可以让需要 Elicitation 的服务器按会话单独建连接。 - **能力声明分开处理。**参考 Claude Code:默认
{form:{}, url:{}},给 Java SDK 这类服务器加一个配置项退回{}(Claude Code 叫bareElicitationCapability),而不是为了兼容少数服务器让所有服务器都用不了 URL 模式。 - **升级到 2026-07-28(MCP TS SDK v2)。**这是 Tasks 的前提,auth-state 扩展的设计文档已经把它列为目标,双 era 协商(
initializevsserver/discover)的思路也写好了,可以直接复用。注意第 5 节提到 TS SDK v2 服务端还没实现 Tasks,但客户端只需要发三个方法(tasks/get/tasks/update/tasks/cancel),用自定义请求就能做。 - **Tasks 客户端。**在
UnifiedTask里加mcp_task类型,复用/tasks、stop_task和 task notification。第 6 节可以直接当实现参考:- 轮询间隔限制在 250ms~30s,回答按 key 缓存,最多 16 个 key;
- 子代理和非交互模式下不声明扩展,交互模式下遇到
input_required才弹框,非交互时直接tasks/cancel; - 断线时先把任务 parked 起来,
--resume后重新接上,不要直接告诉模型“失败了”; - 服务器明确说不认识 task ID(
-32602)时才报 “outcome unknown”,并提示模型重跑前先确认; - 用 transport 指纹防止 task ID 被发到换了配置的服务器。
- 在那之前,文档里先写清楚兜底方式:qodercli 不支持 Tasks 和 URL 模式 Elicitation;长任务请服务器定期发 progress,或者提供 job id + 状态工具。
8. pi / opencode / Codex 有没有跟进
2026-10-29 拉取各仓库最新主干看的(pi f14813e96、opencode 726cf09639、Codex b75d1e8966),另外看了 pi 的第三方插件 nicobailon/pi-mcp-adapter(a25429c,第 9 节 @nicopreme 提到的就是它)。
**一句话:三家本体都还没做 Tasks。**opencode 和 Codex 都有公开 issue,还没合入代码。Elicitation 方面,Codex 最完整,opencode 已支持,pi 本体完全不支持。目前只有 pi-mcp-adapter 这个第三方插件真正实现了 Tasks。
8.1 总表
| Claude Code | pi(本体) | pi-mcp-adapter | opencode | Codex | |
|---|---|---|---|---|---|
| MCP 实现 | 自带 v2 客户端 | 自写的 packages/mcp |
TS SDK @modelcontextprotocol/client@2.3.1 + ext-tasks@0.2.2 |
TS SDK @modelcontextprotocol/client@2.3.1 |
Rust rmcp 3.5.1 |
| 2026-07-28 | 支持,默认可用 | 不支持,最高 2025-11-25,一致性测试里写明“a stateless protocol pi does not implement” | 支持,每个服务器可选 protocolVersion: "legacy"|"auto"|"2026-07-28",默认 legacy |
支持,每个服务器可选 protocol: "legacy"|"auto"|"2026-07-28",默认 legacy |
实现了,在 feature flag mcp_2026_07_28 后面,UnderDevelopment、默认关 |
MRTR(input_required) |
支持 | 不支持 | 支持(SDK) | 走 SDK 默认的自动处理,用 modern 连接时生效 | 自己实现了循环(rmcp-client/src/request_input.rs),还在 flag 后面 |
| Tasks(SEP-2663) | 支持,public beta | 不支持 | 支持:v6.0.0(10-22)加入,v7.0.0(10-25)改成后台执行 | 不支持;#49227(09-15 提出,open) | 不支持;#48617(09-27 提出,open) |
| Elicitation form | 支持 | 不支持(一致性测试里列为已知失败) | 支持 | 支持 | 支持 |
| Elicitation URL | 支持(有 flag) | 不支持 | 支持(只允许 http/https,打开浏览器) | 支持 | 支持(提示里的 URL 可点击) |
| 长调用的默认超时 | 2 分钟后自动后台化 | 请求超时 30s,可配,progress 会重置计时 | 有 Tasks 的服务器在后台跑 | 硬上限 12 小时,自动请求 progress 保持连接 | tool_timeout_sec 默认 300s |
8.2 pi
- **本体态度很明确:不做。**MCP 由自写的
packages/mcp实现,只到 2025-11-25;能力声明里只有roots。test/mcp-conformance/README.md的已知失败列表写着 “pi does not support elicitation”,并说明 2026-07-28 不在测试范围内。近两个月的 MCP 提交都是 OAuth、结构化内容这类修补,没有 Tasks 和 Elicitation 相关的工作,也没有相关 issue。 - **生态里由插件补上。**pi-mcp-adapter 是目前看到的、除 Claude Code 外唯一完整实现 SEP-2663 的 agent 客户端:
- 用官方的
@modelcontextprotocol/ext-tasks做请求方,自己提供原始请求通道和Mcp-Name头; - 只有服务器支持 Tasks、并且该服务器配置了
"protocolVersion": "auto"才启用,也可以按服务器tasks: false关掉; - v7.0.0 起调用立即返回,结果以新消息送达;退出 pi 后重开同一会话还能拿到结果;
/mcp-adapter tasks可以列出、停止任务,agent 自己也能停掉不再需要的任务; - 任务中途要输入时,即使调用已经返回,也会弹 form 或浏览器提示;
- 修过一个坑:服务器没给
pollIntervalMs时曾经每秒轮询约 100 次,后来改成默认 1 秒(Claude Code 默认 2 秒)。
- 用官方的
8.3 opencode
- 9 月中旬重写了 MCP 客户端(
cbe8823671,09-14,“rework MCP client for SDK v2 and the 2026-07-28 revision”),换成 TS SDK v2,支持 2026-07-28,但默认仍是legacy,要在服务器配置里写protocol: "auto"或"2026-07-28"。 - Elicitation 是最近两周才真正能用的:
- 10-15
3aa26f1676:能力声明改成符合规范的elicitation: {form: {}, url: {}}; - 10-22
889abb4657:修复 form 根本不弹出的问题; - 10-23
8482dbf1e7:桌面端和 Web 端也能显示 form; - 10-01
96339544bf:通过 ACP 把 form 交给外部编辑器回答。
- 10-15
- 实现细节:Elicitation 挂在“Location”(工作目录)下,而不是某个会话下(
GLOBAL_ELICITATION_SESSION_ID = "global"),因为服务器没法说清楚是哪个会话在问。用户没回答时一律返回cancel,不区分decline。URL 模式下,legacy 连接用notifications/elicitation/complete结束对话框;2026-07-28 没有elicitationId和这个通知,所以只能等用户手动确认。 - Tasks 没有:
callTool不带allowTask,也没装ext-tasks。长调用靠 12 小时硬上限加自动请求 progress 撑着(代码注释:“Requesting progress keeps long calls alive under the SDK's timeout”)。
8.4 Codex
- Elicitation 是三家里最成熟的,而且和审批策略绑在一起(
codex-mcp/src/elicitation.rs):approval_policy = never(codex exec常用)时,Elicitation 一律decline;Granular策略可以单独决定是否允许 MCP Elicitation;- 权限提示被自动批准时,没有字段的 form(纯确认框)会自动 accept,有字段的仍然要问人;
- Guardian 自动审查可以代替用户审 Elicitation,审查失败时以 “Do not proceed without asking the user for explicit approval” 拒绝;
- 支持 form、URL,还有 OpenAI 私有扩展(
OpenAiForm、UserVerification用户验证)。“用户验证”只发给 Codex 自己托管的 Apps 服务器,第三方服务器即使声明了也会被过滤掉; - 用户没回答就放弃的 Elicitation 会主动告诉服务器(
a6baf8867c)。
- 2026-07-28 已经写完,但没打开:flag
mcp_2026_07_28和托管 Apps 用的codex_apps_mcp_2026_07_28都是UnderDevelopment、默认关。MRTR 循环、server/discover、本地 stdio 服务器的协议探测(0bc73bbeb1)和共享连接时按调用方隔离 input(7d1492ffab)都在近期合入。这说明 Codex 已经在处理 qodercli 7.3 第 2 步遇到的同一个问题:一个连接被多个会话共享时,input 请求该交给谁。 - Tasks 没有:源码里没有
tasks/get、CreateTaskResult,只有 issue #48617。默认工具超时 300 秒,可以按服务器设tool_timeout_sec。
8.5 小结
- Tasks 目前是 Claude Code 独有的功能,其他客户端只能靠插件(pi-mcp-adapter)。对服务器作者来说,第 5 节检查清单的第 1 条(只在客户端声明扩展时返回 task)不是可选项。现在大多数客户端都会走同步路径,长任务仍然要发 progress,或者提供 job id + 状态工具作为兜底。
- 2026-07-28 是共同的门槛。opencode 和 pi-mcp-adapter 默认 legacy,Codex 在 flag 后面,pi 本体不打算做。在这些客户端默认切到 modern 之前,Tasks 很难普及。
- Elicitation 已经基本普及(pi 本体除外),但处理“没人在场”的策略各不一样:Claude Code 在非交互模式下取消任务,Codex 按审批策略
decline或自动 accept 纯确认框,opencode 和 qodercli 回cancel。服务器要能正确处理这三种回答。 - 对 qodercli 的参考价值:opencode 的
protocol配置项(legacy / auto / pinned)、Codex 的“共享连接里按调用方隔离 input”,以及 pi-mcp-adapter 直接用ext-tasks,都可以作为第 7.3 节第 2、4、5 步的现成参考。
9. 社区怎么看
X 上的主要观点
- Elicitation 才是重点。很多人认为它比 Tasks 更有用:插件“先问再做”,不靠猜。@YStan__:先问的 agent 比跑得久的 agent 省时间。@realtatendazhou:我的 bug 都出在“猜”上。
- 安全性。@hot_town:通过 API,agent 可以直接给几千人发邮件;用 Elicitation 时确认环节从 MCP 服务器直接到客户端,LLM 根本碰不到那个确认按钮,所以也没法用 computer use 去替你点。他还提到 Cloudflare 的 step-up auth(按需申请权限)和 Elicitation 配合得很好。
- 对话框要标明是谁在问。@m0rtitech:如果看不出是哪个服务器在请求,Elicitation 就只是一个让人点“是”的漂亮弹窗。
- 终于不用自己写轮询了。@mukh_higgsfield、@shadowaguy:以前一半的 MCP 工具都在用轮询和超时假装异步。
- “回报”本质上还是客户端轮询。@bytecrafter_1:Tasks 以轮询为主,push 是可选的;
input_required的任务停下来等客户端,半夜谁来回答?@unwindstack:用户切到别的窗口了,任务完成能不能在聊天之外通知到? - 取消是协作式的。@stretchcloud 和 @nevil84 都提醒:
tasks/cancel只是请求,不是强制终止,“持久”不等于“可控”,有副作用的操作要特别注意。 - 生态跟进。@nicopreme 的 pi-mcp-adapter 已支持 Tasks 异步执行。@realtatendazhou 踩过一个坑:无状态 MCP 不要声明
listChanged: true,否则 claude.ai 会把/mcp连接挂约 256 秒,烧掉 Vercel CPU。 - 中文社区。@trymorewz 总结了接入边界:Tasks 需要服务器支持;
claude -p不启用;非交互会话中请求输入会被取消,且不跑 hooks。 - 评论里还有人问:任务能跑多久、URL 模式是否一起上线(是)、MCP Apps 呢(暂未支持)、能不能替代定时自唤醒去查 PR 状态。另有不少人抱怨同一周的用量限制,和这个功能无关。
- r/mcp:How are you handling long-running requests in MCP?:YouTube 上传 MCP 的作者遇到客户端超时(实际上传成功了),改成了有上限的长轮询。评论里的共识:
- 只有一个慢接口的话,job id + 状态工具 + 长轮询就够了,Triggers & Events 扩展太重
- 幂等键一定要有:让客户端传自己的 key,开始调用超时后 agent 重试,返回的是同一个 job 而不是再传一遍;key 要能在服务器重启后保留
- 有人指出协议层已经有 Tasks 扩展(2026-07-28 起),但需要双方都 opt in,目前应保留长轮询作为兜底
- r/MCPservers:MCP elicitation explained(文章):介绍了 form/URL、无状态重试和能力检测,并提问:没人在场回答时 agent 该怎么办,暂停等待、优雅失败,还是走兜底逻辑?
- r/mcp:40 个 MCP 工具,哪些你不敢让 agent 不经确认就调用?:讨论的就是 Elicitation 该卡在哪里:
- 判断标准是可逆性而不是危险程度:一分钟内撤销不了的操作就要先问
- “会触达团队外的人”的工具(发消息、发邮件)一定要确认
- 确认要绑定到具体的收件人和正文,后续工具结果改了正文,之前的同意就不能再用
- 看起来只读的
fetch其实能把数据外传,应该当成写操作,配域名白名单 - 按效果给工具分类(只读 / 内部写 / 外部副作用),而不是按名字
10. 我的判断
- Tasks 把 MCP 补成了能跑长任务的协议。过去每个 MCP 服务器各自实现 job id + 状态工具,现在有了标准语义(状态机、TTL、轮询间隔、断线恢复),客户端也能统一提供
/tasks界面和 resume。 - Elicitation 的价值主要在“人和模型分开”:确认动作不经过 LLM,form/URL 分开处理敏感数据。这比在 prompt 里写“删除前先问用户”可靠得多。
- 两者合起来是“异步 + 人在回路”,适合 CI、数据迁移(删除前停下来审批)、深度调研、批量导入这类场景。
- 限制还不少:public beta、只有 CLI、
-p不支持、子代理不支持、stdio 任务活不过会话、取消是协作式、TS SDK 服务端还没实现。现在接入的话,要同时保留同步/长轮询兜底,并做好幂等键。 - 需要无人值守的场景要先想清楚:非交互模式下请求输入会直接取消任务。需要人回答的问题尽量在任务开始前问完。Elicitation hook 只对普通请求有用,任务内的
input_required在非交互时根本不会走到 hook(见 6.4)。 - 源码比文档更保守:断线、重新登录、换 transport 都只是把任务 parked 起来等
--resume,不会当成失败告诉模型。真正告诉模型“结果未知”的只有服务器明确说不认识这个 task ID(-32602)的情况。所以服务器侧最该做好的是 task ID 跨连接、跨重启都能查到。
参考链接
官方
- 发布推文:https://x.com/ClaudeDevs/status/2113698001889927608
- Claude Code MCP 文档(Tasks / Elicitation 章节):https://code.claude.com/docs/en/mcp
- MCP Tasks 概览:https://modelcontextprotocol.io/extensions/tasks/overview
- ext-tasks 规范仓库:https://github.com/modelcontextprotocol/ext-tasks
- SEP-2663 Tasks Extension:https://modelcontextprotocol.io/seps/2663-tasks-extension
- Elicitation 规范(2026-07-28):https://modelcontextprotocol.io/specification/2026-07-28/client/elicitation
- MRTR(Multi Round-Trip Requests):https://modelcontextprotocol.io/specification/2026-07-28/basic/patterns/mrtr
- SEP-1036 URL Mode Elicitation:https://modelcontextprotocol.io/seps/1036-url-mode-elicitation-for-secure-out-of-band-intera
- TS SDK 实现进度 #2189:https://github.com/modelcontextprotocol/typescript-sdk/issues/2189
文章 / 实测
- azukiazusa:Claude Code で MCP Tasks と Elicitation を試す:https://azukiazusa.dev/blog/claude-mcp-tasks-elicitations/
- pournasserian:MCP elicitation explained:https://pournasserian.com/writing/mcp-2026-elicitation
X 讨论
- https://x.com/stretchcloud/status/2114058592156278845
- https://x.com/VeyroAI/status/2113990135901561180
- https://x.com/VibeCoderOfek/status/2113953194984231351
- https://x.com/trymorewz/status/2113715869964501129
- https://x.com/hot_town/status/2109635099650052305
- https://x.com/hot_town/status/2112467535610151167
- https://x.com/bytecrafter_1/status/2113699938333065597
- https://x.com/nevil84/status/2113702154179604850
- https://x.com/m0rtitech/status/2113897392714236097
- https://x.com/nicopreme/status/2114605175138648539
- https://x.com/realtatendazhou/status/2115117262105710900
- https://x.com/DevilDogSaga/status/2114343266556756247