Playwright MCP nedir? Yapay zekâ asistanına tarayıcıyı kullandırmak, kurulum, ücret ve güvenlik

Kodlama yapan asistanına bir sayfada yapılacak işi söylersin; Playwright MCP gerçek bir tarayıcıda (Chrome, Firefox, WebKit, Edge) sayfayı açar, gezer, tıklar ve form doldurur. Sayfayı ekran görüntüsü yerine erişilebilirlik ağacı denen yapılandırılmış metin olarak okur. Microsoft'un ücretsiz ve açık kaynak (Apache-2.0) MCP sunucusu; hesap ya da API anahtarı istemez, asistanın MCP ayarına tek bir yapılandırma eklenir. Tarayıcı senin bilgisayarında açılır ve varsayılan olarak girişlerini diske kaydeder. README bunun bir güvenlik sınırı olmadığını açıkça söylüyor.

Ne yapar: Asistana gerçek bir tarayıcıda gezinme ve form doldurma yaptırır
Tür: MCP sunucusu (bilgisayarında çalışır)
Nerede: Claude Code, Claude Desktop, Cursor, VS Code, Codex
Gerekenler: Node.js (README 18+, belge 20+)
Güvenlik: README: güvenlik sınırı değildir
Son sürüm: 0.0.83 (28.09.2026)
Ücret: Ücretsiz, Apache-2.0

Playwright MCP ne işe yarar?

Kodlama asistanı geliştirdiğin siteyi göremezse tahminle çalışır. Playwright MCP asistana gerçek bir tarayıcı verir: siteyi açar, tıklar, form doldurur, konsol hatalarına ve ağ isteklerine bakar. Bir MCP sunucusu, yapay zekâ programlarının dış araçlara bağlanma standardıyla çalışan küçük bir programdır; Playwright ise Microsoft'un tarayıcı test ve otomasyon kütüphanesidir.

SenSayfada yapılacak işi söylersin

AsistanClaude Code, Claude Desktop, Cursor, VS Code, Codex

Playwright MCPBilgisayarında çalışır

TarayıcıChrome, Firefox, WebKit, Edge

Sayfayı erişilebilirlik ağacı olarak okur; girişler varsayılan olarak diske kaydedilir.

Asistana tarayıcıyı kullandırmakNe alırsın: Sayfada yapılan işlemler ve sonuçAyrı kurulum gerekir Sayfadaki hataları incelettirmekNe alırsın: Konsol mesajları, ağ istekleri ve sayfa içeriğiAyrı kurulum gerekir

Asistan sayfayı piksel olarak değil, öğelerin adı, rolü ve metniyle (erişilebilirlik ağacı) okur; bu daha kesindir ve ekran görüntüsünden ucuzdur.

Kime yarar: web sitesi ya da uygulama geliştiren ve Claude Code, Cursor gibi bir asistanla tarayıcıda deneme yaptırmak isteyenlere. Kod yazmıyorsan işine yaramaz.

README'nin kendi karşılaştırması: kodlama ajanları için Playwright CLI ve skill'leri daha az token harcıyor; MCP ise kalıcı durum ve yinelemeli akıl yürütme isteyen özel döngüler için hâlâ anlamlı.

Playwright MCP nasıl kurulur?

Hesap ya da anahtar gerekmez; asistanın MCP ayarına bir yapılandırma eklenir ve ilk çalıştırmada paket npm'den çekilir. README Node.js 18 ya da üstünü, playwright.dev ise 20 ya da üstünü yazıyor; en güvenlisi 20 ve üstü. Komutlar resmî README'den aynen alındı.

Tek komut› claude mcp add playwright npx @playwright/mcp@latest

Kurulduğunu Claude Code'da /mcp yazarak gör.

Çoğu istemcide aynı yapılandırma kullanılır: mcpServers altında playwright adlı bir girdi, command: npx ve args: ["@playwright/mcp@latest"]. Claude Desktop, Gemini CLI ve Windsurf için README kendi MCP belgelerini izleyip bu yapılandırmayı kullanmanı söylüyor.

Cursor: Cursor Settings sonra MCP sonra Add new MCP Server; tür command, komut npx @playwright/mcp@latest.

VS Code› code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Codex› codex mcp add playwright npx "@playwright/mcp@latest"

README ayrıca GitHub Copilot CLI (/mcp add), Amp, Factory, Grok, opencode, Goose, Junie, Cline, Kiro, LM Studio, Qodo Gen, Warp ve Antigravity için kurulum yazıyor.

Chrome Web Store'dan "Playwright Extension"ı kur.
MCP ayarında standart yapılandırmaya --extension bayrağını ekle.
Her bağlantıda onay penceresi çıkar; bu sayede asistan zaten girişli olduğun sekmelerde çalışabilir.

