云真机 MCP server 接入示例

云真机 MCP server 接入示例

为满足不同开发者的偏好，我们支持通过多种 AI 助手接入。您可以根据需要，选择使用 Google 的 Gemini CLI 或阿里的 Qwen Code，均可配置并连接至云真机 MCP Server。

开启 Device 服务

请确保您已经创建 UOS APP 并开启 Device 服务，进入 「Device -> 控制台」 页面。

申请云真机 OpenAPI 的密钥

在「控制台」页面，点击「前往借用设备」：
页面会自动跳转到「云真机」页面：
点击「Open API」标签页，填写邮箱、微信号、公司名称、手机号码和备注等信息，点击「提交申请」，等待审核通过。
审核通过后，在「Open API」页面即可获得云真机应用对应的 AppId 和 AppSecret。请妥善保管，后续步骤会用到。

使用 Gemini CLI 接入 MCP Server

安装 Gemini CLI 并登录

Windows

使用前需要先安装 Node.js 20 或者更高版本。
Node.js 官网下载链接：下载 NodeJS
安装完成后，在命令行中执行以下命令来安装 Gemini CLI：

npm install -g @google/gemini-cli

Mac

在终端中执行以下命令安装 Gemini CLI：

brew install gemini-cli

这里以 Windows 系统为例，安装 Gemini CLI 以后，进入 Gemini，根据页面跳转使用你的 Google 账户登录。

配置 Google Cloud 项目

登陆你的 Google 账户后，点击链接前往 Google Cloud IAM 页面，创建新项目或者选择已有项目，并复制项目的 ID：
点击链接前往 Gemini for Google Cloud 页面，启用 Gemini API。

配置环境变量

打开计算机的「属性」面板，找到「高级系统设置」，点击「环境变量」。在「系统变量」部分，点击「新建」，在弹出窗口中，输入：

配置「变量名」：GOOGLE_CLOUD_PROJECT
配置「变量值」：粘贴刚才复制过的 Google Cloud 项目 ID
最后点击「确定」保存

添加 mcpServers 字段

再次打开命令行进入 Gemini 窗口，如果未登录的话，根据提示选择「1. Login with Google」，按下回车键，然后在弹出的浏览器窗口中使用您的 Google 账户登录并完成授权。
登录成功后，在用户根目录（如 C:\Users<您的用户名>或 /Users/<您的用户名>）下找到 .gemini 文件夹，打开其中的 settings.json 文件：
在 settings.json 文件中添加 mcpServers 字段，注意该字段需要与其它字段平级。将以下配置中的 xxxxxx 替换为您在获取云真机OpenAPI的密钥步骤中获取的 AppId 和 AppSecret，配置文件内容最终如下所示:

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  },
  "mcpServers": {
    "device": {
      "httpUrl": "https://uos-ai.unity.cn/device/mcp?open_api_app_id=xxxxxx&open_api_app_secret=xxxxxx"
    }
  }
}

使用 Qwen Code 接入 MCP Server

安装 Qwen Code 并登录

Windows

使用前需要先安装 Node.js 20 或者更高版本。
Node.js 官网下载链接：下载 NodeJS
安装完成后，在命令行中执行以下命令来安装 Qwen Code：

npm install -g @qwen-code/qwen-code@latest

Mac

在终端中执行以下命令安装 Qwen Code：

brew install qwen-code

这里以 Windows 系统为例，安装 Qwen Code 以后，进入 Qwen:
根据提示选择「1.Qwen OAuth」，按下回车键，在跳转的网页中登录或注册账号以完成授权。

添加 mcpServers 字段

授权后，在您的用户根目录下找到 .qwen 文件夹，打开其中的 settings.json 文件：
同样地，在 settings.json 配置文件中添加 "mcpServers" 字段，该字段也需要与其它字段平级。将以下配置中的 xxxxxx 替换为您在获取云真机OpenAPI的密钥步骤中获取的 AppId 和 AppSecret，配置文件内容最终如下所示:

{
  "security": {
    "auth": {
      "selectedType": "qwen-oauth"
    }
  },
  "mcpServers": {
    "device": {
      "httpUrl": "https://uos-ai.unity.cn/device/mcp?open_api_app_id=xxxxxx&open_api_app_secret=xxxxxx"
    }
  },
  "$version": 2
}