Inicio / Artículos

Perfiles de Playwright MCP: Por qué el estado de inicio de sesión persiste o desaparece

Explicación de los perfiles MCP de Playwright: cómo los modos persistente, aislado y de extensión manejan las cookies y el estado de inicio de sesión, cómo saber cuál de ellos está en ejecución, y notas de seguridad.

Editor: REACTAPP.TOP5 min de lectura1232 palabras

Fuentes: Understanding Playwright MCP’s “Profile”: Does Login State Survive or Vanish Across persistent (default) / isolated / extension Modes?

A veces, Playwright MCP sigue estando conectado cuando se inicia una nueva sesión, sin que se haya hecho nada para que eso ocurra. Otras veces, en un sitio que definitivamente ya se visitó antes, la IA se encuentra con la página de inicio de sesión como si fuera la primera vez. Ambas son experiencias reales, y sin una explicación parecen aleatorias: ¿por qué ahora lo recuerda y por qué ahora lo olvida?

Este comportamiento no es aleatorio. Está diseñado así. Playwright MCP cuenta con una configuración llamada perfil, y el modo en el que se inicia determina cómo se maneja el estado de inicio de sesión. Lo que sigue explica ese mecanismo.

El modo persistente es el predeterminado

Al iniciar Playwright MCP sin opciones, se activa el modo de perfil persistente. Las cookies, localStorage y los tokens de autenticación se guardan en un directorio del disco. Al finalizar la sesión y reiniciar el servidor, la próxima ejecución lee la misma ubicación guardada, y por eso el estado de inicio de sesión sigue estando allí. Es la misma lógica que utiliza Chrome para recordar tu último inicio de sesión después de un reinicio.

La ruta de almacenamiento sigue el patrón ms-playwright/mcp-{channel}-{workspace-hash}. El hash del espacio de trabajo significa que cada proyecto recibe automáticamente su propio perfil. El estado de inicio de sesión de un proyecto A no se filtra al proyecto B, y no se requiere ninguna configuración adicional para esa separación.

Si deseas elegir la ubicación tú mismo, sobrescríbela con --user-data-dir. Esto es útil en una máquina compartida donde quieres que la ruta del perfil sea explícita. Al abrir ese directorio encontrarás las cookies y los tokens almacenados como archivos normales.

Una advertencia: la documentación solo indica que el hash del espacio de trabajo se deriva del directorio de trabajo y resulta único para cada proyecto. No describen el algoritmo de hash. No es necesario conocer los detalles internos. Recuerde el resultado: proyecto diferente, perfil diferente.

Cómo difiere el modo aislado

Al usar --isolated, cada sesión comienza en un contexto limpio y efímero. Al cerrar el navegador, todas las cookies y entradas de localStorage de esa sesión desaparecen.

Eso no obliga a iniciar sesión nuevamente cada vez. Con --storage-state se puede introducir un estado inicial desde un archivo JSON preparado con antelación.

npx @playwright/mcp@latest --isolated --storage-state=./auth-state.json

Ese archivo es del mismo tipo que se puede guardar con context.storageState() de Playwright, el mecanismo utilizado para reutilizar el estado de inicio de sesión en pruebas, y funciona igual de bien para iniciar una sesión MCP ya autenticada. “Aislado” no significa que no recuerde nada; significa que no mantendrá el estado entre sesiones por sí solo, aunque puedes proporcionarle el estado una vez al inicio.

La elección es sencilla. Si la IA realiza tareas habituales del navegador y deseas que también esté conectada la próxima vez, mantén el modo persistente. Si necesitas un estado limpio e idéntico en cada ejecución, ya sea para pruebas o porque no quieres que otras sesiones afecten al sistema, utiliza el modo aislado y agrega --storage-state cuando sea necesario autenticarse. Si no estás seguro, prueba primero el valor predeterminado. Observar su comportamiento facilita comprender las diferencias.

El tercer modo: extensión

Tanto el modo persistente como el aislado inician su propio navegador. En cambio, el modo de extensión se conecta a un navegador que ya tienes abierto. Es útil cuando la IA debe trabajar con el estado exacto de una pestaña que estás utilizando manualmente, ya que conectarse a tu navegador actual es más directo que dejar que MCP prepare un perfil.

