Agent 接入

已验证客户端为 opencode 1.19.4。以下使用 V1 配置格式；V2 的工具传递兼容性尚未通过。

配置 MCP

先接受 Clerk 邀请并完成邮箱登录。客户端使用 OAuth，不需要管理员发放 User Token。

将以下内容合并到项目的 opencode.json：

{
  "mcp": {
    "mogick_sandbox": {
      "type": "remote",
      "url": "https://agent-sandbox-preview.chenjiuning.dev/mcp",
      "oauth": {
        "clientId": "5kzcBIUwy68g2sLS",
        "scope": "openid profile email offline_access"
      }
    }
  }
}

运行 opencode mcp auth mogick_sandbox，在浏览器中登录并确认授权。回到 opencode，确认 mogick_sandbox 已连接并发现工具。连接成功不代表任务已经远程执行， 验收应检查实际工具调用、工作区状态及 executionId。

只使用远程工具的专用 Agent

添加 MCP 不会禁用本地 shell 或文件工具。若本次任务必须只在远程运行，可添加专用 Agent：

{
  "agent": {
    "remote-workspace": {
      "mode": "primary",
      "description": "仅使用 Mogick 远程工作区工具",
      "permission": {
        "*": "deny",
        "mogick_sandbox_*": "allow"
      }
    }
  }
}

选择该 Agent 后提交任务，例如：

使用 mogick_sandbox 创建批准的 Git 工作区，执行 Python 生成 report.json，等待执行成功， 发布报告并保存停止。记录 workspaceId、executionId 和产物哈希。所有执行与文件操作都使用远程工具。

断线与凭据轮换

网络中断后先查询原 executionId 或 operationId，不要换幂等键重复提交。 OAuth 授权撤销后需重新登录并授权；同一 Clerk 账户保留其工作区所有权。

工具参考 · 权限与凭据