# playwright mcp

Playwright MCPは、Microsoftによる公式のModel Context Protocolサーバーであり、AIエージェントにPlaywrightを使った完全なブラウザ自動化をもたらします。構造化されたアクセシビリティスナップショットを通じて、LLMがWebページをナビゲート、操作、検査できるようにし、視覚モデルは必要ありません。

Canonical URL: https://a2a-mcp.org/entry/playwright-mcp-ja

Language: ja

Category: MCP Servers

Updated: 2026-04-06

## 概要

**Playwright MCP** は Microsoft が開発した公式の **Model Context Protocol (MCP)** サーバーです。信頼性が高く、高速でクロスブラウザ対応のオートメーションライブラリである [Playwright](https://playwright.dev) のすべての機能を、標準化された MCP インターフェースを通じて AI エージェントや LLM に公開します。

スクリーンショットやビジョンモデルに依存する代わりに、Playwright MCP はページの DOM とアクセシビリティツリーの豊富で構造化された **アクセシビリティスナップショット** を提供します。これにより、AI エージェントは決定論的でトークン効率の良い方法で、Web アプリケーションを理解し、ナビゲートし、操作することが可能になります。

Claude Desktop、Cursor、VS Code with GitHub Copilot、Windsurf、およびその他の MCP 互換クライアントとシームレスに統合されます。

## 主な機能

-, **構造化されたアクセシビリティスナップショット**: ピクセルベースのビジョンが不要な、クリーンで階層的なページ構造を返します。
-, **完全なブラウザ制御**: URL へのナビゲート、要素のクリック、テキスト入力、条件の待機、スクロール、フレーム/ポップアップの処理を行います。
-, **JavaScript 評価**: ブラウザコンテキスト内でカスタムスクリプトを実行します。
-, **スクリーンショットと状態検査**: オンデマンドでスクリーンショットをキャプチャしたり、現在のページ状態を要求したりできます。
-, **マルチブラウザサポート**: Chromium、Firefox、および WebKit に対応し、設定可能なオプション (ヘッドレスまたはヘッデッド) を備えています。
-, **永続的なブラウザセッション**: 複雑なマルチステップのワークフローにおいて、複数のツール呼び出しをまたいで状態を維持します。
-, **MCP 標準準拠**: ツール発見をサポートする JSON-RPC ベースで、stdio およびその他のトランスポートに対応します。
-, **エージェント向けに設計**: コンテキストオーバーヘッドを低く保ち、信頼性の高い反復的推論を実現するように最適化されています。

## ユースケース

-, **AI による Web オートメーション**: エージェントにフォーム入力、データスクレイピング、動的 Web サイトでのアクション実行を行わせます。
-, **テストの生成と実行**: AI が実際のアプリケーションを探索しながら、エンドツーエンドのテストを生成・実行します。
-, **デバッグと調査**: バグの再現、UI 状態の検査、または実際のブラウザでの変更の検証を行います。
-, **自律エージェント**: SaaS ツール、E コマースサイト、または社内 Web アプリとやり取りするエージェントを構築します。
-, **自己修復ワークフロー**: エージェントはアクセシビリティツリーのイントロスペクションを使用して UI の変更に適応します。
-, **研究とデータ収集**: 他の MCP サーバー (例: データベースや API ツール) と組み合わせて、エンドツーエンドの自動化を実現します。

## インストールとクイックスタート

### npx を使用する (ほとんどのクライアントに推奨)
```bash
npx @playwright/mcp@latest
```

### 設定例

**Claude Desktop / Claude Code用**:
MCP設定に追加:
```json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
```

**VS Code / Cursor用**:
`mcp.json`または組み込みMCP拡張機能を通じて同様の設定。

**ヘッドレスモード** (サーバー/CI用):
```bash
npx @playwright/mcp@latest --headless
```

完全なセットアップ手順、利用可能なツール一覧、詳細設定（ブラウザ選択、ビューポートなど）については、[公式リポジトリ](https://github.com/microsoft/playwright-mcp)と[Playwrightドキュメント](https://playwright.dev/docs/getting-started-mcp)をご覧ください。

## Playwright MCPの利点

従来のAI向けブラウザ自動化は、脆弱なスクリーンショットやカスタム視覚処理パイプラインに依存することが多かった。Playwright MCPは、Playwrightの実戦で鍛えられたエンジンを活用し、**構造化された意味的なデータ**をモデルに直接提供します。これにより、複雑なWeb UIにおいて、より高い信頼性、低いトークン消費、優れたパフォーマンスが実現されます。

コーディングエージェントとの相性が特に優れており、AIはサイトを探索し、その構造を理解し、テストやコードを生成し、さらには実際のブラウザセッションでアクションの自己検証さえ行うことができます。

## セキュリティとベストプラクティス

- 可能な限り分離された環境またはコンテナで実行してください
- デバッグ時はヘッド付きモード、本番エージェントではヘッドレスモードを使用
- 安全なマルチツールワークフローのために、他のMCPサーバー（例：PostgreSQL MCP）と組み合わせる
- リソースリークを避けるため、長時間実行セッションを監視

## リンク

- GitHub: [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
- 公式ドキュメント: [playwright.dev/docs/getting-started-mcp](https://playwright.dev/docs/getting-started-mcp)
- Playwrightメインサイト: [playwright.dev](https://playwright.dev)

Playwright MCPは、2026年に向けた真に有能なブラウザネイティブAIエージェントへの大きな一歩を表しています。

## Tags

- mcp
- playwright
- ブラウザ自動化
- mcpサーバー
- aiエージェント
- ウェブテスト
- アクセシビリティ
- claude
- cursor
- vscode

## Sources

- [Project website](https://github.com/microsoft/playwright-mcp)