Configura y prueba Playwright MCP en Claude Code

Decide dónde debe estar disponible el servidor antes de ejecutar claude mcp add. Usa local para probarlo de forma privada en un proyecto, project para compartir la configuración con el equipo y user si tú quieres usarlo en varios proyectos. Después comprueba la conexión y haz que el navegador devuelva un dato visible.

Una persona pasó --isolated como opción de Claude y recibió un error de argumento desconocido. La opción pertenece a Playwright y va después del separador. Más adelante, Tabbit Browser ilustra el caso de una pestaña ya autenticada. Discusión original

Puntos clave

• Empieza en la raíz del proyecto. Local y project tienen relación con el proyecto, pero se guardan en sitios distintos.

• Coloca --scope y --transport antes de --. Pasa --headless y --isolated al comando del servidor.

• Una entrada puede existir aunque su ejecutable falle. Comprueba claude mcp list y luego las herramientas.

• Valida con una página pública y revisa la salida real, no solo la respuesta escrita.

• Para el primer ensayo, usa el ámbito más pequeño y un navegador con estado temporal.

Elegir el ámbito

El ámbito predeterminado es local. Sigue limitado al proyecto. Si coinciden los nombres, Claude Code elige primero local, después project y por último user. Si cambiaste una entrada y aparece otra orden de arranque, revisa los nombres en esos tres ámbitos. Ámbitos de Claude Code

El servidor Playwright MCP puede funcionar en distintos clientes, pero el formato exterior depende del cliente. En la guía de Codex y Playwright MCP la configuración es TOML. El archivo de proyecto de Claude Code es JSON.

Registrar una configuración privada

Comprueba que la misma terminal encuentra Claude Code y npx. El manual de Playwright pide Node.js 20 o posterior. El ejemplo fija la versión comprobada y usa un navegador sin ventana con estado temporal. Instalación de Playwright MCP

claude --version
node --version
claude mcp add --scope local --transport stdio playwright -- npx -y @playwright/mcp@0.0.84 --headless --isolated
claude mcp list

Claude interpreta lo que queda a la izquierda de --. Lo de la derecha corresponde al ejecutable y sus argumentos. Si ves unknown option '--headless', comprueba el separador. Headless controla la ventana. Isolated usa estado temporal. Sintaxis stdio de Anthropic

Compartir el servidor con el equipo

Guarda una entrada equivalente en .mcp.json en la raíz o registra el servidor con --scope project. El equipo puede leer qué se ejecutará y aprobarlo al iniciar Claude Code. Los tokens y las rutas privadas quedan fuera del archivo compartido. Guía rápida de Claude Code

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@0.0.84", "--headless", "--isolated"]
    }
  }
}

Este archivo indica cómo arrancar el servidor. La cuenta y los permisos dependen de la sesión del navegador y de las políticas del equipo. Si el sitio de pruebas necesita autenticación, prepara por separado un perfil autorizado. La guía de perfiles y espacios de trabajo explica qué estado puede guardar cada perfil.

Probar la conexión con una página pública

Abre una sesión nueva en el proyecto configurado. Busca Playwright en /mcp. Pide una acción de lectura y nombra el servidor para evitar que el asistente sustituya la prueba por la terminal o una búsqueda web.

Usa Playwright MCP para abrir
https://www.selenium.dev/selenium/web/web-form.html.
Indica la URL final y el primer encabezado visible según la salida de la herramienta.
No rellenes ni envíes nada. Detente después de leer.

El encabezado esperado es Web form. Si la navegación devuelve solo la ruta de una captura, pide browser_snapshot. Contrasta la herramienta, el destino y el encabezado antes de pasar a un clic. La guía de navegadores con agentes explica cómo usan esta observación.

La prueba usó Claude Code 2.1.318, Node.js 22 y Playwright MCP 0.0.84. En un proyecto temporal, Claude Code registró los ámbitos y comprobó las conexiones. Una prueba de protocolo inició el comando exacto del archivo de proyecto, detectó browser_navigate y browser_snapshot, y leyó Web form. La prueba dejó el formulario sin enviar y no inició un turno del modelo Claude.

La entrada local se conectó en el proyecto. La entrada project quedó pendiente de aprobación y en un segundo directorio solo apareció la entrada user.

Qué comprobar según el síntoma

La prueba también registró un nombre con un ejecutable inexistente. El registro se creó, pero la conexión falló. Al mover --headless al lado de Claude, el analizador rechazó el comando antes de lanzar un navegador. Ambos problemas aparecen en etapas diferentes.

Otra persona vio una conexión en claude mcp list que no aparecía en el /mcp de la sesión activa. Comprueba ambas vistas antes de editar la configuración otra vez. Discusión original

La búsqueda de herramientas puede cargar las definiciones de MCP cuando el asistente las necesita. Pide una acción concreta de lectura en una sesión nueva y revisa el nombre de la herramienta en la traza. Si la política la deniega, comprueba el motivo. Mira otras herramientas de automatización cuando el servidor elegido realmente no sirva para la tarea. Búsqueda de herramientas de Anthropic

Cuándo conectar una pestaña que ya usas

La sesión aislada sirve para repetir una prueba pública. Si el trabajo empieza en un panel autenticado, especifica la pestaña, la cuenta y el espacio de trabajo. Confirma el título y la cuenta con una lectura antes de cambiar datos. La guía de conexión a un navegador existente detalla esta comprobación.

Tabbit Browser ofrece otra conexión para agentes compatibles, entre ellos Claude Code. Puede servir cuando necesitas trabajar en una pestaña de Tabbit que ya está abierta. El vídeo de un formulario de vendedor muestra la verificación posterior en el listado de la cuenta con otro agente de programación. Inicio rápido de Tabbit

Empieza con una entrada local y una página pública. Comparte la configuración de proyecto después de revisarla, o elige user si necesitas varios proyectos. Si el trabajo requiere un inicio de sesión existente, usa un flujo de conexión aprobado. Mantén un resultado comprobable en cada ensayo de automatización del navegador.

Secholar.L

Crecimiento y contenido en Tabbit

Secholar.L escribe guías prácticas sobre navegadores con IA y flujos de trabajo con agentes, comparando herramientas con investigación real y fuentes verificables.