跳转到内容
For the complete documentation index, see llms.txt. This page is also available as Markdown.

连接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 18 或更新版本。

生成您的 MCP 令牌

1

打开自动化选项卡

点击左侧菜单中的设置,然后点击自动化选项卡。滚动到MCP 令牌部分。

2

生成令牌

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

3

复制并存储

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

替换或撤销您的令牌

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

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

将 Incogniton 添加到您的 AI 客户端

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

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

有关其他 MCP 客户端的手动设置,请参阅 MCP 服务器文档。

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

连接后,您的 AI 客户端可以:

  • 配置文件: 搜索、创建、编辑和克隆配置文件,并查找您可以用于新配置文件的组、标签、代理和浏览器语言。

  • 组和标签: 搜索和创建配置文件组和标签。

  • 代理: 搜索和添加代理,搜索和创建代理组。

  • 团队: 查找团队成员。

  • 启动和停止: 查看哪些计算机可以启动配置文件,启动配置文件,检查启动或停止是否成功,并停止配置文件。

  • 云手机: 列出您的云手机,使用代理库中的代理创建云手机,并启动或停止云手机。通过 MCP 启动的手机没有屏幕。

完整的工具列表在 MCP 服务器文档中。

MCP 启动的工作原理

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

  • 如果有一台计算机可用,配置文件将在那里启动。如果有多台,AI 客户端会获取计算机列表,您可以选择一台。

  • 未在 5 分钟内被任何计算机接收的启动请求将过期。

  • MCP 只能停止通过 MCP 启动的配置文件。关闭您自己从 Incogniton 应用中打开的配置文件。

MCP 启动后控制浏览器

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

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

cdp_url 仅在 AI 客户端与启动配置文件的 Incogniton 应用运行在同一台计算机上时有效。它无法从另一台计算机或无法运行代码的客户端(如 Claude Desktop)上工作。还需要在自动化选项卡中打开允许浏览器远程控制。请参阅 浏览器远程控制。

MCP 无法执行的操作

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

  • 在运行的配置文件中打开 URL、管理标签或读取页面。

  • 检查代理是否有效。

  • 删除配置文件。

  • 从备份中恢复配置文件。

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

故障排除

  • 客户端未显示 Incogniton 工具: 在粘贴配置后重新启动 AI 客户端,并检查是否安装了 Node.js 18 或更新版本。

  • 客户端的 MCP 日志显示“缺少承载令牌”: 配置中缺少令牌。将您的令牌粘贴到 YOUR_MCP_TOKEN 的位置。

  • 身份验证错误: 令牌已被替换或撤销。生成一个新令牌并更新配置。

对于在您自己计算机上运行的脚本,您还可以使用 本地 REST API 或 JavaScript 和 Python SDK。

最后更新于

这有帮助吗?