MCP 接口

平台内置 MCP (Model Context Protocol) 服务，支持在 Claude Code、Cursor 等 AI Agent 中用自然语言直接调用平台任务。

工作原理

外部 Agent (Claude Code 等)
    ↓ MCP 协议 (JSON-RPC over HTTP)
平台服务端 /api/mcp
    ↓ 控制通道 push 执行指令
语言驱动客户端 (需已登录在线)
    ↓ 自动执行任务
任务输出回传，Agent 拿到结果

可用工具

工具	说明
`list_online_devices`	列出在线设备（Android / Web / Desktop）
`list_apps`	列出可用应用及其参数定义
`start_task`	创建并启动任务，返回 task_instance_id
`get_task_status`	轮询任务状态
`get_task_output`	拉取任务输出数据
`stop_task`	停止运行中的任务
`inspect_elements`	截取设备屏幕并提取可交互元素列表

配置 Agent

在目标 Agent 项目根目录创建 .mcp.json，填入本平台的登录用户名和密码：

json

{
  "mcpServers": {
    "gui-agent": {
      "type": "http",
      "url": "https://langdriver.com/api/mcp",
      "headers": {
        "X-Username": "你的用户名",
        "X-Password": "你的密码"
      }
    }
  }
}

TIP

配置用的是平台登录的用户名密码，无需单独申请 token。密码修改后旧凭证会自动失效（最多 5 分钟延迟）。

配置完成后重启 Agent，在 MCP 面板中应能看到 gui-agent 服务已连接，并列出上述 7 个工具。

快速生成 Prompt

手动拼 MCP 调用参数较繁琐，平台提供一键生成功能：

在「我的应用」中打开应用详情页，顶部「应用 ID」可一键复制
进入「运行任务」标签页，填写运行参数、选择设备/账号
点击「生成 Agent Prompt」按钮，弹窗展示一段可直接使用的 Prompt
点击「复制」，粘贴到目标 Agent 的对话框即可

生成的 Prompt 已包含当前填写的参数和选中的设备/账号，Agent 会按 start_task → 轮询 get_task_status → 拉取 get_task_output 三步执行并把结果汇总返回。

运行前提

客户端需已登录并在线：MCP 启动任务后，服务端通过控制通道把执行指令推送给在线客户端执行。客户端不在线则任务无法运行
设备/账号就绪：Android 任务需设备已连接；网页任务需已添加登录账号
Token 余额充足：任务执行消耗 Token，余额不足会自动停止

支持的 Agent

任何支持 MCP 协议、可通过 HTTP 连接 MCP 服务的 AI Agent 均可接入：

Claude Code（Anthropic 官方 CLI）
Cursor
其他兼容 MCP 的 Agent 平台

常见问题

Agent 中 MCP 服务连接失败

确认 .mcp.json 里的服务器地址正确且服务端可达
确认用户名和密码正确（即平台登录凭据）
服务端需已启用 MCP 端点（/api/mcp），联系管理员确认

MCP 启动任务后一直显示「运行中」但不执行

确认语言驱动客户端已启动并登录（MCP 通过控制通道把任务推送给客户端执行，客户端不在线则任务无法运行）
确认目标设备已连接（Android）或浏览器账号已登录（Web）

返回结果字段说明

start_task 返回 task_instance_id，记录此 ID 用于后续轮询
get_task_status 返回 status 字段：pending / running / stopping / completed / failed / stopped
get_task_output 返回分页输出列表，每条包含 entity_type（实体类型）和 data（JSON 数据）

MCP 接口 ​

工作原理 ​

可用工具 ​

配置 Agent ​

快速生成 Prompt ​

运行前提 ​

支持的 Agent ​

常见问题 ​