1. 真机自动化测试的痛点与 Mobile MCP 的切入点
Mobile MCP 是一套让 AI 直接驱动 Android/iOS 真机执行自动化测试的 MCP 服务器,适合已经在用 Cursor、想让 AI 帮忙跑 App 流程(比如 Swag Labs 登录、打开 Facebook 游戏)的测试和开发同学。它解决的核心问题是:过去写一个 App 自动化脚本,你得先装 Appium、配 WebDriverAgent、处理各种 driver 版本,环境还没跑通人已经累了。Mobile MCP 把这层壳剥掉,让 Cursor 里的模型通过 MCP 协议直接下发点击、输入、滑动、截图这些动作,真机照着执行。
但很多人配好 mobile-mcp 之后会卡在另一个地方:Cursor 的模型通道。MCP 服务器本身不消耗 Token,真正烧 Token 的是 Cursor 调用大模型那一段。默认走官方通道时,长流程测试(登录、多步跳转、截图回传)很容易把额度打满,或者因为网络和计费问题中断。这篇就按「Skill / MCP」的视角,把 mobile-mcp 的注册、Cursor 模型 API 改走 TaoToken、再到真机跑通 Swag Labs 登录的完整链路讲清楚,遇到 401 和路径报错怎么查也一并说。
我试过在 Android 真机上从零配到跑通,中间踩的坑基本都集中在 Base URL 和 MCP 开关这两处,下面按顺序来。
2. 前置准备:TaoToken Key 与 Cursor 模型通道
在动 mobile-mcp 之前,先把 Cursor 的模型 API 通道换掉,否则后面跑测试时模型调用会走默认通道,额度和稳定性都不好控。这一步的核心是拿到一个 TaoToken 的 Key,并把 Cursor 的 Base URL 指向 TaoToken 的 API 地址。
打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并登录,进入控制台创建 API Key。创建入口在 API Keys 页面,直接访问 https://taotoken.net/api-keys 也行。Key 生成后复制保存,后面填到 Cursor 里。
这里有个关键点必须说清楚:Base URL 填https://taotoken.net/api,不要加/v1,也不要填官网地址https://taotoken.net。这是最容易出错的地方,多写一个/v1或者少写/api,请求就会 404 或 401。TaoToken 的 API 入口就是https://taotoken.net/api,模型路径由 Cursor 自己拼接,你只需要给到这一层。
如果你还想先验证模型通道是否通,可以到模型对话页面发一条测试消息,确认 Key 有效、额度正常,再去配 mobile-mcp。这样能把「模型通道问题」和「MCP 配置问题」分开排查,省得两头猜。
3. 可复制配置:mobile-mcp 注册与 Cursor 模型 API 设置
3.1 安装并注册 mobile-mcp
先建一个测试项目目录,把 mobile-mcp 作为依赖装进来。它本质是一个 npm 包,通过 npx 拉起即可,不需要全局安装。
mkdir mobile-mcp-test cd mobile-mcp-test npm i @mobilenext/mobile-mcp然后用 Cursor 打开这个项目目录。在项目根目录创建 MCP 配置文件:
mkdir -p .cursor && touch .cursor/mcp.json把下面这段写进.cursor/mcp.json:
{ "mcpServers": { "mobile-mcp": { "command": "npx", "args": ["-y", "@mobilenext/mobile-mcp@latest"] } } }这段配置的意思是:Cursor 启动时用 npx 拉起@mobilenext/mobile-mcp的最新版,作为一个 MCP 服务器挂上去。-y是自动确认安装,避免交互卡住。
3.2 把 Cursor 模型 API 改走 TaoToken
打开 Cursor 设置,找到模型 / API 配置区域。不同版本入口略有差异,一般在 Settings 里的 Models 或 API 部分。把模型提供方的 Base URL 改成:
https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那一串。注意不要在这里加/v1,也不要填https://taotoken.net。填完之后保存,Cursor 的模型调用就会经 TaoToken 统一转发。
3.3 确认 MCP 开关已打开
回到 Cursor,确保 MCP 功能开关是打开的。在设置里能看到已注册的 MCP 服务器列表,mobile-mcp应该显示为已连接或可用状态。如果显示未连接,先检查 npx 是否能正常拉起包,再检查.cursor/mcp.json的路径和 JSON 格式。
| 配置项 | 正确值 | 常见错误 |
|---|---|---|
| Base URL | https://taotoken.net/api | 多写/v1、填官网地址 |
| API Key | TaoToken 控制台创建 | 填了别的平台 Key |
| MCP 配置路径 | 项目根目录.cursor/mcp.json | 放到用户目录或拼错 |
| MCP 开关 | 已打开 | 忘记开启 |
4. 验证请求:Android 真机跑通 Swag Labs 登录
配置完成后,先做一次最小验证:让 Cursor 通过 mobile-mcp 连上 Android 真机,确认能拿到设备信息。在 Cursor 聊天窗口输入类似指令:
用 mobile-mcp 列出当前连接的 Android 设备如果返回了设备型号和状态,说明 MCP 通道和模型通道都通了。这一步同时验证了两件事:mobile-mcp 能驱动真机,Cursor 的模型调用经 TaoToken 正常返回。
接着跑 Swag Labs Mobile App 的登录流程。在聊天窗口输入:
用 mobile-mcp 在 Android 真机上打开 Swag Labs App,完成登录流程: 用户名 standard_user,密码 secret_sauce,点击登录按钮,截图确认结果Cursor 会把这条指令拆成一系列动作:启动 App、定位输入框、输入用户名、输入密码、点击登录、截图。mobile-mcp 负责在真机上执行这些动作,模型负责理解界面和决定下一步。整个过程不需要你装 Appium,也不需要写 WebDriver 脚本。
实测下来,Android 真机上 Swag Labs 登录能完整跑通,截图回传后模型能正确判断是否登录成功。iOS 真机稍微麻烦一点:需要手动 build WebdriverAgent,并在聊天窗口里告诉 Cursor 设备已就绪。以打开 Facebook App 完成龙蛋泡 level1 为例,流程也能跑,但 AI 执行时可能误触 iOS 控制中心,导致录屏只录到一部分,这是真机自动化的常见干扰,不是配置问题。
关于并行测试:经测试 mobile-mcp 暂不支持多设备并行,一次跑一台。如果你有多台设备要测,建议串行排队,或者拆成多个 Cursor 会话分别跑。
5. 本篇常见错排查:401 与路径报错
跑不通的时候,绝大多数问题集中在两个报错:401 和路径错误。下面按现象给排查顺序。
5.1 401 Unauthorized
401 基本是 Key 或 Base URL 的问题。先确认 Cursor 里填的 API Key 是 TaoToken 控制台创建的,没有多余空格。再确认 Base URL 是https://taotoken.net/api,没有多写/v1。如果 Key 没错、URL 也对,去 TaoToken 控制台看这个 Key 是否被禁用或额度耗尽。
5.2 路径报错 / 404
路径报错通常是 Base URL 写错。常见情况有三种:填了官网地址https://taotoken.net、多写了/v1变成https://taotoken.net/api/v1、或者拼成了别的路径。正确值只有一个:https://taotoken.net/api。改完保存,重启 Cursor 让配置生效。
5.3 MCP 服务器未连接
如果 Cursor 里 mobile-mcp 显示未连接,先手动在终端跑一次npx -y @mobilenext/mobile-mcp@latest,看是否能正常拉起。如果报网络或包不存在,检查 npm 源。如果终端能跑但 Cursor 里不行,检查.cursor/mcp.json是否在项目根目录、JSON 是否合法、MCP 开关是否打开。
5.4 真机连不上
Android 真机需要开启 USB 调试,并确认adb devices能看到设备。iOS 真机需要手动 build WebdriverAgent 并在聊天窗口告知 Cursor。设备没连上时,mobile-mcp 拿不到设备列表,模型也就无法下发动作。
注意:排查顺序建议先验证模型通道(模型对话发一条消息),再验证 MCP 通道(列出设备),最后跑完整流程。这样能把问题定位到具体一层,不用来回改配置。
6. 后续怎么用:把 Key 和 MCP 固定下来
跑通一次之后,建议把配置固定成模板:.cursor/mcp.json直接复用,Cursor 的 Base URL 和 Key 填一次就行。后面换项目时,只需要把.cursor/mcp.json复制过去,模型通道不用重配。
如果你要长期跑编码和 Agent 类任务,包括 mobile-mcp 这种多步真机流程,可以看下 Coding Plan,把额度规划好,避免跑长流程时中途断掉。接入文档在 https://taotoken.net/doc 有更细的说明,遇到路径和鉴权问题可以对照查。模型通道验证用模型对话最快,真机流程跑通后再回到 Coding Plan 做长期使用。
最后提醒一句:mobile-mcp 跑真机测试时,模型调用是持续消耗 Token 的,长流程(比如多步登录加截图回传)消耗会比单轮对话高不少。先把 Swag Labs 登录这种短流程跑顺,再逐步加长,成本和稳定性都好控。