云控系统开放 API + MCP 对接：让 AI 和电商系统直接调度手机自动化

云控是把中控放到服务器上。设备在哪儿不重要，打开浏览器就能管理和下发任务。和本地中控的差别是它跑在远端。

云控除了在后台点按钮，还有开放 API 和 MCP。外部系统可以用代码调度设备任务，也可以交给 AI 大模型来调。文档对应云控 3.11.0 及以上，EasyClick 客户端 9.4.0 及以上。演示环境是 http://ecloud.devicefarm.cn/ ，账号和密码都是 test123。这个演示账号不能做增删改。

开放 API：调度任务，也共享数据

EasyClick 云控的开放 API 提供两个核心接口。获取任务信息接口 POST /openapi/getTask：传入云控通信密钥，返回所有任务的完整信息，包括任务 ID、名称、执行设备列表、脚本地址、参数配置、执行状态。业务系统可以随时查询当前有哪些任务、分给了哪些设备、带什么参数。任务控制接口 POST /openapi/changeTask 用来改任务：开启或停止（status: 0 开启、1 停止本地、2 停止远程）、动态增减执行设备（addDevices / removeDevices）、动态增减任务参数（addParamEx / removeParam）。

典型场景是电商下单自动执行：

客户下单并支付完成
  → 下单系统调用云控 API（changeTask）
  → 云控改变任务状态，加入指定设备和参数
  → 云控下发任务到设备
  → 设备循环执行脚本
  → 设备执行完毕，调用 API 将自己从任务设备列表中移出

客户下单可以触发自动化任务，设备执行完把自己从任务设备列表里移出，中间不用人在后台改任务。

API 有两种认证模式。全站授权在 config.toml 中设置 no_limit_token 字段为一串随机字符串，请求时在 HTTP Header 里带上这个值即可访问所有接口，适合内部系统对接。单用户授权是模拟登录获取 token，在 config.toml 中设置 no_verify_code 为随机字符串，登录请求时带上这个值跳过验证码，适合多租户场景。

参数可以在运行时改。文本参数直接传字符串，单选框参数传字符串加候选项数组，多选框参数传 JSON 数组加候选项数组。按不同客户的下单内容，给不同设备下发不同的商品链接和账号，同一个任务模板就能分开用，不用每种情况单独建任务。

任务控制之外，云控还有动态数据管理，脚本和业务系统可以共用一张表。

脚本可以在云控中动态创建数据表：

ecloud.dynamicCreateTable({
    "tableName": "账号管理表",
    "tableNameEn": "account_table",
    "columns": [
        {"columnInfo": "账号", "columnName": "account", "columnSize": 500},
        {"columnInfo": "密码", "columnName": "password", "columnSize": 500},
        {"columnInfo": "状态", "columnName": "status", "columnSize": 500}
    ]
});

表结构不固定，你定义字段、你填数据，字段类型统一是字符串，简单但够用。创建好表后，脚本可以直接增删改查：dynamicAdd 插入数据、dynamicQuery 分页查询（支持 SQL 条件、排序、随机查询）、dynamicUpdate 按条件更新、dynamicRemove 按条件删除。查询支持 like 模糊匹配、order by rand() limit 1 随机取一条，做账号池、素材池非常方便。

除了动态表，云控还有固定的“数据共享表”，结构固定、操作简单，适合设备间共享简单的 KV 数据：getData / addData / updateData / removeData，appendOneLineData / removeOneLineData 追加与删除一行，以及 getDataPop，取走一条并自动删除。多台设备同时取账号时，每个账号只会被取走一次。

云控还内置了 Redis 缓存接口，脚本可以直接操作 Redis：字符串缓存 addCache / getCache / updateCache / removeCache 支持过期时间；SET 集合用换行符分割的多值存储，appendOneLineCache 追加、removeOneLineCache 删除；计数器 incrementCache / decrementCache 自增自减；队列 popPushCache 支持 lpush、rpush、lpop、rpop、spop。100 台手机跑脚本时，可以用 Redis 做实时状态同步：设备 A 完成一步就往 Redis 写个标记，设备 B 执行前先读这个标记，决定要不要继续。

MCP、WebHook 与三层集成深度

MCP（Model Context Protocol，模型上下文协议）是 Anthropic 推出的开源协议，用来规定大语言模型怎么调用外部工具。EasyClick 云控实现了 MCP 服务端，可以用自然语言让 AI 去操作云控。

用法分四步：确保云控的 MCP 端口 8187 已放行；在云控后台 → 权限管理 → 用户管理 → 云控设定中生成 MCP 密钥；配置 MCP 服务信息：

{
    "mcpServers": {
        "EcloudMCP": {
            "type": "streamable-http",
            "url": "http://你的服务器 IP:8187/mcp",
            "headers": {
                "UserToken": "你的 MCP 密钥"
            }
        }
    }
}

把这段配置填入支持 MCP 的平台，扣子空间、Dify、VS Code、Trae 都能用。配置完成后，在 AI 对话里可以直接说「执行云控任务，名称为抖音矩阵发布」或「停止云控任务，名称为快手养号」，AI 会调用云控 API 完成操作。

MCP 可以接进工作流。AI 生成短视频文案后触发云控任务批量发布；AI 分析数据报表后调整设备任务参数；客户下单后，由 AI 分配设备和脚本。这些对接以前要写代码，配好 MCP 之后用自然语言就能触发。AI 在这里调用的是云控 API，手机会按任务去执行。

云控还支持 WebHook，把设备心跳和脚本日志实时推送到外部系统，支持 HTTP POST 和 WebSocket 两种方式，异步推送不阻塞主流程，支持队列配置和自定义 Header 认证。配置在 config.toml 中：

[heartbeatForward]
enabled = true
mode = "http"
httpUrl = "http://your-system:8199/heartbeat"
httpHeaderKey = "ecloud_token"
httpHeaderValue = "your_token"

这样就能把云控的运行数据接到自己的监控大屏、ELK 日志系统或数据仓库。

接口层	对接方式	适合场景	技术门槛
开放 API	HTTP 调用	电商系统、ERP 对接	低（会调 HTTP 接口即可）
动态数据 + Redis	脚本内函数调用	设备间数据共享	低（调 JS 函数）
MCP	AI 平台配置	AI 工作流、自然语言调度	零代码

三层接口各管一块。开放 API 对接电商、ERP 这类业务系统。动态数据表和 Redis 给脚本在设备之间共享数据。MCP 给 AI 平台用自然语言调度任务。WebHook 把心跳和日志推到外部监控。任务如果还是人手动建、手动选设备，可以用 API 或 MCP 把这一步也接出去。