Respuesta corta: en Playwright MCP, añade --proxy-server "http://USUARIO:CONTRASEÑA@HOST:PUERTO" a los argumentos del servidor (o define la variable PLAYWRIGHT_MCP_PROXY_SERVER con la misma dirección) y reinicia Claude, Cursor o VS Code. Desde ese momento, cada sitio que abra el agente ve la IP del proxy, no la de tu conexión.
Playwright MCP es el servidor MCP oficial de Microsoft que le da al asistente de IA un navegador real: abre páginas, hace clic, rellena formularios y lee el resultado. Sin proxy, ese navegador sale por tu conexión o, si el agente corre en un servidor, por una IP de datacenter que muchos sitios bloquean.
Cuándo el agente necesita proxy
- El sitio bloquea IPs de servidor. Plataformas de anuncios, marketplaces y redes sociales piden verificación o bloquean rangos de datacenter.
- La tarea tiene varios pasos con sesión iniciada. Si la IP cambia entre el inicio de sesión y la confirmación, el sitio ve un acceso que saltó de lugar. La guía de automatización con sesión e IP fija explica por qué.
- El resultado depende del país. Precio, envío y búsqueda cambian con la ubicación. Para ver lo que ve un cliente de México o de España, el navegador necesita una IP de ese país.
1. Copiar la dirección del proxy
En el panel, abre el proxy y copia el formato URL HTTP. Ya viene como http://usuario:contraseña@host:puerto, con los símbolos de la contraseña codificados.
Si usas el MCP de ProxyBox, puedes pedírselo al asistente: "exporta el proxy 12 en formato url_http".
2. Pegarla en la configuración de Playwright MCP
Claude Desktop, Cursor y Windsurf
En el archivo de servidores MCP, añade --proxy-server con la dirección del paso 1:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [
"@playwright/mcp@latest",
"--proxy-server",
"http://USUARIO:CONTRASEÑA@HOST:PUERTO"
]
}
}
}
Claude Code
claude mcp add playwright -- npx @playwright/mcp@latest --proxy-server "http://USUARIO:CONTRASEÑA@HOST:PUERTO"
VS Code
En el archivo .vscode/mcp.json, usa la clave servers y añade el mismo par --proxy-server y dirección en la lista args.
Con la variable de entorno
En lugar del argumento, puedes usar la variable PLAYWRIGHT_MCP_PROXY_SERVER, útil cuando la misma configuración va a varias computadoras (ordenadores):
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"],
"env": { "PLAYWRIGHT_MCP_PROXY_SERVER": "http://USUARIO:CONTRASEÑA@HOST:PUERTO" }
}
}
}
Después de guardar, cierra y vuelve a abrir el programa.
3. Comprobar la IP
Pide al asistente: "abre https://api.ipify.org y dime el número que aparece". Debe ser la IP de tu proxy. Si aparece la IP de tu conexión, el programa no leyó la configuración nueva: revisa el archivo y reinicia.
Contraseña con @, : u otros símbolos
En una dirección, @ y : tienen una función propia. Por eso, dentro de la contraseña, deben ir codificados: @ pasa a %40, : a %3A y / a %2F. El formato URL HTTP del panel y el MCP de ProxyBox ya entregan la dirección codificada. Si la armas a mano, codifícala antes de pegarla.
Una IP y un perfil por cuenta
Playwright MCP guarda cookies e inicios de sesión en un perfil de navegador. Para operar más de una cuenta sin mezclarlas, registra un servidor por cuenta, cada uno con su proxy y su perfil:
{
"mcpServers": {
"tienda-a": {
"command": "npx",
"args": ["@playwright/mcp@latest", "--proxy-server", "http://USUARIO:CONTRASEÑA@HOST-A:PUERTO", "--user-data-dir", "/ruta/perfiles/tienda-a"]
},
"tienda-b": {
"command": "npx",
"args": ["@playwright/mcp@latest", "--proxy-server", "http://USUARIO:CONTRASEÑA@HOST-B:PUERTO", "--user-data-dir", "/ruta/perfiles/tienda-b"]
}
}
}
Para pruebas que no deben guardar nada, usa --isolated: el perfil queda solo en memoria y desaparece al cerrar.
Si alguna dirección debe salir sin proxy (un panel interno, por ejemplo), inclúyela en --proxy-bypass, separada por comas.
Playwright MCP, Browser Use y el MCP de ProxyBox
| Herramienta | Qué hace | Proxy |
|---|---|---|
| Playwright MCP | Da al asistente un navegador para abrir, hacer clic y rellenar | --proxy-server o PLAYWRIGHT_MCP_PROXY_SERVER, con usuario y contraseña |
| Browser Use (biblioteca de Python) | Agente de navegación en tu propio código | Parámetro proxy del navegador, con servidor, usuario y contraseña |
| Browser Use (servidor MCP) | El mismo agente dentro de Claude | Sin opción de proxy en la documentación a esta fecha |
| MCP de ProxyBox | Lista, prueba, cambia y configura tus proxies | Es el que entrega la dirección a los demás |
La combinación más simple: el MCP de ProxyBox entrega la dirección del proxy y Playwright MCP navega por ella.
Qué IP usar en el agente
- ISP residencial estático: para cuentas con sesión iniciada y sitios que bloquean datacenter. La IP es de un proveedor de internet y no cambia.
- IPv4 dedicado: para pruebas, APIs y sitios sin bloqueo a datacenter.
El país se elige en el checkout. La página de proxy para agentes de IA compara las opciones, y los precios están en precios.
Problemas comunes
- Error 407: usuario o contraseña incorrectos, o un símbolo de la contraseña sin codificar. Consulta el error 407.
- ERR_PROXY_CONNECTION_FAILED: host o puerto incorrectos, o el proxy está caído. Consulta cómo resolverlo.
- ERR_TUNNEL_CONNECTION_FAILED: el proxy rechazó abrir la conexión segura. Consulta el paso a paso.
- Funciona en el navegador normal, pero no en el agente: el programa sigue con la configuración anterior. Ciérralo por completo y ábrelo de nuevo.
Escrito según la documentación de @playwright/mcp 0.0.84 y de Browser Use al 05/11/2026.