Blog › Construire avec l'IA

Construire avec l'IA

Playwright MCP : Claude Code teste le site sur mobile

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.

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 (nouvel onglet).

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 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 :

ÉcranLargeur × hauteur (px CSS)
Petit Android360 × 640
Android courant360 × 800
iPhone courant390 × 844
Grand Android412 × 915
Plus grand iPhone440 × 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 reprend le problème depuis la cause.

Livrer

Ce que vous pouvez vendre avec ça

Pour qui : les artisans, les cabinets et les commerces à qui vous livrez 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.

L'Accélérateur IA

Signez vos 3 premiers clients IA en 180 jours

On rejoint L'Accélérateur IA sur appel d'admission : 45 minutes pour voir si le programme correspond à votre projet. Gratuit et sans engagement.

Réservez votre appel d'admission