跳到正文

Playwright MCP 代理怎么配:agent 浏览器

三种设置代理的方法,怎么让每个登录过的 profile 固定在一个 IP 上,以及让 agent 自己跑的出口检查。

代理在 Playwright MCP 里放哪

Playwright MCP 是微软做的 MCP 服务器,让 AI agent 操作真实浏览器。它需要 Node.js 18 及以上,由你的 MCP 客户端用 npx @playwright/mcp@latest 启动。代理不是 agent 调用的工具,而是服务器启动时读取的选项,所以 agent 浏览器的流量从打开的首个页面起就走代理。

README 里列出了 --proxy-server(例如 http://user:password@myproxy:3128)和对应的环境变量 PLAYWRIGHT_MCP_PROXY_SERVER。最简单的做法,是把它加到客户端 MCP 配置里该服务器条目的 args 中。

带 --proxy-server 的 mcpServers 条目

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--proxy-server", "http://LOGIN:PASSWORD@HOST:PORT"
      ]
    }
  }
}

仅为示例:请换成你自己的值,改完后重启 MCP 客户端,服务器才会带着新参数重新启动。

代理可以放在三个地方

代理可以放在三个地方
项目账号密码出现在适合的情况
args 里的 --proxy-server客户端配置文件,以及服务器进程的命令行想最快配好,或只是临时测试
env 里的 PLAYWRIGHT_MCP_PROXY_SERVER服务器条目的 env 块你的客户端支持把密钥放进 env,而 args 想在各项目里保持一样
--config 文件里的 browser.launchOptions.proxy单独的 JSON 文件,用户名和密码是各自独立的字段密码里有 @、: 之类字符,或几项设置要一起带

来源:Playwright MCP README 和 Playwright 网络文档,2026 年 11 月 16 日阅读。README 给出了选项名及对应环境变量;配置文件结构里有 browser.launchOptions。

同一个代理,用环境变量设置

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {
        "PLAYWRIGHT_MCP_PROXY_SERVER": "http://LOGIN:PASSWORD@HOST:PORT"
      }
    }
  }
}

仅为示例:请换成你自己的值。

同一个代理,写在配置文件里

// pw-mcp-proxy.json, started with: npx @playwright/mcp@latest --config ./pw-mcp-proxy.json
{
  "browser": {
    "launchOptions": {
      "proxy": {
        "server": "http://HOST:PORT",
        "username": "LOGIN",
        "password": "PASSWORD"
      }
    }
  }
}

仅为示例:请换成你自己的值。Playwright 的 proxy 对象把 server、username、password 分成独立字段。

一个 profile,一个 IP

Playwright MCP 默认把持久化 profile 存在磁盘上,像普通浏览器一样,所以 Cookie 和登录状态在会话之间保留。README 说明每个 MCP 客户端的工作区对应一个文件夹,也可以用 --user-data-dir 指定别处。持久化 profile 同一时间只能被一个浏览器实例使用,两个客户端共用同一个 profile 会冲突。

网站看得到登录过的 profile 是从哪个 IP 连上来的,同一个 profile 一会儿换一个 IP,网站也看得到。给每个存着登录状态的 profile 配一个固定 IP,一个账号不要在多个 profile 之间共用。临时任务用 --isolated,profile 只放在内存里,会话关闭就丢掉。

把两项设置写在同一个服务器条目里,对应关系一目了然,以后加账号也不用改别处。

两个服务器条目,各有自己的 profile 和代理

{
  "mcpServers": {
    "browser-account-a": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--user-data-dir", "/home/me/pw-profiles/account-a",
        "--proxy-server", "http://LOGIN_A:PASSWORD_A@HOST_A:PORT"
      ]
    },
    "browser-account-b": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--user-data-dir", "/home/me/pw-profiles/account-b",
        "--proxy-server", "http://LOGIN_B:PASSWORD_B@HOST_B:PORT"
      ]
    }
  }
}

仅为示例:请换成你自己的值和文件夹。每个条目启动各自的浏览器,agent 按账号选对应的条目。

给 agent 任务选哪种 IP

浏览器打开一个页面会建多个连接。不开会话的动态线路,每个新连接都可能换一个 IP,复用的连接 IP 不变,所以一次页面访问可能用到不止一个 IP。抓取大量公开页面没问题,但需要登录并保持登录的任务不合适。

要保持登录的任务,用静态 ISP IP,租期内地址不变;或在动态低价线路上开会话,可选 1 到 120 分钟。给 agent 选哪种,AI agent 代理类型指南里有更详细的对比。

开工前检查出口,3 步

  1. 第 1 步

    重启 MCP 客户端,让 Playwright MCP 带着代理启动,确认服务器条目显示为运行中。

  2. 第 2 步

    对 agent 说:用 browser_navigate 打开 https://ipinfo.io/json,告诉我 "ip" 和 "country" 的值。

  3. 第 3 步

    把 ip 和 country 与你配置的代理对照。显示的是你自己的地址,说明参数没传到服务器,看下面的表。确认无误后,再交给 agent 真正的任务。

