# Playwright MCP : Claude Code teste le site sur mobile

> Playwright MCP donne un vrai navigateur à Claude Code : il teste le site sur cinq écrans mobiles et corrige avant que votre client ne l’ouvre.

- Adresse : https://blog.laccelerateuria.com/playwright-mcp
- Rubrique : Construire avec l'IA
- Auteur : Naier Saidane, fondateur de L'Accélérateur IA
- Publié le 22 novembre 2026

Playwright MCP connecte un navigateur réel à Claude Code : il lance le site, ajuste la taille de l’écran, clique et réalise des captures, en autonomie. Votre client, lui, visitera sa plateforme depuis son mobile, non pas via votre moniteur de 27 pouces, et c’est là qu’il verra le bouton devis sortir de l’écran. Grâce à Playwright MCP, Claude Code réalise ce contrôle sur cinq formats de téléphone avant livraison, identifie ce qui casse puis le corrige.

https://www.instagram.com/reel/Df7V7oPMWZC/

## Ce que Playwright MCP donne à Claude Code

Playwright est la bibliothèque de Microsoft qui pilote Chromium, Firefox et WebKit. Son serveur MCP officiel, `@playwright/mcp`, expose ce pilotage à Claude Code sous forme d’outils qu’il appelle quand il en a besoin.

Trois outils font l’essentiel du travail sur mobile :

- `browser_resize` change la largeur et la hauteur de la fenêtre, donc l’écran simulé ;
- `browser_take_screenshot` prend une capture, de l’écran visible ou de la page entière avec `fullPage`, et l’enregistre sous le nom qu’on lui donne ;
- `browser_click` clique sur un élément, par exemple le menu burger, pour voir s’il s’ouvre.

Claude Code ne lit pas seulement l’image. Le serveur lui renvoie aussi l’arbre d’accessibilité de la page : il sait quel bouton porte quel libellé, et il peut cliquer dessus sans deviner des coordonnées.

La différence avec des tests Playwright écrits à la main : vous ne codez pas de scénario. Vous décrivez la vérification en français, Claude Code enchaîne les outils, puis il ouvre les fichiers du projet pour corriger.

## Installer Playwright MCP dans Claude Code

Il faut Node.js 18 ou plus récent. L’installation tient en une commande `claude mcp add`, lancée depuis la racine du projet du client. Elle vient du dépôt officiel [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp).

Ouvrez ensuite une nouvelle session et tapez `/mcp` : le serveur `playwright` doit apparaître comme connecté. Par défaut, le navigateur s’ouvre dans une fenêtre visible, ce qui permet de suivre la passe la première fois. Une option le fait tourner sans fenêtre une fois que vous lui faites confiance.

Le site doit tourner en local (`npm run dev`) ou sur une adresse de préproduction. Évitez de lancer la passe sur le site en production du client : les clics sur les formulaires y envoient de vrais messages.

Si les serveurs MCP sont nouveaux pour vous, [le guide des MCP dans Claude Code](https://blog.laccelerateuria.com/claude-code-mcp) explique comment ils s’ajoutent et se retirent.

## La passe mobile, écran par écran

Un site « responsive » se vérifie rarement au-delà de deux tailles : l’écran du freelance et son propre téléphone. Les défauts se cachent entre les deux, sur les écrans étroits et sur les très grands.

La passe utilise cinq tailles, du petit Android au plus grand iPhone :

| Écran | Largeur × hauteur (px CSS) |
|---|---|
| Petit Android | 360 × 640 |
| Android courant | 360 × 800 |
| iPhone courant | 390 × 844 |
| Grand Android | 412 × 915 |
| Plus grand iPhone | 440 × 956 |

Pour chaque écran et chaque page, Claude Code redimensionne le navigateur, charge la page et prend une capture pleine page, rangée dans `captures/avant/` avec l’écran et la page dans le nom. Un site vitrine de cinq pages donne 25 captures.

Sur un projet client, demandez-lui de **lister avant de corriger**. Il rend un tableau (écran, page, problème, fichier en cause), vous le relisez, puis vous donnez votre accord. Sans cette étape, il peut « corriger » un choix de design que le client a validé.

Après correction, il refait les mêmes captures dans `captures/apres/`, avec les mêmes noms, et confirme que chaque ligne du tableau a disparu. Le prompt complet, avec les cinq tailles et la liste des contrôles, est dans le lead magnet de cet article.

## Ce que la passe attrape, et ce qu’elle ne remplace pas

Les défauts qui reviennent sur un site livré :

- un bouton ou un bloc qui sort de l’écran, avec un défilement horizontal qui fait trembler la page ;
- un menu burger qui ne s’ouvre pas, ou qui ne se referme plus ;
- un titre coupé en plein mot, ou un texte qui passe sous une image ;
- un bouton trop petit pour un doigt, sous 44 px de côté ;
- une image déformée ou qui déborde de sa colonne.

Ce sont des défauts visibles en une seconde par le client, et invisibles sur l’écran où vous avez construit le site.

La passe a ses limites. Le navigateur simule la taille d’un téléphone : il ne reproduit ni le clavier qui pousse un formulaire, ni la barre d’adresse de Safari qui mange une partie de l’écran, ni toutes les manies du vrai Safari sur iPhone. Gardez une vérification sur votre propre téléphone pour la page d’accueil et le formulaire de contact. Quand un correctif résiste, [la méthode de débogage avec Claude Code](https://blog.laccelerateuria.com/debug-claude-code) reprend le problème depuis la cause.

## Ce que vous pouvez vendre avec ça

Pour qui : les artisans, les cabinets et les commerces à qui vous livrez [un site internet](https://blog.laccelerateuria.com/vendre-un-site-internet). Souvent, leurs clients les contactent via le téléphone, Google ou un lien partagé, et se forgent une opinion de l’entreprise à partir de cet écran.

Ce que vous fournissez : une phase « recette mobile » précisée dans le devis, ainsi que le dossier de captures avant / après remis à la livraison. Votre client voit la même page, sur le même écran, avant comme après votre intervention.

Comment le présenter : « Avant de vous remettre le site, je le vérifie sur cinq tailles de téléphone, du petit Android au plus grand iPhone, et je vous donne les captures. » Le dossier devient une preuve de sérieux que vous montrez aussi au prochain prospect, et la même passe se revend à chaque refonte ou ajout de page.
