与 MCP 集成

无头浏览器可与 MCP 配合使用，使 AI 系统能够控制远程浏览器。详细了解此集成。

本指南说明如何集成 Oxylabs 无头浏览器 与 MCP（模型上下文协议）结合，以使 AI 系统能够与远程浏览器交互并进行控制。

请访问 Oxylabs GitHub 仓库，查看以下内容的完整可运行示例： MCP 与 Oxylabs 无头浏览器的集成.

概述

Model Control Protocol（MCP）允许 Claude 等 AI 系统与浏览器交互并执行基于 Web 的任务。将 Oxylabs 无头浏览器与 MCP 集成后，你可以实现 AI 系统执行 Web 导航、数据检索和自动化 任务，使用具有高级自主导航能力的远程浏览器，并结合 住宅代理 集成。

MCP 主机（例如 Claude Desktop 或 Cursor）自带内置 MCP 客户端。Playwright-MCP 充当 MCP 服务器，并且它不使用本地浏览器，而是通过安全的 WebSocket 连接（WSS）连接到无头浏览器。

开始使用

在设置集成之前，请确保你已具备：

1. Oxylabs 账户：获取你的 用户名 和 密码 ，用于无头浏览器，来自 Oxylabs 控制台.
2. Node.js：版本 18.0.0 或更高（包括 npm/npx)

• Windows：从以下位置下载并安装 nodejs.org
• macOS：使用 Homebrew（brew install node）或从以下位置下载 nodejs.org
• Linux:

  • Ubuntu/Debian： sudo apt update && sudo apt install nodejs npm
  • Fedora： sudo dnf install nodejs npm
  • 或者从以下位置下载 nodejs.org

1. MCP 主机：已安装 Claude Desktop 或 Cursor。

配置 MCP 服务器

使用你的 Oxylabs 凭据创建 MCP 服务器配置部分。将 USERNAME 和 PASSWORD 替换为你的实际 Oxylabs 凭据：

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://USERNAME:[e-mail]"
  ]
}

选项 1：与 Cursor 集成

1. 打开 Cursor
2. 打开 Cursor 设置
3. 选择 MCP
4. 添加准备好的 MCP 服务器配置
5. 重启 Cursor

选项 2：与 Claude Desktop 集成

1. 打开 Claude Desktop
2. 打开 Claude Desktop 设置
3. 转到 Developer
4. 点击 Edit Config
5. 编辑 claude_desktop_config.json 文件
6. 添加准备好的 MCP 服务器配置
7. 重启 Claude Desktop

高级配置选项

国家/地区选择

您可以通过在连接 URL 中添加 ?p_cc 参数添加到你的连接 URL 中：

"oxylabs_headless_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://USERNAME:[e-mail]?p_cc=US"
  ]
}

替换 US 为你所需的 SO-3166 国家代码。如果未指定国家/地区，系统将根据可用性自动分配一个。

你可以在以下位置找到 ISO-3166 国家/地区代码 这里.

你也可以使用 p_state 或 p_city 用于州（US）或城市级定位，或使用粘性住宅代理，以实现更精细的出口 IP 控制。了解更多 这里.

故障排除

如果你在集成中遇到问题：

1. 连接问题:

   • 验证你的 Oxylabs 凭据
   • 检查你的网络连接
   • 确保防火墙没有阻止 WebSocket 连接
2. 性能问题:

   • 对于美国用户，请尝试 US 专用端点
   • 如有需要，可在配置中增加超时时间
3. 浏览器未加载:

   • 检查 Node.js 版本（必须为 18.0.0 或更高）
   • 验证 npx 已正确安装
   • 重启 MCP 主机应用