Accueil / Articles

Profils Playwright MCP : pourquoi l’état de connexion persiste ou disparaît.

Explications des profils MCP de Playwright : comment les modes persistant, isolé et d’extension gèrent les cookies et l’état de connexion, comment savoir lequel est en cours d’exécution, ainsi que des notes de sécurité.

Éditeur : REACTAPP.TOP5 min de lecture1232 mots

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

Parfois, Playwright MCP reste connecté lorsqu’une nouvelle session est lancée, sans qu’aucune action ne soit entreprise pour que cela se produise. D’autres fois, sur un site qui a clairement été visité auparavant, l’IA se retrouve face à la page de connexion comme si c’était la première fois. Ce sont deux situations réelles, et sans explication, elles semblent aléatoires : pourquoi se souvient-elle maintenant, et pourquoi oublie-t-elle maintenant ?

Ce comportement n’est pas aléatoire. C’est intentionnel. Playwright MCP dispose d’une configuration appelée profil, et le mode dans lequel il démarre influence la manière dont l’état de connexion est géré. Ce qui suit explique ce mécanisme.

La persistance est la valeur par défaut

En lançant Playwright MCP sans aucune option, le mode profil persistant est activé. Les cookies, localStorage et les tokens d’authentification sont enregistrés dans un répertoire sur le disque. Lorsque la session se termine et que le serveur est redémarré, la prochaine exécution lit toujours ce même emplacement sauvegardé, d’où le fait que l’état de connexion reste présent. C’est la même logique que celle qui fait que Chrome se souvient de votre dernière connexion après un redémarrage.

Le chemin de stockage suit le schéma ms-playwright/mcp-{channel}-{workspace-hash}. Le hash du espace de travail signifie que chaque projet dispose automatiquement de son propre profil. L’état de connexion d’un projet A ne s’infiltre pas dans un projet B, et aucune configuration supplémentaire n’est nécessaire pour cette isolation.

Si vous souhaitez choisir vous-même l’emplacement, surchargez-le avec --user-data-dir. Cela est utile sur une machine partagée où vous voulez que le chemin du profil soit explicite. Ouvrez ce répertoire et vous y trouverez des cookies et des tokens stockés sous forme de fichiers simples.

Un bémol : la documentation indique seulement que l’hash de l’espace de travail est dérivé du répertoire de travail et devient unique pour chaque projet. Elle ne décrit pas l’algorithme d’hashage. Vous n’avez pas besoin des détails techniques. Rappelez-vous le résultat : projet différent, profil différent.

En quoi le mode isolé diffère

En utilisant --isolated, chaque session débute dans un contexte propre et éphémère. En fermant le navigateur, tous les cookies et enregistrements de localStorage de cette session disparaissent.

Cela n’oblige pas à se connecter à nouveau à chaque fois. Avec --storage-state, vous pouvez insérer un état initial provenant d’un fichier JSON préparé à l’avance.

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

Celui-ci est du même type que celui que l’on peut enregistrer avec context.storageState() de Playwright, le mécanisme utilisé pour réutiliser l’état de connexion dans les tests, et il fonctionne tout aussi bien pour démarrer une session MCP déjà authentifiée. « Isolé » ne signifie pas qu’il ne se souvient de rien. Cela veut dire qu’il ne conservera pas automatiquement ses souvenirs entre sessions, bien que vous puissiez lui transmettre un état au début.

Le choix est simple. Si l’IA effectue des tâches de navigateur courantes et que vous souhaitez qu’elle reste connectée la prochaine fois également, optez pour le mode persistant. Si vous avez besoin d’un état vierge identique à chaque exécution, que ce soit pour des tests ou parce que vous ne voulez pas que d’autres sessions influencent le fonctionnement, utilisez le mode isolé et ajoutez --storage-state lorsque l’authentification est requise. En cas de doute, essayez d’abord le mode par défaut. Comprendre son comportement permet de mieux saisir les différences.

Le troisième mode : extension

Le mode persistant et le mode isolé lancent chacun leur propre navigateur. En revanche, le mode extension se connecte à un navigateur déjà ouvert. Il est utile lorsque l’IA doit travailler avec l’état exact d’une page que vous utilisez manuellement, car se connecter à votre navigateur actuel est plus direct que de laisser MCP préparer un profil.

Un bon exemple est un outil interne protégé par une authentification à deux facteurs. Playwright MCP ne peut pas supprimer automatiquement cette authentification, et ce serait préoccupant s’il le pouvait. La solution la plus rapide consiste à se connecter à la page où une personne a déjà terminé de se connecter. Un profil persistant enregistré n’est pas très utile, car une fois la session d’authentification à deux facteurs expirée, il faut se reconnecter manuellement. Le mode extension évite cette étape.