Un buen ejemplo es una herramienta interna que requiere autenticación de dos factores. Playwright MCP no puede eliminar la autenticación de dos factores por sí solo, y sería preocupante si pudiera hacerlo. La forma más rápida es conectarse a la pestaña donde una persona ya ha finalizado el proceso de inicio de sesión. Un perfil persistente guardado no ayuda mucho, ya que una vez que expira la sesión de autenticación de dos factores, debes volver a iniciar sesión manualmente. El modo de extensión omite ese paso.

¿Qué modo está en ejecución?

Revisa la orden de inicio en la configuración de tu cliente, por ejemplo en Claude Code. Si --isolated no está entre los argumentos del servidor, entonces es un modo persistente.

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

Esa configuración es persistente. Añada "--isolated" y se volverá aislada. Añada también "--storage-state", "./auth-state.json" y se mantendrá aislada comenzando desde un estado autenticado. Al leer los argumentos se sabe de inmediato.

Cuando no esté seguro de si el estado realmente se ha persistido, lea primero el archivo de configuración. Juzgar únicamente por el comportamiento es complicado: una red lenta y una inicialización de perfil nueva pueden parecerse.

Las sesiones nombradas aún no son oficiales

Puede preguntarse si sería posible nombrar y cambiar entre varios estados de inicio de sesión, como una sesión de administrador frente a una de usuario regular, con un solo comando. Una solicitud de funcionalidad en los issues de github de microsoft/playwright-mcp (#1530) pide exactamente eso: crear, guardar, restaurar y duplicar contextos persistentes con nombre, por ejemplo, para transferir un contexto autenticado entre agentes o separar los roles de administrador y miembro.

Hasta el momento de escribir esto, en agosto de 2026, sigue siendo una solicitud y no una funcionalidad implementada. Actualmente se trabaja con los tres modos existentes: persistente (aislamiento por espacio de trabajo), aislado con estado de almacenamiento (estado inicial explícito) y extensión (un navegador existente). Es posible que posteriormente aparezca un parámetro session-id, pero no construya flujos de trabajo basados en él por ahora.

Notas de seguridad para el estado almacenado

Sea cual sea el modo que elija, recuerde qué contiene el directorio de perfiles. Las cookies y tokens en el disco son credenciales. Mantenga el directorio fuera del control de versiones, evite compartir una cuenta de equipo con personas que no deberían ver esas sesiones, y elimine un perfil cuando finalice el proyecto al que pertenece. Un archivo JSON con el estado de almacenamiento merece la misma atención: puede iniciar sesión de alguien sin contraseña, así que trátelo como un secreto y nunca lo incluya en los commits.

El modo aislado reduce el riesgo de sesiones restantes, ya que nada persiste después de cerrar el navegador, pero no elimina la necesidad de proteger el archivo que se inyecta. El modo de extensión añade su propia consideración: la IA actúa dentro de un navegador en vivo y ya autenticado, por lo que el agente puede intentar cualquier cosa que pueda hacer esa pestaña. Úselo para tareas en las que ese nivel de acceso sea apropiado y mantenga las pestañas sensibles cerradas.

Lista de verificación para solución de problemas

Si el inicio de sesión se comporta de manera inesperada, siga estos pasos en orden. Lea los argumentos del servidor para --isolated. Verifique si se ha establecido un --user-data-dir personalizado. Asegúrese de estar en el mismo directorio del proyecto que antes, ya que un directorio de trabajo diferente implica un hash diferente y un perfil distinto. Si una prueba necesita un inicio reproducible, cambie al modo aislado e indique el estado de almacenamiento. Si una sesión requiere un paso manual como la autenticación de dos factores, utilice el modo de extensión.

Elegir un modo

  • Investigación o trabajo diario donde la IA controla el navegador: modo persistente. La aislación por proyecto se realiza automáticamente.
  • Reproducir condiciones idénticas en cada ejecución de prueba: modo aislado, con --storage-state si se necesita autenticación.
  • Trabajar a partir del estado de una pestaña ya abierta: modo de extensión.
  • Cambiar entre varios roles nombrados: aún no existe una función oficial; consulte el problema #1530.
  • Una trampa frecuente es usar Playwright MCP en varios proyectos: se inicia sesión en uno y se solicita constantemente iniciar sesión en otro. Eso demuestra que el aislamiento por hash del espacio de trabajo funciona correctamente. Cuando el estado de inicio de sesión parece quedar fijo o desaparecer, lo primero que hay que verificar es el modo.

    La lectura relacionada de la serie original aborda el empaquetado del servidor MCP en Playwright 1.62 y los riesgos de inyección de comandos cuando una IA controla un navegador a través de MCP; ambos temas merecen ser revisados para una configuración segura.