OmochiXを検索

Esc で閉じる

AI開発

Claude Code × Playwright MCP完全ガイド|ブラウザ操作・E2Eテスト・自動QAをAIに任せる【2026年版】

CLAUDE CODE × PLAYWRIGHT MCP Claude Codeに、 「実際にブラウザを使う力」を。 Playwright MCPを使うとClaude CodeはWebページを開き、 ボタンをクリックし、 […]

OmochiX 公開 更新 約11分で読めます
ChatGPT Image 2026年9月14日 00 25
CLAUDE CODE × PLAYWRIGHT MCP

Claude Codeに、
「実際にブラウザを使う力」を。

Playwright MCPを使うとClaude CodeはWebページを開き、 ボタンをクリックし、フォームへ入力し、ログインし、 実装した機能が本当に動くかまで確認できます。 AI開発を「コード生成」から「実動作の検証」へ広げるブラウザ自動化基盤です。

PROVIDER Microsoft
TYPE Browser MCP
ENGINE Playwright
USE CASE E2E / QA / Automation
KEY POINT AIが「コードを直した」で終わらず、「本当に画面で動いた」まで確認できる。

Playwright MCPはブラウザを操作できるため、Claude Codeによる実装後の動作確認まで1つの開発ループへつなげられます。

Playwright MCPとは?

Playwright MCPは、MicrosoftのPlaywrightをModel Context Protocol経由でAIエージェントから利用できるようにするMCPサーバーです。

Claude Code、VS Code、Cursor、WindsurfなどのMCPクライアントから利用できます。

特徴的なのは、ページ操作の中心にアクセシビリティツリーの構造化スナップショットを使うことです。

つまりAIは、スクリーンショットの座標を推測してクリックするのではなく、ページの要素を構造として理解します。

ACCESSIBILITY SNAPSHOT
- heading "ログイン" [level=1]
- textbox "メールアドレス" [ref=e5]
- textbox "パスワード" [ref=e7]
- button "ログイン" [ref=e9]

Claude Codeはこのrefを使って、対象要素へ入力・クリックなどの操作を行います。

OMOCHIX VIEW AIが「画面を見る」のではなく、「画面の構造を読む」。

画像認識に頼らず、要素名や役割を使って操作できるため、ブラウザ自動化をより決定的に行えるのがPlaywright MCPの特徴です。

Playwright MCPでできること

01 / NAVIGATE ページ移動

URLを開く、戻る、タブを切り替えるなどのブラウザ操作。

02 / INTERACTION クリック・入力

ボタン、リンク、フォーム、チェックボックスなどを操作します。

03 / FORM フォーム送信

問い合わせ・ログイン・登録画面などのE2E確認に使えます。

04 / SCREENSHOT スクリーンショット

ページ全体や特定要素のスクリーンショットを取得できます。

05 / STORAGE Cookie・認証状態

ログイン状態やブラウザストレージを保持しながら操作できます。

06 / NETWORK ネットワーク操作

高度な設定ではネットワークモックなども利用できます。

Claude CodeにPlaywright MCPを入れる

Microsoft公式ドキュメントでは、Claude Code向けに次のコマンドが案内されています。

claude mcp add playwright npx @playwright/mcp@latest

標準的なMCP設定では次のようになります。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

現在の公式ドキュメントではNode.js 20以上が前提として案内されています。

初回利用時には必要なブラウザが自動でダウンロードされます。

まず動作確認してみる

接続後はClaude Codeへ自然言語で指示できます。

> http://localhost:3000 を開いてください。

> ログイン画面へ移動してください。

> テストユーザーでログインしてください。

> ダッシュボードが表示されることを確認してください。

Playwright MCPはブラウザを開き、ページ構造を取得し、必要な要素を探して順番に操作します。

AI開発のE2Eループを作る

01
Claude Codeが実装

機能追加やバグ修正を行います。

02
テスト・ビルド

Lint、型チェック、ユニットテストなどを実行。

03
Playwrightが画面確認

実際のブラウザを開いてユーザー操作を再現します。

04
失敗を検出

表示・フォーム・遷移などに問題がないか確認します。

05
Claude Codeが再修正

問題があれば原因を調査して再実装します。

AI DEVELOPMENT LOOP Implement → Test → Browser → Fix → Retest。

これまで人間が行っていた「ブラウザを開いて確認する」工程までAIへ渡せるため、AI開発の自動化範囲が一段広がります。

Vercel Previewとの相性がかなり良い

前回紹介したVercel MCPとPlaywright MCPを組み合わせると、Preview環境での自動QAが可能になります。

01
Claude Code

コードを修正してGitへ反映。

02
Vercel

Preview Deploymentを生成。

03
Playwright

Preview URLを開いてE2E操作。

04
Claude Code

不具合があればコードを再修正。

例えばフォームを自動QAする

問い合わせフォームや申込フォームなら、次のような指示ができます。

> Preview URLを開いてください。

> 問い合わせフォームへ移動してください。

> 必須項目をテストデータで入力してください。

> 送信してください。

> 完了メッセージが表示されることを確認してください。

> 問題があれば原因を調査してください。

AIが「ページが開く」だけでなく、実際のユーザー操作まで確認できるのが大きな違いです。