Quel mode est en cours d’exécution ?

Vérifiez la commande de démarrage dans la configuration de votre client, par exemple dans Claude Code. Si --isolated n’est pas parmi les arguments du serveur, c’est que le mode est persistant.

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

Cette configuration est persistante. Ajoutez "--isolated" pour qu’elle devienne isolée. Ajoutez également "--storage-state", "./auth-state.json" pour qu’elle reste isolée dès qu’elle est dans un état authentifié. La lecture des arguments vous le confirmera immédiatement.

Lorsque vous n’êtes pas sûr que l’état soit bien persistant, lisez d’abord le fichier de configuration. Se fier uniquement au comportement est délicat : une connexion réseau lente et une initialisation de profil fraîche peuvent donner le même aspect.

Les sessions nommées ne sont pas encore officielles

Vous vous demandez peut-être s’il est possible de nommer et d’échanger plusieurs états de connexion, comme une session d’administrateur par rapport à une session d’utilisateur ordinaire, à l’aide d’une seule commande. Une demande de fonctionnalité sur les issues GitHub de microsoft/playwright-mcp (#1530) vise précisément cela : créer, enregistrer, restaurer et dupliquer des contextes persistants nommés, afin par exemple de transférer un contexte authentifié entre des agents ou de séparer les rôles d’administrateur et de membre.

À la date de rédaction de ce texte, en août 2026, il s’agit encore d’une demande et non d’une fonctionnalité mise en œuvre. Actuellement, vous travaillez avec les trois modes existants : persistant (isolation par espace de travail), isolé avec état de stockage (état initial explicite) et extension (un navigateur existant). Un paramètre session-id pourrait apparaître ultérieurement, mais ne construisez pas encore de flux de travail autour de lui.

Notes de sécurité concernant l’état stocké

Quel que soit le mode que vous choisissez, rappelez-vous ce que contient le répertoire des profils. Les cookies et les tokens sur le disque constituent des identifiants. Gardez ce répertoire en dehors du contrôle de version, évitez de partager un compte d’ordinateur avec des personnes qui ne devraient pas voir ces sessions, et supprimez un profil lorsque le projet auquel il appartient prend fin. Un fichier JSON représentant l’état de stockage mérite la même attention : il peut permettre à quelqu’un de se connecter sans mot de passe, alors traitez-le comme un secret et ne l’ajoutez jamais aux versions contrôlées.

Le mode isolé réduit le risque de sessions restantes, car rien ne persiste après la fermeture du navigateur, mais il n’élimine pas la nécessité de protéger le fichier que vous injectez. Le mode extension introduit ses propres considérations : l’IA agit à l’intérieur d’un navigateur en ligne déjà authentifié, de sorte que l’agent peut tenter tout ce que la page peut faire. Utilisez-le pour des tâches où ce niveau d’accès est approprié et gardez les onglets sensibles fermés.

Checklist de dépannage

Si la connexion se comporte de manière inattendue, suivez ces étapes dans l’ordre. Lisez les arguments du serveur pour --isolated. Vérifiez s’un répertoire --user-data-dir personnalisé a été défini. Assurez-vous d’être dans le même répertoire de projet qu’auparavant, car un répertoire de travail différent entraîne un hash différent et un profil différent. Si un test nécessite un démarrage reproductible, passez en mode isolé et fournissez l’état de stockage. Si une session exige une action manuelle telle que la vérification à deux facteurs, utilisez le mode extension.

Choix du mode

  • Recherche ou travail quotidien où l’IA pilote le navigateur : mode persistant. L’isolation par projet s’effectue automatiquement.
  • Reproduction de conditions identiques à chaque exécution de test : mode isolé, avec --storage-state si une authentification est nécessaire.
  • Travail à partir de l’état d’une fenêtre déjà ouverte : mode extension.
  • Changer entre plusieurs rôles nommés : aucune fonctionnalité officielle pour l’instant ; suivez l’issue n°1530.
  • Un piège fréquent consiste à utiliser Playwright MCP dans plusieurs projets : on se connecte sur l’un, puis on est constamment invité à se reconnecter sur un autre. C’est là que l’isolation par hash d’espace de travail fonctionne correctement. Lorsque l’état de connexion semble persister ou disparaître, la première chose à vérifier est le mode.

    Des articles connexes de la série originale abordent l’intégration du serveur MCP dans Playwright 1.62 ainsi que les risques d’injection de commandes lorsque une IA contrôle un navigateur via MCP ; tous deux méritent d’être consultés pour une configuration sécurisée.