Playwright MCP-server: laat een assistent een echte browser besturen
Playwright MCP-server: gids en config-builder
Playwright MCP-server: installatie, opties en tools | We.Inc
Wat de Playwright MCP-server doet, hoe toegankelijkheidssnapshots werken, welke opties het instellen waard zijn, de kerntools en een builder die de config voor u schrijft.
Playwright MCP is de opensource MCP-server van Microsoft die een AI-assistent een echte browser geeft om te klikken, te typen, formulieren in te vullen en pagina's te lezen. In plaats van naar screenshots te kijken, leest hij de toegankelijkheidsboom van de pagina, een gestructureerde lijst van knoppen, links en tekst. Hij heeft Node.js 18 of nieuwer nodig en installeert met één npx-regel.
Playwright MCP in het kort
Onderdeel
Waarde
npm-pakket
@playwright/mcp
Vereiste
Node.js 18 of nieuwer
Hoe hij pagina's ziet
Toegankelijkheidssnapshots, geen pixels
Browsers
chrome, firefox, webkit, msedge
Standaardvenster
Headed (zichtbaar); voeg --headless toe om het te verbergen
Hebt u een website of webwinkel, dan is Playwright MCP een praktische manier om een assistent door uw eigen pagina's te laten lopen zoals een klant dat zou doen: het menu openen, iets in de winkelwagen leggen, het contactformulier versturen en melden wat er misging. Het is gebouwd op Playwright, een veelgebruikte bibliotheek voor browsertests. Kies hieronder uw opties en kopieer een config, en lees de veiligheidsnotities voordat u hem op iets ingelogds loslaat.
Kies een browser en of het venster zichtbaar of headless moet zijn.
Zet de geïsoleerde modus aan als elke sessie schoon moet beginnen, zonder dat er iets naar schijf wordt opgeslagen.
Voeg extra groepen mogelijkheden toe die u nodig hebt, zoals PDF's opslaan of testasserties.
Kopieer de JSON naar de config van uw MCP-app en start die opnieuw. Bij de eerste keer wordt het pakket gedownload.
Test op een stagingkopie of een testaccount, niet met uw live beheerderslogin.
Gebruik --isolated voor testruns, zodat cookies van de ene sessie nooit in de volgende terechtkomen.
Vraag om een snapshot voordat u om klikken vraagt: de assistent kiest elementen uit die lijst.
Geef exacte stappen ("open /pricing, klik op het tweede abonnement, meld het totaal") in plaats van vage doelen.
Houd browser_run_code_unsafe in gedachten: die voert willekeurige Playwright-code uit, dus gebruik hem alleen met prompts die u vertrouwt.
Veelgestelde vragen
Wat is een toegankelijkheidssnapshot?
Browsers houden een toegankelijkheidsboom bij, dezelfde gestructureerde weergave die schermlezers gebruiken: elke knop, link, kop en elk veld met naam en rol. Playwright MCP geeft de assistent die boom, zodat hij kan zeggen "klik op de knop In winkelwagen" zonder te gokken op basis van een afbeelding.
Is Playwright MCP een beveiligingsgrens?
Nee, en de README zegt dat vetgedrukt. Opties zoals --allowed-origins en --blocked-origins worden ook uitdrukkelijk geen beveiligingsgrens genoemd. Behandel het als een tool waar u toezicht op houdt, en draai het waar een fout geen echte klantgegevens kan raken.
Onthoudt hij logins tussen sessies?
Standaard gebruikt hij een persistent profiel, dus logins worden net als in een gewone browser op schijf bewaard. Met --isolated staat het profiel in het geheugen en is het weg zodra de browser sluit. Met --storage-state kunt u cookies vooraf laden in een geïsoleerde sessie.
Kan hij screenshots maken of PDF's opslaan?
browser_take_screenshot is een kerntool. PDF's opslaan (browser_pdf_save) zet u aan met --caps=pdf, en tools die op coördinaten klikken hebben --caps=vision nodig.
Moet ik Playwright MCP of de Playwright CLI gebruiken?
De README geeft aan dat coding agents beter af kunnen zijn met de aparte Playwright CLI, die minder tokens gebruikt. MCP blijft dan voor langere verkennende sessies waarin het openhouden van de browserstatus die kosten waard is.
Persistent, geïsoleerd of uw eigen browser
Playwright MCP kan op drie manieren draaien. Het standaard persistente profiel bewaart cookies en logins in een map per project. De geïsoleerde modus houdt alles in het geheugen, wat goed past bij herhaalbare tests. De modus met browserextensie koppelt aan een Chrome- of Edge-venster dat u al open hebt, wat handig is maar betekent dat de assistent met uw echte logins handelt.
Er kan maar één browser tegelijk een persistent profiel gebruiken. Draait u twee assistentsessies op hetzelfde project, start de tweede dan met --isolated of een andere --user-data-dir.
Goede taken voor hem op uw eigen site
Controleren of elke link in het hoofdmenu een pagina opent die laadt. Het contactformulier invullen met testgegevens en bevestigen dat de bedankmelding verschijnt. De consoleberichten lezen op een pagina die traag lijkt. Verkleinen tot telefoonbreedte en alles opsommen wat buiten beeld loopt.
Schrijf de resultaten op als checklist die u na elke wijziging kunt herhalen, zodat de run van de assistent uw regressietest wordt.
Opties die het kennen waard zijn
Elke optie heeft ook een vorm als omgevingsvariabele, vermeld in de README.
Een selectie van Playwright MCP-opties
Optie
Wat het doet
--browser <browser>
chrome, firefox, webkit of msedge
--headless
Draait zonder zichtbaar venster; headed is de standaard
--isolated
Houdt het browserprofiel in het geheugen, niet op schijf
--storage-state <path>
Laadt cookies en local storage in een geïsoleerde sessie
--device <device>
Emuleert een apparaat, bijvoorbeeld "iPhone 15"
--viewport-size <size>
Stelt de viewport in pixels in, bijvoorbeeld "1280x720"
--caps <caps>
Zet extra toolgroepen aan, zoals pdf of vision
--allowed-origins / --blocked-origins
Origins van verzoeken toestaan of blokkeren; geen beveiligingsgrens
--timeout-action / --timeout-navigation
Standaard 5000 ms en 60000 ms
--port <port>
Serveert via HTTP zodat een client via een URL kan verbinden
Kerntools
Kerntools van Playwright MCP
Tool
Doel
Alleen-lezen
Een URL openen
Nee
De toegankelijkheidssnapshot van de pagina vastleggen
Ja
Op een element klikken
Nee
In een veld typen
Nee
Meerdere velden tegelijk invullen
Nee
Een screenshot opslaan
Ja
Consoleberichten lezen
Ja
Netwerkverzoeken opsommen
Ja
Het venster van grootte veranderen
Nee
Playwright-code uitvoeren
Nee
Configvoorbeelden
Standaardconfig
De minimale configuratie die de README voor de meeste MCP-apps geeft.
Als HTTP-server draaien en via een URL verbinden
Handig als de app zelf geen venster kan openen. De client wijst dan naar http://localhost:8931/mcp.
Config-builder voor Playwright MCP
Kies opties en kopieer de JSON. Deze pagina schrijft alleen tekst; er wordt geen browser gestart.
Browser
Headless (geen zichtbaar venster)
Geïsoleerd profiel (niets opgeslagen op schijf)
Viewportgrootte, bijvoorbeeld 1280x720 (optioneel)
Extra groepen mogelijkheden
Config-JSON
De viewport moet eruitzien als 1280x720 (breedte x hoogte in pixels). Hij is weggelaten.