代理好像没生效时

IP 页面显示的是你自己的地址

检查 改完配置后重启过 MCP 客户端吗?改的是正在用的那个条目吗?参数是在服务器启动时读取的。

处理 重启客户端再问一次。如果持久化 profile 被另一个正在运行的浏览器占着,关掉那个,或让这个服务器改用别的 --user-data-dir。

停止条件 仍然显示你自己的地址,就用 curl 走同一个代理,看代理本身通不通。

带登录的 SOCKS5 代理连不上

检查 Chrome 不支持带用户名密码的 SOCKS5,Playwright 的 username 和 password 字段也只用于 HTTP(S) 代理。

处理 改用同一个 IP 的 HTTP 端口,比如 Proxy302 的 2222 端口。

停止条件 不要在同一个参数里反复试带登录的 socks5://。

agent 报 ERR_PROXY_CONNECTION_FAILED

检查 --proxy-server 里的主机、端口、协议是否正确,代理本身有没有响应。

处理 改正地址,或按连接失败指南逐项检查。

停止条件 curl 走同一个代理也不通,就带订单号提交工单。

页面弹出登录框,或报 407

检查 账号和密码是否完整,有没有输错 @、: 这类容易漏掉的字符。

处理 从「我的资产」重新复制,或改写到配置文件里,让用户名和密码成为各自独立的字段。

停止条件 同一组账号在 curl 里也失败,就看代理认证指南,或带订单号提交工单。

用 Proxy302:给 agent 浏览器买什么

Proxy302 的入口 HTTP 是 2222 端口,SOCKS5 是 3333 端口。要给需要登录的 Playwright MCP 浏览器用,就把「我的资产」里的 HTTP 资产填进 --proxy-server。静态 ISP IP 1 天 US$0.50,30 天 US$7.99,各国价格相同,租期内不变。动态住宅低价线路流量每 GB US$1.50。

不提供免费试用,最小购买单位是 1 GB 动态流量或一个 IP 一天。请遵守各平台条款和支持的国家地区,平台要求验证时如实完成。

4 步把 Proxy302 接进 Playwright MCP

  1. 第 1 步

    打开静态住宅页面,选国家,「协议」保持 HTTP,下单。

  2. 第 2 步

    打开「我的资产」(控制台里放着你买到的全部代理),复制 HOST、PORT、USERNAME 和 PASSWORD。

  3. 第 3 步

    在 Playwright MCP 条目里写成 --proxy-server http://USERNAME:PASSWORD@HOST:PORT,然后重启 MCP 客户端。

  4. 第 4 步

    让 agent 先打开 https://ipinfo.io/json,确认 IP 和国家无误,再开始任务。

Playwright MCP 代理常见问题

Playwright MCP 有代理设置吗?

有。README 列出了 --proxy-server,以及环境变量 PLAYWRIGHT_MCP_PROXY_SERVER。

agent 运行中能换代理吗?

README 没有写运行时切换的办法。改参数后重启 MCP 客户端,服务器会重新启动。

同样的写法能用 SOCKS5 代理吗?

README 的代理地址示例里有 socks5://,但需要用户名密码的 SOCKS5 代理在 Chrome 里用不了,这种情况请用 HTTP 端口。

每个 agent 都要单独的 profile 吗?

agent 要登录账号的话,要:给它单独的 --user-data-dir 和固定 IP。只是匿名浏览的话,用 --isolated 就够了。

是有界面还是无头?

默认有界面;加 --headless 就不开窗口。代理选项都一样。

参考资料

5
  1. Playwright MCP README(microsoft/playwright-mcp)

    官方文档 · 确认日期:

    2026 年 11 月 16 日阅读:--proxy-server(示例 http://myproxy:3128、http://user:password@myproxy:3128、socks5://myproxy:8080)及对应的环境变量 PLAYWRIGHT_MCP_PROXY_SERVER;--config 配置文件的 browser.launchOptions 与 browser.contextOptions;默认持久化 profile,另有 --isolated、--user-data-dir、--storage-state;持久化 profile 同一时间只能被一个浏览器实例使用;需要 Node.js 18 及以上;工具包括 browser_navigate、browser_evaluate、browser_network_requests。

  2. Playwright 文档:Network 的 HTTP proxy 一节

    官方文档 · 确认日期:

    2026 年 11 月 16 日阅读:代理可以设给整个浏览器,也可以设给每个 browser context;支持 HTTP(S) 和 SOCKSv5;用户名和密码用于 HTTP(S) 代理。

  3. Chromium 文档:Chrome 的代理支持(net/docs/proxy.md)

    官方文档 · 确认日期:

    2026 年 11 月 16 日阅读:Chrome 里 SOCKSv5 不支持任何认证方式。

  4. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口、没有免费试用。

  5. Proxy302 线路实测(2026 年 11 月 11 日)

    产品观察 · 确认日期:

    Proxy302 于 2026 年 11 月 11 日对动态线路的实测:不开会话时每个新连接换一个 IP,复用的连接 IP 不变;低价线路可选 1 到 120 分钟的会话。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。