Servidor Playwright MCP: deja que un asistente maneje un navegador real
Guía del servidor Playwright MCP y generador de configuración
Servidor Playwright MCP: instalación, opciones y herramientas | We.Inc
Qué hace el servidor Playwright MCP, cómo funcionan las instantáneas de accesibilidad, las opciones que vale la pena configurar, sus herramientas principales y un generador que escribe la configuración por ti.
Playwright MCP es el servidor MCP de código abierto de Microsoft que da a un asistente de IA un navegador real para hacer clic, escribir, rellenar formularios y leer páginas. En lugar de mirar capturas de pantalla, lee el árbol de accesibilidad de la página, una lista estructurada de botones, enlaces y texto. Necesita Node.js 18 o posterior y se instala con una sola línea de npx.
Playwright MCP de un vistazo
Elemento
Valor
Paquete npm
@playwright/mcp
Requisito
Node.js 18 o posterior
Cómo ve las páginas
Instantáneas de accesibilidad, no píxeles
Navegadores
chrome, firefox, webkit, msedge
Ventana por defecto
Con interfaz (visible); añade --headless para ocultarla
Si tienes un sitio web o una tienda, Playwright MCP es una forma práctica de que un asistente recorra tus propias páginas como lo haría un cliente: abrir el menú, añadir algo al carrito, enviar el formulario de contacto e informar de lo que falla. Está construido sobre Playwright, una biblioteca de pruebas de navegador muy utilizada. Elige tus opciones abajo y copia una configuración, y después lee las notas de seguridad antes de usarlo con algo en lo que hayas iniciado sesión.
Elige un navegador y si la ventana debe ser visible o headless.
Activa el modo aislado si quieres que cada sesión empiece limpia, sin guardar nada en disco.
Añade los grupos de funciones extra que necesites, como guardar en PDF o aserciones de prueba.
Copia el JSON en la configuración de tu app MCP y reiníciala. La primera ejecución descarga el paquete.
Prueba contra una copia de staging o una cuenta de prueba, no con tu acceso de administrador real.
Usa --isolated en las pruebas para que las cookies de una sesión nunca pasen a la siguiente.
Pide una instantánea antes de pedir clics: el asistente elige los elementos de esa lista.
Da pasos exactos ("abre /pricing, haz clic en el segundo plan, indica el total") en lugar de objetivos vagos.
Ten en cuenta browser_run_code_unsafe: ejecuta cualquier código de Playwright, así que úsalo solo con prompts en los que confíes.
Preguntas frecuentes
¿Qué es una instantánea de accesibilidad?
Los navegadores mantienen un árbol de accesibilidad, la misma vista estructurada que usan los lectores de pantalla: cada botón, enlace, encabezado y campo con su nombre y su rol. Playwright MCP le pasa ese árbol al asistente, para que pueda decir "haz clic en el botón Añadir al carrito" sin adivinar a partir de una imagen.
¿Playwright MCP es una barrera de seguridad?
No, y su README lo dice en negrita. Opciones como --allowed-origins y --blocked-origins tampoco se describen como barrera de seguridad. Trátalo como una herramienta que supervisas y ejecútalo donde un error no pueda alcanzar datos reales de clientes.
¿Recuerda los inicios de sesión entre sesiones?
Por defecto usa un perfil persistente, así que los inicios de sesión se guardan en disco como en un navegador normal. Con --isolated el perfil vive en memoria y se pierde al cerrar el navegador. Puedes precargar cookies en una sesión aislada con --storage-state.
¿Puede hacer capturas de pantalla o guardar PDF?
browser_take_screenshot es una herramienta principal. Guardar en PDF (browser_pdf_save) se activa con --caps=pdf, y las herramientas de clic por coordenadas necesitan --caps=vision.
¿Uso Playwright MCP o el Playwright CLI?
El README sugiere que los agentes de programación pueden funcionar mejor con el Playwright CLI independiente, que usa menos tokens. Reserva MCP para sesiones exploratorias más largas en las que mantener abierto el estado del navegador compensa ese coste.
Persistente, aislado o tu propio navegador
Playwright MCP puede funcionar de tres formas. El perfil persistente por defecto guarda cookies e inicios de sesión en una carpeta por proyecto. El modo aislado lo mantiene todo en memoria, lo que va bien para pruebas repetibles. El modo de extensión del navegador se conecta a una ventana de Chrome o Edge que ya tienes abierta, lo cual es cómodo pero significa que el asistente actúa con tus inicios de sesión reales.
Solo un navegador puede usar un perfil persistente a la vez. Si ejecutas dos sesiones del asistente en el mismo proyecto, inicia la segunda con --isolated o con otro --user-data-dir.
Buenas tareas para él en tu propio sitio
Comprobar que cada enlace del menú principal abre una página que carga. Rellenar el formulario de contacto con datos de prueba y confirmar que aparece el mensaje de agradecimiento. Leer los mensajes de la consola en una página que parece lenta. Cambiar a un ancho de móvil y listar todo lo que se desborda.
Apunta los resultados como una lista de comprobación que puedas repetir después de cada cambio, para que la ejecución del asistente se convierta en tu prueba de regresión.
Opciones que conviene conocer
Cada opción también tiene una variable de entorno equivalente, que aparece en el README.
Opciones seleccionadas de Playwright MCP
Opción
Qué hace
--browser <browser>
chrome, firefox, webkit o msedge
--headless
Se ejecuta sin ventana visible; con interfaz es lo predeterminado
--isolated
Mantiene el perfil del navegador en memoria, no en disco
--storage-state <path>
Carga cookies y almacenamiento local en una sesión aislada
--device <device>
Emula un dispositivo, por ejemplo "iPhone 15"
--viewport-size <size>
Define el viewport en píxeles, por ejemplo "1280x720"
--caps <caps>
Activa grupos de herramientas extra, como pdf o vision
--allowed-origins / --blocked-origins
Permite o bloquea orígenes de peticiones; no es una barrera de seguridad
--timeout-action / --timeout-navigation
Por defecto 5000 ms y 60000 ms
--port <port>
Sirve por HTTP para que un cliente se conecte por URL
Herramientas principales
Herramientas principales de Playwright MCP
Herramienta
Para qué sirve
Solo lectura
Abrir una URL
No
Capturar la instantánea de accesibilidad de la página
Sí
Hacer clic en un elemento
No
Escribir en un campo
No
Rellenar varios campos a la vez
No
Guardar una captura de pantalla
Sí
Leer los mensajes de la consola
Sí
Listar las peticiones de red
Sí
Cambiar el tamaño de la ventana
No
Ejecutar código de Playwright
No
Ejemplos de configuración
Configuración estándar
La configuración mínima que da el README para la mayoría de apps MCP.
Ejecutar como servidor HTTP y conectar por URL
Útil cuando la app no puede abrir una ventana por sí misma. El cliente apunta entonces a http://localhost:8931/mcp.
Generador de configuración de Playwright MCP
Elige las opciones y copia el JSON. Esta página solo escribe texto; no abre ningún navegador.
Navegador
Headless (sin ventana visible)
Perfil aislado (no se guarda nada en disco)
Tamaño del viewport, por ejemplo 1280x720 (opcional)
Grupos de funciones extra
JSON de configuración
El viewport debe tener la forma 1280x720 (ancho x alto en píxeles). Se ha omitido.