Playwright MCP: completa la primera navegación del navegador en el cliente

Para quién es

Esta guía está dirigida a quienes ya usan un cliente MCP y están listos para levantar un navegador en esta máquina y automatizar páginas. Lo que hay que decidir es si conectar Playwright MCP al cliente actual ahora, no si leer antes una introducción larga. El requisito más duro es que Node.js local sea 18 o posterior; si la versión no alcanza, no se debe seguir escribiendo la configuración. El repositorio lo describe como un servidor MCP que ofrece automatización del navegador y entiende las páginas mediante instantáneas de accesibilidad, no mediante capturas de pantalla. Hay que aceptar dos cosas: en esta máquina aparecerán procesos relacionados con el navegador, y se harán visitas reales a las direcciones que se indiquen. Si solo se quiere explorar el repositorio y no se pretende que el cliente ejecute ninguna acción de navegador, este camino no sirve. Las evidencias no indican sector, puesto ni tamaño de equipo, y aquí tampoco se inventan perfiles de usuario.

Primera prueba en 3 minutos

Usar solo la ruta oficial de configuración MCP estándar. Abrir el lugar de configuración de servidores del cliente MCP que ya se está usando —las evidencias no dan un nombre de archivo concreto, así que basta la entrada de ajustes MCP de ese cliente— y añadir un servicio llamado playwright, con comando npx y argumento @playwright/mcp@latest. No colocar al lado un segundo método principal de instalación.

Confirmar primero que la máquina cumple Node.js 18 o posterior y, a continuación, escribir el siguiente JSON en la configuración tal cual, idéntico byte a byte, sin cambiar nombres de claves ni espacios:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

Guardar y luego reiniciar o recargar ese cliente. La señal de éxito es que los nombres browser_navigate y browser_navigate_back aparezcan en la lista de herramientas. La conexión cuenta solo cuando esos nombres quedan expuestos; no tomar como instalación completa que se abra una ventana del navegador o una página.

Una vez conectado, hacer solo una llamada exploratoria: usar browser_navigate. Las evidencias registran únicamente el nombre de la herramienta: no hay tabla de parámetros, ni URL de ejemplo, ni ruta de deshacer, así que lo que se rellene debe atenerse a la descripción de la herramienta que el cliente muestre en ese momento. No inventar parámetros ni puntos de conexión. Esta llamada hará que el navegador local visite la dirección indicada, produzca peticiones de red y carga de página, y deje procesos relacionados con el navegador en la máquina. No es una operación de solo lectura ni un riesgo nulo. Antes de la llamada hay que confirmar que la dirección la ha indicado uno mismo y que esa dirección puede aceptar ser visitada. Después de la llamada, el punto de confirmación es si esta llamada devuelve. Si a continuación se usa browser_navigate_back, también cambiará la página actual del navegador y podrá generar otra petición de red. Antes de esa llamada, confirmar que la sesión actual ya tiene historial de navegación al que se puede volver.

Casos de uso

Caso 1: abrir con browser_navigate una página expresamente indicada. El momento es cuando ya han aparecido los dos nombres de herramienta y se tiene una dirección que puede aceptar ser visitada. Lo único que las evidencias permiten mapear es este nombre de herramienta; no hay URL de demostración ni campos de parámetros escritos. El efecto secundario es navegación real y acceso de red. Volver a comprobar la dirección antes de la llamada y, después, ver si esta llamada ha terminado. No interpretarlo como una vista previa local sin conexión, ni asumir que el contenido de la página no se leerá.

Caso 2: volver a la página anterior con browser_navigate_back. El momento es cuando acaba de completarse una navegación en la misma sesión de navegación. Las evidencias dan de nuevo solo este nombre de herramienta: no hay API de lista de historial ni ruta de revertir o undo. Si aún no ha habido una navegación hacia adelante exitosa, el retroceso puede fallar o caer en una página no esperada; las evidencias no describen el estado tras el fallo. Esta llamada también cambiará la página actual y puede volver a pedir red. Antes de la llamada, confirmar que de verdad se ha navegado; el punto de confirmación sigue siendo si esta llamada devuelve.

Límites de uso

El suelo de ejecución es Node.js 18 o posterior; no forzar una versión inferior. La capacidad se detiene en la automatización del navegador y se indica el uso de instantáneas de accesibilidad en lugar de capturas. En las evidencias no aparecen herramientas de tipo captura, ni órdenes para cerrar el navegador, limpiar la sesión, desinstalar o undo. No asumir que no hay red, que no hay lectura local o que no hay frontera de privacidad: al navegar, el sitio de destino será visitado, el contenido de la página puede entrar en el contexto del cliente y en la máquina aparecerán procesos de navegador. Si falla el primer intento, comprobar primero la versión de Node y si el JSON coincide byte a byte con el fragmento oficial, y luego ver si han aparecido los dos nombres de herramienta. No cambiar a un método de instalación que no figure en las evidencias. No tratar como ya compatibles capacidades que las evidencias no nombran.