Aller au contenu

Config MCP Playwright

Cette page documente la déclaration du serveur MCP playwright dans le fichier .mcp.json versionné à la racine du dépôt, et la frontière entre pilotage de navigateur et capture vidéo.

Bloc de configuration

Le .mcp.json déclare deux serveurs MCP. Le serveur playwright est ajouté à côté de symfony-ai-mate :

{
    "mcpServers": {
        "symfony-ai-mate": {
            "command": ".devcontainer/mate-mcp.sh"
        },
        "playwright": {
            "command": "npx",
            "args": [
                "@playwright/mcp@latest",
                "--browser",
                "chromium",
                "--executable-path",
                "/usr/bin/chromium"
            ]
        }
    }
}
Champ Valeur Rôle
command npx Lance le paquet MCP sans installation globale.
args[0] @playwright/mcp@latest Le serveur MCP officiel Playwright.
--browser chromium Cible le navigateur Chromium plutôt que le channel chrome.
--executable-path /usr/bin/chromium Binaire système utilisé, au lieu d'un navigateur téléchargé par Playwright.

Rôle : pilotage, pas capture

Le serveur MCP playwright sert au pilotage exploratoire du navigateur depuis Claude Code :

  • browser_navigate — ouvrir une URL ;
  • browser_snapshot — récupérer l'arbre d'accessibilité de la page ;
  • browser_click — interagir avec les éléments ;
  • screenshot et trace pour l'inspection.

@playwright/mcp n'expose aucun flag --save-video : il ne produit donc pas de fichier .mp4. La capture vidéo relève d'un autre outil — le skill /demo-video, qui s'appuie sur l'API recordVideo de Playwright puis sur ffmpeg pour la conversion. Voir Enregistrer une vidéo de démo pour un ticket.

Pourquoi --browser chromium --executable-path /usr/bin/chromium

Sans ces deux arguments, @playwright/mcp cible par défaut le channel chrome, dont le binaire attendu (/opt/google/chrome/chrome) est absent du devcontainer : le serveur MCP ne démarre pas.

Le devcontainer fournit /usr/bin/chromium (version épinglée documentée dans la Référence du Dockerfile multi-stage — Chromium). Comme le CDN de téléchargement des navigateurs Playwright n'est pas whitelisté par le pare-feu interne, on branche explicitement le serveur sur ce binaire système via --executable-path.

Voir aussi