ログインが必要なサイトも扱える?

Playwright MCPはブラウザセッションを保持できるため、ログイン状態やCookieを継続して利用できます。

デフォルトではセッション間でもログイン状態を保持できる設計になっています。

また、Storage Stateを使って認証状態を保存・再利用する構成も可能です。

SECURITY 本番アカウントではなくQA専用アカウントを使う。

自動操作では誤クリックや意図しない変更の可能性もあるため、Preview環境やテストユーザーを分離した運用がおすすめです。

画面を表示せずに実行することもできる

Playwright MCPはデフォルトではheaded modeでブラウザが表示されます。

ブラウザを表示せず実行する場合は--headlessを利用できます。

npx @playwright/mcp@latest --headless

CIや継続的なQAではheadless運用が便利です。

複数ブラウザにも対応

Playwright MCPは、Chrome系だけでなく複数のブラウザエンジンを扱えます。

BROWSER Chromium / Chrome

Chrome系ブラウザで動作確認。

BROWSER Firefox

Firefox固有の問題を確認できます。

BROWSER WebKit

Safari系エンジンに近い環境で確認。

BROWSER Edge

Microsoft Edgeでの確認にも対応。

スクリーンショットも取得できる

Playwright MCPにはスクリーンショット機能もあります。

ただしMicrosoft公式では、ブラウザ操作そのものについてはスクリーンショットではなく、アクセシビリティスナップショットを利用する設計になっています。

スクリーンショットは、視覚的な最終確認や証跡を残す用途に向いています。

Playwright MCPとPlaywright CLIはどっちがいい?

ここは2026年時点でかなり重要です。

MicrosoftのPlaywright公式ドキュメントでは、MCPに加えてPlaywright CLI + Skillsという方法も案内しています。

AGENTIC BROWSER LOOP Playwright MCP

ブラウザ状態を維持しながら探索・操作を繰り返す用途に向いています。 構造化スナップショットや豊富なツールを使った高度なブラウザ操作が得意です。

CODING AGENT Playwright CLI + Skills

大規模コードベースと同時に扱うコーディングエージェントでは、 MCPよりコンテキスト消費を抑えやすく、高スループットな用途に向いています。

OMOCHIX VIEW 「MCPなら何でも最強」ではない。

Playwright公式自身が、コーディングエージェントではCLI + Skillsの方がトークン効率に優れるケースがあると説明しています。 一方、ブラウザ状態を保ちながら長く操作するエージェントループではMCPが強みを持ちます。

自動ブラウザ操作で注意すること

SECURITY FIRST AIがブラウザを操作できるということは、
本当に「クリックできる」ということ。

管理画面や本番サービスで利用する場合は、 テスト環境・権限・アカウントを明確に分ける必要があります。

01 Preview環境を使う

本番ではなくQA・Preview環境から始める。

02 テストユーザーを分離

本番ユーザーの資格情報を使わない。

03 破壊的操作を避ける

削除・決済・公開などは自動化範囲を慎重に設定する。

04 結果を検証する

成功表示だけでなくDBやログなども確認する。

Vercel・Supabaseと組み合わせる

これまで紹介したMCPと組み合わせると、Web開発のほぼ全工程をAIへ接続できます。

01
Supabase MCP

DB・Auth・ログ・Edge Functionsを確認。

02
Claude Code

コードを実装・修正。

03
Vercel MCP

Preview Deploymentやログを確認。

04
Playwright MCP

実ブラウザでユーザー操作を再現。

05
Claude Code

失敗した場合は原因を特定し再修正。

Playwright MCPでAI開発はどう変わる?

THE NEXT AI QA LOOP AIが「作った」と言うだけではなく、
AI自身が「使って確認する」。

ブラウザ操作までエージェントへ接続されることで、 AI開発はコード生成からQA・回帰テストまで含む工程へ広がります。

これまでAIコーディングで最後に残っていた大きな工程のひとつが、人間による画面確認でした。

Playwright MCPを組み合わせれば、

実装 → デプロイ → ログイン → 操作 → 検証 → 修正 → 再テスト

というループまでAI中心で構築できます。

OMOCHIX VIEW AI開発の完成形に近づく鍵は「QAの自動化」。

コード生成だけを速くしても、確認工程を人間がすべて担当すれば開発速度には限界があります。 ブラウザテストまでAIへ接続することで、本当の意味で開発サイクル全体を短縮できるようになります。

3行まとめ
01
Playwright MCPは、Claude Codeへブラウザ操作能力を追加し、クリック・入力・フォーム・E2E確認などをAIから実行できる。
02
ページ操作にはスクリーンショットではなく構造化アクセシビリティスナップショットを使い、要素参照を利用して操作する。
03
VercelやSupabaseと組み合わせれば、実装→デプロイ→ブラウザQA→修正というAI開発ループを構築できる。

出典:Microsoft Playwright公式「Playwright MCP」「Installation」「Playwright MCP Server」ほか。機能・設定方法は記事執筆時点の情報です。

NEXT STEP

次に知りたいAI情報へ。

自分に合うAIツールを探す 最新のAIニュースをもっと見る

OmochiXをフォロー

最新のAIニュースや活用情報をSNSでも配信しています。