Resposta curta: no Playwright MCP, acrescente --proxy-server "http://USUARIO:SENHA@HOST:PORTA" aos argumentos do servidor (ou defina a variável PLAYWRIGHT_MCP_PROXY_SERVER com o mesmo endereço) e reinicie o Claude, o Cursor ou o VS Code. A partir daí, todo site que o agente abrir vê o IP do proxy, e não o da sua internet.
O Playwright MCP é o servidor MCP oficial da Microsoft que dá ao assistente de IA um navegador de verdade: ele abre páginas, clica, preenche formulários e lê o resultado. Sem proxy, esse navegador sai pela sua conexão ou, se o agente roda num servidor, por um IP de datacenter, que muitos sites barram.
Quando o agente precisa de proxy
- O site barra IP de servidor. Plataformas de anúncio, marketplaces e redes sociais pedem verificação ou bloqueiam faixas de datacenter.
- A tarefa tem várias etapas logadas. Se o IP muda entre o login e a confirmação, o site enxerga um acesso que pulou de lugar. Um IP fixo por conta resolve.
- O resultado depende da cidade ou do país. Preço, frete e busca mudam com a localização. Para ver o que o cliente brasileiro vê, o navegador precisa de IP brasileiro.
1. Pegar o endereço do proxy
No painel, em Meus proxies, abra o proxy e copie o formato URL HTTP. Ele já vem no formato http://usuario:senha@host:porta, com os símbolos da senha codificados.
Se você usa o MCP da ProxyBox, dá para pedir ao próprio assistente: "exporta o proxy 12 no formato url_http".
2. Colar na configuração do Playwright MCP
Claude Desktop, Cursor e Windsurf
No arquivo de servidores MCP, acrescente --proxy-server com o endereço do passo 1:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--proxy-server",
"http://USUARIO:SENHA@HOST:PORTA"
]
}
}
}
Claude Code
claude mcp add playwright -- npx @playwright/mcp@latest --proxy-server "http://USUARIO:SENHA@HOST:PORTA"
VS Code
No arquivo .vscode/mcp.json, use a chave servers e acrescente o mesmo par --proxy-server e endereço na lista args.
Pela variável de ambiente
Em vez do argumento, dá para usar a variável PLAYWRIGHT_MCP_PROXY_SERVER, que é útil quando a mesma configuração vai para várias máquinas:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"],
"env": { "PLAYWRIGHT_MCP_PROXY_SERVER": "http://USUARIO:SENHA@HOST:PORTA" }
}
}
}
Depois de salvar, feche e abra o programa de novo.
3. Conferir o IP
Peça ao assistente: "abra https://api.ipify.org e me diga o número que aparece". Ele precisa ser o IP do seu proxy. Se aparecer o IP da sua internet, o programa não leu a configuração nova: confira o arquivo e reinicie.
Senha com @, : ou outros símbolos
No formato de endereço, @ e : têm função própria. Por isso, dentro da senha, eles precisam ir codificados: @ vira %40, : vira %3A e / vira %2F. O formato URL HTTP do painel e o MCP da ProxyBox já entregam o endereço codificado. Se você montar à mão, codifique antes de colar.
Um IP e um perfil por conta
O Playwright MCP guarda cookies e logins num perfil de navegador. Para operar mais de uma conta sem misturar, cadastre um servidor para cada conta, cada um com o seu proxy e o seu perfil:
{
"mcpServers": {
"loja-a": {
"command": "npx",
"args": ["@playwright/mcp@latest", "--proxy-server", "http://USUARIO:SENHA@HOST-A:PORTA", "--user-data-dir", "/caminho/perfis/loja-a"]
},
"loja-b": {
"command": "npx",
"args": ["@playwright/mcp@latest", "--proxy-server", "http://USUARIO:SENHA@HOST-B:PORTA", "--user-data-dir", "/caminho/perfis/loja-b"]
}
}
}
Para testes que não devem guardar nada, use --isolated: o perfil fica só na memória e some ao fechar.
Se algum endereço precisa sair sem proxy (um painel interno, por exemplo), liste-o em --proxy-bypass, separado por vírgulas.
Playwright MCP, Browser Use e MCP da ProxyBox
| Ferramenta | O que faz | Proxy |
|---|---|---|
| Playwright MCP | Dá ao assistente um navegador para abrir, clicar e preencher | --proxy-server ou PLAYWRIGHT_MCP_PROXY_SERVER, com usuário e senha |
| Browser Use (biblioteca Python) | Agente de navegação no seu próprio código | Parâmetro proxy do navegador, com servidor, usuário e senha |
| Browser Use (servidor MCP) | O mesmo agente dentro do Claude | Sem opção de proxy na documentação até esta data |
| MCP da ProxyBox | Lista, testa, troca e configura os seus proxies | É ele que entrega o endereço para os outros |
A combinação mais simples: o MCP da ProxyBox entrega o endereço do proxy, e o Playwright MCP navega por ele.
Qual IP usar no agente
- ISP residencial fixo: para contas logadas e sites que barram datacenter. O IP é de provedor de internet e não muda.
- IPv4 dedicado: para testes, APIs e sites sem bloqueio a datacenter. Mais barato.
- Residencial por GB: para ler muitas páginas públicas, sem conta logada.
A página de proxy para agentes de IA compara as opções com os planos.
Problemas comuns
- Erro 407: usuário ou senha errados, ou símbolo da senha sem codificar. Veja o erro 407.
- ERR_PROXY_CONNECTION_FAILED: host ou porta errados, ou o proxy está fora do ar. Veja como resolver.
- ERR_TUNNEL_CONNECTION_FAILED: o proxy recusou abrir a conexão segura. Veja o passo a passo.
- Funciona no navegador comum, mas não no agente: o programa ainda está com a configuração antiga. Feche totalmente e abra de novo.
Escrito conforme a documentação do @playwright/mcp 0.0.84 e do Browser Use em 05/11/2026.