MCP 工具参考
MCP 地址为 https://agent-sandbox-preview.chenjiuning.dev/mcp，使用 Clerk OAuth 授权。
HTTP 入口为 /api/v1，与 MCP 使用相同服务层及当前授权检查。
| 工具 | 用途 |
|---|---|
workspace_create |
创建Git工作区或等待本地Relay输入的工作区 |
workspace_status |
查询状态、generation、操作、执行和产物 |
workspace_read_file |
分块读取相对路径文件 |
workspace_write_file |
写入工作区文件，返回 operationId |
execution_submit |
提交 argv 命令，返回 executionId |
execution_get |
查询执行状态及分页日志 |
execution_cancel |
请求取消执行，不回滚副作用 |
workspace_checkpoint |
保存恢复点，suspend=true 时保存后停止 |
workspace_resume |
将同一工作区恢复到新 generation |
artifact_publish |
发布不可变产物，等待 operation 完成 |
workspace_export |
导出标准归档 |
workspace_destroy |
逻辑删除工作区，删除后不能恢复 |
operation_get |
查询初始化、写入、保存、恢复、发布或导出操作 |
operation_cancel |
请求取消Relay物化操作 |
relay_status |
查询连接器状态、session及manifest版本 |
relay_list |
分页列出批准文件，cursor默认0，每页100条 |
relay_stat |
查询指定文件及校验live版本 |
relay_read |
读取最多256 KiB的Base64文件块 |
relay_materialize |
复制全部或选定文件到云端，返回operationId |
relay_revoke |
撤销后续读取及缓存访问 |
workspace_usage |
查询工作区存储、流量及执行观测用量 |
Relay读取参数为workspaceId、sessionId、manifestRevision、path及可选mode。 mode默认live；snapshot显式固定已缓存版本。read可指定offset和length，默认0和65536。 materialize使用相同版本标识、可选paths及必需idempotencyKey；所有输入和结果均由服务再次校验。
本地 opencode 中工具名通常带 mogick_sandbox_ 前缀。
长操作被受理后，必须查询 operation 或 execution 终态；不要把 accepted 显示为成功。
文件路径必须相对工作目录，不允许 ..、绝对路径、符号链接和特殊文件逃逸。
调用中的 workspaceId、executionId 和 operationId 都必须来自服务返回值，不可自行编造。