> 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/zi-dong-hua-api-he-sdk/connect-ai-clients-mcp.md).

# 连接AI客户端与MCP

在设置 → 自动化中生成一个 MCP 令牌，并将 Claude Desktop、Claude Code、Cursor、Windsurf、VS Code 或 Codex CLI 连接到您的 Incogniton 账户。

打开左侧菜单中的**设置**，点击**自动化**选项卡，然后点击**生成 MCP 令牌**。然后在**在您的 AI 客户端中安装**下选择您的 AI 客户端，点击**复制配置**。

MCP（模型上下文协议）允许像 Claude、Cursor 或 VS Code 这样的 AI 客户端与您的 Incogniton 账户协同工作。您可以要求它查找、创建或编辑配置文件，管理代理、组和标签，以及启动或停止配置文件。

连接通过 npm 包 `@incogniton/mcp` 运行。您的 AI 客户端使用 `npx` 启动它，因此您需要在运行 AI 客户端的计算机上安装 [Node.js](https://nodejs.org/) 18 或更新版本。

### 生成您的 MCP 令牌

{% stepper %}
{% step %}

#### 打开自动化选项卡

点击左侧菜单中的**设置**，然后点击**自动化**选项卡。滚动到**MCP 令牌**部分。
{% endstep %}

{% step %}

#### 生成令牌

点击**生成 MCP 令牌**。新令牌会出现在按钮下方的字段中。
{% endstep %}

{% step %}

#### 复制并存储

点击令牌旁边的**复制**并将其存储在安全的地方，例如密码管理器。Incogniton 只显示令牌一次：**警告：您无法稍后检索此令牌——请立即复制并存储。**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
将 MCP 令牌视为密码。拥有它的人可以管理您账户的配置文件。切勿分享或将其粘贴到公共文件中。
{% endhint %}

### 替换或撤销您的令牌

您一次只能有一个活动的 MCP 令牌。再次点击**生成 MCP 令牌**会创建一个新令牌并使旧令牌失效。更新您连接的每个 AI 客户端中的令牌。

要停止所有访问，请在**活动令牌**下点击**撤销**。当没有活动令牌时，该部分显示**没有活动令牌**。

### 将 Incogniton 添加到您的 AI 客户端

在**在您的 AI 客户端中安装**下，打开**AI 客户端**下拉菜单并选择您的客户端：Claude Desktop、Claude Code、Cursor、Windsurf、VS Code 或 Codex CLI。Incogniton 显示一个已填入新令牌的可粘贴配置，并告诉您粘贴的位置。点击**复制配置**，将其粘贴到应用程序指示的位置，并重新启动 AI 客户端。

首先生成令牌。如果您稍后打开此列表，配置中将包含 `YOUR_MCP_TOKEN` 而不是令牌：用您存储的令牌替换它。

有关其他 MCP 客户端的手动设置，请参阅 [MCP 服务器文档](https://api-docs.incogniton.com/mcp)。

### AI 客户端通过 MCP 可以做什么

连接后，您的 AI 客户端可以：

* **配置文件：** 搜索、创建、编辑和克隆配置文件，并查找您可以用于新配置文件的组、标签、代理和浏览器语言。
* **组和标签：** 搜索和创建配置文件组和标签。
* **代理：** 搜索和添加代理，搜索和创建代理组。
* **团队：** 查找团队成员。
* **启动和停止：** 查看哪些计算机可以启动配置文件，启动配置文件，检查启动或停止是否成功，并停止配置文件。
* **云手机：** 列出您的云手机，使用代理库中的代理创建云手机，并启动或停止云手机。通过 MCP 启动的手机没有屏幕。

完整的工具列表在 [MCP 服务器文档](https://api-docs.incogniton.com/mcp)中。

### MCP 启动的工作原理

配置文件总是在您的一台计算机上的 Incogniton 应用中打开。该计算机必须打开应用并登录到您的账户。

* 如果有一台计算机可用，配置文件将在那里启动。如果有多台，AI 客户端会获取计算机列表，您可以选择一台。
* 未在 5 分钟内被任何计算机接收的启动请求将过期。
* MCP 只能停止通过 MCP 启动的配置文件。关闭您自己从 Incogniton 应用中打开的配置文件。

### MCP 启动后控制浏览器

MCP 本身只打开和关闭配置文件。它无法点击、输入或读取浏览器内的页面。

启动后，AI 客户端可以获取正在运行的浏览器的本地 DevTools 地址（`cdp_url`）。可以运行代码的 AI 客户端可以将 Puppeteer、Playwright 或浏览器 MCP 连接到该地址。

{% hint style="info" %}
`cdp_url` 仅在 AI 客户端与启动配置文件的 Incogniton 应用运行在**同一台计算机**上时有效。它无法从另一台计算机或无法运行代码的客户端（如 Claude Desktop）上工作。还需要在自动化选项卡中打开**允许浏览器远程控制**。请参阅 [浏览器远程控制](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/browser-remote-control.md)。
{% endhint %}

### MCP 无法执行的操作

这些操作无法通过 MCP 完成：

* 在运行的配置文件中打开 URL、管理标签或读取页面。
* 检查代理是否有效。
* 删除配置文件。
* 从备份中恢复配置文件。

Incogniton 应用中的 AI 助手 Cas 可以执行这些操作。在应用中打开 Cas 以使用它们。

### 故障排除

* **客户端未显示 Incogniton 工具：** 在粘贴配置后重新启动 AI 客户端，并检查是否安装了 Node.js 18 或更新版本。
* **客户端的 MCP 日志显示“缺少承载令牌”：** 配置中缺少令牌。将您的令牌粘贴到 `YOUR_MCP_TOKEN` 的位置。
* **身份验证错误：** 令牌已被替换或撤销。生成一个新令牌并更新配置。

对于在您自己计算机上运行的脚本，您还可以使用 [本地 REST API](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/local-rest-api.md) 或 [JavaScript 和 Python SDK](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/javascript-and-python-sdk.md)。
