本地 MCP 接口:外部 Agent 通过 ADB reverse 调用同一套工具
是什么
WebToApp 的 Agent 工具支持本地 MCP 接口——一个在 127.0.0.1 上监听的 HTTP 接口,外部 Agent 可以通过它调用同一套 Agent 工具。
默认关闭。开启后:
- 设备上的构建器在 127.0.0.1 上监听一个端口
- 电脑端可以通过
adb reverse把电脑的 127.0.0.1 映射到设备的 127.0.0.1 - 电脑端的 AI Agent 可以调用设备上的 WebToApp Agent 工具链
怎么开
- 从「我的应用」三点菜单 → 关于
- 找到「本地 MCP」开关,打开
- 首次开启需要设置一个 bearer 令牌(外部调用者需要带上这个令牌才能通过认证)
- 界面显示监听的端口号
电脑端连接
adb reverse tcp:<端口> tcp:<端口>
之后电脑上的任何支持 MCP 的客户端都可以通过 http://127.0.0.1:<端口>/mcp 访问设备上的 Agent。
安全考虑
- bearer 令牌:需要你手动设置,调用时必须带上。不要泄露给不信任的一方
- 只读工具:可以开启「只允许只读工具」模式——外部 Agent 只能查询不能修改
- 预览工具:只读的预览工具会在内部打开页面,方便电脑端 Agent 看着手机上的操作结果
- 写入操作:会弹出手机上的确认对话框,需要手动点「允许」
- APK 导出不含:生成的 APK 不带这个服务——只在构建器里存在
适用场景
- 电脑端 AI 辅助手机操作:电脑上的 AI Agent 通过 MCP 接口操控 WebToApp,同时在手机上确认写入操作
- 自动化测试:写脚本批量创建应用、跑构建、检查产物
- 开发辅助:电脑 IDE 的 AI 插件可以直接调用设备上的构建器
和内置 Agent 的区别
| 维度 | 内置 Agent | 本地 MCP |
|---|---|---|
| 运行位置 | 设备上 | 电脑端客户端 → 设备上接口 |
| 界面 | 手机上的聊天界面 | 电脑端 AI 客户端 |
| 权限控制 | 写入前弹确认 | bearer 令牌 + 可选只读模式 + 写入前弹确认 |
| 能做什么 | 相同的 55-60 个工具 | 相同的工具集 |
| 生成 APK 后是否存在 | 否(仅构建器里) | 否(仅构建器里) |
两种方式共享同一套底层工具——不管是内置 Agent 还是外部 MCP 调用,操作的是同一个 WebToApp 实例。