Bu mod asistana girişli oturumlarına erişim verir. Yalnız güvendiğin asistan ve işlerde kullan.

Ayrı HTTP sunucusu› npx @playwright/mcp@latest --port 8931

İstemci yapılandırmasına adres olarak http://localhost:8931/mcp yaz. Docker imajı (mcr.microsoft.com/playwright/mcp) yalnız başsız Chromium destekler.

İzole oturum için ayara --isolated ekle: tarayıcı profili bellekte kalır, girişler diske yazılmaz. Başsız çalıştırmak için --headless yaz.

Playwright MCP nasıl kullanılır?

Kurduktan sonra asistana normal bir istek yazarsın; asistan gerektiğinde tarayıcı araçlarını kendisi kullanır. Varsayılan olarak pencereli bir tarayıcı açılır ve işlemleri izleyebilirsin.

Siteni dene"localhost:3000 adresindeki siteyi tarayıcıda aç, iletişim formunu doldurup gönder ve konsolda hata var mı söyle."

Mobil görünüm"Ana sayfayı mobil ekran boyutunda aç ve taşan ya da kesilen bir öğe var mı kontrol et."

Aynı çalışma klasöründe birden çok istemciden kullanırsan kalıcı profil çakışır ("Browser is already in use"). Ek istemciler için --isolated ya da ayrı bir --user-data-dir ver.

Playwright MCP hangi programlarda çalışır?

Claude CodeVar	README tek satırlık kurulum komutu veriyor.
Claude Desktop, Gemini CLI, WindsurfVar	README standart yapılandırmayı kullanmanı ve istemcinin kendi MCP belgesini izlemeni söylüyor.
Cursor, VS Code, Codex, GitHub Copilot CLIVar	README her biri için kurulum komutu ya da adımı veriyor.
Amp, Factory, Grok, opencode, Goose, Junie, Cline, Kiro, LM Studio, Qodo Gen, Warp, AntigravityVar	Kurulum yolu README'den.
ChatGPT ve claude.ai (uzaktan)Net değil	Sunucu yerel çalışmak üzere tasarlandı; uzaktan kullanımda oturum her araç çağrısından sonra kapanıyor diye kullanıcı bildirimleri var.

"Belgede yok" çalışmaz demek değildir. Liste README'den derlendi.

Playwright MCP neye erişir? Güvenlik

Okur

Açtığı sayfaların içeriği ve ekran görüntüsü, konsol mesajları ve ağ istekleri. İsteğe bağlı olarak çerezleri ve yerel depoyu da okuyabilir. Çalışma klasörü dışındaki dosyalara varsayılan olarak erişmez.

Yazar

Sayfada tıklar, yazar, form doldurur, dosya yükler ve sayfada JavaScript çalıştırır. Bir araç Playwright sunucu sürecinde keyfi kod çalıştırır; README bunu "RCE-equivalent" diye işaretliyor ve yalnız güvenilen istemciler için olduğunu yazıyor.

Girişlerin saklanması

Varsayılan kalıcı profil giriş bilgilerini ve çerezleri bilgisayarındaki profil klasörüne kaydeder; --isolated ile bellekte tutulur. Eklenti modu asistana zaten girişli olduğun sekmeleri açar.

İnternet ve veri

Sunucu yerelde çalışır; tarayıcı gezdiğin sitelere kendisi bağlanır. Sayfadan okunan içerik asistanına, oradan asistanın model sağlayıcısına gider. Ağ gözlem araçları, çerez ve kimlik jetonu içeren istekleri de gösterebilir.

Kayıtlı güvenlik uyarısı

Güncel sürümü etkileyen kayıtlı uyarı görünmüyor; 0.0.40 öncesi için bir DNS rebinding uyarısı (CVE-2025-9611) yayımlanmış ve o sürümde giderilmiş. Bu bir güvenlik sertifikası değil.

README açıkça "Playwright MCP bir güvenlik sınırı değildir" diyor; izin verilen/engellenen adres ayarları da bir güvenlik sınırı sayılmıyor. Güvenmediğin sayfalarda, özellikle girişli oturumlarla ve eklenti modunda dikkatli ol: sayfa içeriği asistana gelir ve içine gizlenmiş talimatlarla yönlendirilebilir.

Playwright MCP ücretsiz mi?

Evet. Playwright MCP ücretsiz ve açık kaynak (Apache-2.0); hesap, abonelik ya da ücretli katman yok. Ticari kullanıma izin verir. Asistanın kendi planı ve kotası ayrıdır.

Yapabilirsin

Ticari kullanım dahil kullanmak, değiştirmek ve dağıtmak (Apache-2.0)

Yasak

Telif ve lisans bildirimini kopyalardan çıkarmak

