> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/control-cloud-phones-from-scripts.md).

# 从脚本和AI客户端控制云手机

使用本地REST API或Incogniton CLI从您自己的脚本中列出、启动、停止和连接到云手机，或通过MCP从AI客户端连接。

在**设置 > 自动化**中开启本地REST API（打开**启用自动化API**并点击**保存**）。然后，您的脚本和Incogniton CLI可以列出您的云手机，启动和停止它们，并获取它们的ADB地址。通过**MCP令牌**连接的AI客户端可以列出、启动、停止和创建云手机。

本页面介绍如何从应用程序外部控制手机。有关在Incogniton内运行的现成任务，请参阅[管理云手机](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/manage-cloud-phones.md#automation)中的**手机自动化**。

### 您需要的条件

* 在**设置 > 自动化**中开启本地REST API。请参阅[使用本地REST API](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/local-rest-api.md)。自动化API是付费功能。
* 在与您的脚本相同的计算机上打开并登录Incogniton。API默认监听`127.0.0.1`，端口为35000。
* 在团队中，正确的云手机权限：\*\*使用云手机（电源、重启、连接）**以列出、启动和停止手机，以及**管理云手机（编辑、代理、重置、Android版本、ADB、root、应用、自动化、移动）\*\*以开启ADB。

### 您可以使用本地REST API做什么

| 操作                                   | 端点                               | CLI命令                      |
| ------------------------------------ | -------------------------------- | -------------------------- |
| 列出团队的云手机及其ID、名称、组、状态、Android版本和ADB地址 | `GET /cloudphone/list`           | `cloudphone-list`          |
| 启动手机而不打开其屏幕（用于ADB、应用和自动化）            | `POST /cloudphone/start`         | `cloudphone-start`         |
| 启动手机并在Incogniton中打开每个手机的屏幕窗口         | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| 关闭手机电源                               | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| 在运行中的手机上启用ADB并获取其本地地址                | `POST /cloudphone/adb`           | `cloudphone-adb`           |

启动和停止操作需要从手机列表中提供1到100个手机ID。每个手机都会单独检查（剩余分钟数、订阅活动、代理设置、未重置），因此有些手机可以启动，而其他手机则被拒绝；答案会给出每个手机的原因。

通过这种方式启动的手机会继续运行并使用分钟数，直到您停止它。停止手机还会关闭其窗口和Incogniton中的本地ADB连接。

ADB操作返回一个本地地址，例如`127.0.0.1:6555`。使用`adb connect`连接到它，与应用中的**复制ADB命令**地址完全一样。手机必须正在运行。请参阅[使用ADB连接到云手机](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/connect-to-a-cloud-phone-with-adb.md)。

您无法通过本地REST API编辑、重启或重置云手机。请在应用中进行这些操作：参阅[编辑、重启或重置云手机](https://docs.incogniton.com/documentation/chinese-documentation/yun-shou-ji/edit-restart-and-reset-cloud-phones.md)。

### 使用Incogniton CLI

上述每个操作都有对应的CLI命令。点击**自动化**标签上的**下载CLI**以安装它；安装后，当应用启动时，它会自动更新。运行`incogniton-cli cloudphone-list`以查看您的手机及其ID。有关命令、标志和输出的工作方式，请参阅[CLI文档](https://api-docs.incogniton.com/cli)。

### 从AI客户端（MCP）控制云手机

当您使用MCP令牌连接AI客户端（例如Claude或Cursor）（**设置 > 自动化 > 生成MCP令牌**，请参阅[使用MCP连接AI客户端](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/connect-ai-clients-mcp.md)），AI客户端可以：

* **列出**您的云手机及其状态以及ADB是否开启。
* **启动**手机而不打开屏幕，用于ADB、已安装应用和自动化。
* **停止**手机。
* **创建**一个新的云手机，并从您的代理库中设置代理。

MCP工具在Incogniton的服务器上运行，因此即使Incogniton应用关闭，它们也能工作。它们无法打开手机的屏幕：要查看手机，请在应用中打开它（**云手机**，然后**开机**或**连接**）。通过MCP启动的手机会继续运行，直到它被停止，或者直到您的Incogniton应用关闭并且**Incogniton关闭时停止我的云手机**开启（运行自动化任务的手机会继续运行）。

{% hint style="info" %}
开发者文档在[api-docs.incogniton.com](https://api-docs.incogniton.com/apis)上涵盖了配置文件、cookie和自动化端点。如果您对云手机自动化有任何疑问，请联系我们的[支持部门](https://incogniton.com/contact/)。
{% endhint %}