Kaynak: LICENSE ve npm kaydı. Gezdiğin sitelerin kullanım koşulları ayrı bir konudur. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
"Browser is already in use for mcp-chrome" hatası	Kalıcı profil aynı anda yalnız bir tarayıcı örneğinde kullanılabilir. Ek istemciler için `--isolated` ya da ayrı `--user-data-dir` ver.
Pencereli tarayıcı ekransız sunucuda ya da IDE'nin işçi sürecinde açılmıyor	Sunucuyu ayrı çalıştır (`npx @playwright/mcp@latest --port 8931`) ve istemcide adres ver; ya da `--headless` kullan.
HTTP bağlantısı zaman aşımına uğruyor	playwright.dev: HTTP oturumlarında beş saniyelik kalp atışı zaman aşımı var; `PLAYWRIGHT_MCP_PING_TIMEOUT_MS` değerini artır.
Bir süre sonra tarayıcı kendiliğinden kapanıyor	Başsız tarayıcı bir saat boşta kalınca kapanır, sonraki araç çağrısı yeniden açar; `--idle-timeout` ile ayarlanır.
Kullanıcıların bildirdiği Windows'ta "chrome is not found" hatası	GitHub'da bildirilmiş (issue #13); resmî çözüm yok. README `--browser` ve `--executable-path` seçeneklerini veriyor.
Kullanıcıların bildirdiği Uzaktan (ChatGPT, claude.ai) kullanımda oturum her çağrıdan sonra kapanıyor	GitHub'da bildirilmiş (issue #1045); sunucu yerel kullanım için tasarlandı.

README'de "Browser installation" bölümü boş: ilk çalıştırmada tarayıcının kendiliğinden inip inmediğini resmî kaynak yazmıyor. Tarayıcı bulunamıyorsa Chrome ya da Edge kurulu olsun.

Playwright MCP nasıl kaldırılır?

İstemciden kaldır: MCP ayarındaki "playwright" girdisini sil (Claude Code'da claude mcp remove playwright).
Girişleri temizle: Kalıcı profil girişleri tuttuğu için profil klasörünü sil: Windows'ta %USERPROFILE%\AppData\Local\ms-playwright altındaki mcp-… klasörü; macOS'ta ~/Library/Caches/ms-playwright; Linux'ta ~/.cache/ms-playwright.
Eklenti kullandıysan: Chrome'dan Playwright Extension'ı kaldır ya da eklentinin durum sayfasından bağlantıları kes.

Sık sorulan sorular

Playwright MCP nedir, ne işe yarar?

Yapay zekâ asistanının gerçek bir tarayıcıda sayfa açıp gezmesini, tıklamasını ve form doldurmasını sağlayan Microsoft'un ücretsiz MCP sunucusu. Sayfayı ekran görüntüsü yerine öğelerin adı ve rolüyle (erişilebilirlik ağacı) okur.

Playwright MCP nasıl kurulur?

Claude Code için claude mcp add playwright npx @playwright/mcp@latest yaz. Diğer istemcilerde standart yapılandırma kullanılır: command npx, args @playwright/mcp@latest. Node.js gerekir; README 18, playwright.dev 20 ve üstünü yazıyor.

Playwright MCP hangi programlarda çalışır?

README Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Windsurf, GitHub Copilot CLI ve başka istemciler için kurulum yazıyor. Sunucu yerel kullanım için tasarlandı; uzaktan kullanımda sorun bildirilmiş.

Playwright MCP ile Playwright CLI arasındaki fark ne?

README'nin karşılaştırmasına göre kodlama ajanları için CLI ve skill'ler daha az token harcıyor; MCP ise kalıcı durum ve yinelemeli akıl yürütme isteyen özel döngüler için anlamlı. MCP varsayılan olarak pencereli tarayıcı açar.

Playwright MCP ücretsiz mi, güvenli mi?

Ücretsiz ve açık kaynak (Apache-2.0). Güvenlik için README bunun bir güvenlik sınırı olmadığını yazıyor; güncel sürümü etkileyen kayıtlı uyarı görünmüyor ama bu güvenli olduğu anlamına gelmez.

Playwright MCP giriş bilgilerimi saklar mı?

Varsayılan kalıcı profil girişleri ve çerezleri bilgisayarındaki profil klasörüne kaydeder. --isolated ile bellekte tutulur ve diske yazılmaz. Profil klasörünü silerek girişleri temizleyebilirsin.

Playwright MCP hangi işlerde, hangi setlerde?

Claude Code ile başlangıç

İlgili rehberler

ai-memory awwwards-animations

Kaynaklar

Resmî kaynaklarda net olmayanlar: İlk çalıştırmada tarayıcının kendiliğinden inip inmediği (README'de ilgili bölüm boş) · Node.js 18 mi 20 mi gerektiği (README ve playwright.dev farklı) · sunucunun kendi telemetrisi · Türkçe. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.