Playrunner について
Playrunnerは、Playwrightテストを開発チーム、CI、コーディングエージェント向けの再実行可能なワークフローにまとめます。ワークフローの検索と実行に加え、テスト結果、ログ、レポート、ブラウザー生成物を確認できます。
主な機能
- 01Playwrightテストをワークフロー化
- 02プロジェクトの検索とワークフロー作成
- 03実行開始と進行状況の追跡
- 04レポート、ログ、ブラウザー生成物の確認
- 05テストの自動分割とレポート統合
- 06ローカル、クラウド、自社環境での実行
活用シーン
- 01コーディングエージェントでスモークテストを実行・確認
- 02保存済みワークフローをCIで再実行
- 03失敗したテストのログ、トレース、動画を調査
- 04大規模なテストスイートを分割実行
MCP 対応
対応するMCPクライアントからPlayrunner Cloudに接続し、プロジェクト検索、ワークフロー作成、実行開始、結果証拠の確認ができます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://playrunner.cloud/mcpclaude mcp add --transport http dev-playrunner https://playrunner.cloud/mcp{"mcpServers":{"dev-playrunner":{"type":"http","url":"https://playrunner.cloud/mcp"}}}Cursor で開く{"servers":{"dev-playrunner":{"type":"http","url":"https://playrunner.cloud/mcp"}}}VS Code で開く{"mcpServers":{"dev-playrunner":{"type":"http","url":"https://playrunner.cloud/mcp"}}}{"mcpServers":{"dev-playrunner":{"serverUrl":"https://playrunner.cloud/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
AI で構築し、証拠とともにリリースしましょう。
Playrunner は Playwright のテストを再利用可能なワークフローに変えます。
チームも、CI も、コーディングエージェントも実行できます。
「コードが完成しました」から「合格した内容はこちらです」へ。
実際のブラウザチェックを実行し、実行状況を確認しましょう。レポート、トレース、動画を開けます。
Playrunner Cloud を試す → · ローカルで実行 · エージェントを接続 · ドキュメントを読む
1 分で Playrunner を見る
| 製品概要 · 61 秒 | ワークフローと証拠 · 51 秒 |
|---|---|
![]() | ![]() |
| 再利用可能なワークフロー、エージェント接続、シャーディングをナレーション付きで紹介します。 | ローカルで実行したばかりのワークフロー:合格した 2 つのチェック、レポート、スクリーンショットの証拠。 |
2026 年 10 月 19 日に OBS で録画し、AI によるナレーションを付けました。概要動画では 製品の使用例を紹介し、ワークフロー動画では、実際のローカル実行で保存された設定、 合格レポート、スクリーンショットの証拠を確認できます。動画の注記と文字起こし →
エージェントが作成しました。次は確認しましょう。
画面が動いているように見えるのは良い出発点です。結果を確認できる、繰り返し実行可能な テストがあれば、チームはそれを基盤に開発できます。
Playrunner は、AI を活用する開発者とテストチームが Playwright を実行し、 環境やブラウザーのサインイン状態を再利用し、失敗を調査できる共通の場所を提供します。 既存のテストはそのまま使えます。次の変更後も再び実行できるワークフローを加えましょう。
バイブコーダーとお気に入りのエージェント向け
対応している MCP クライアントを Playrunner Cloud に接続して、次のように依頼します。
checkout のスモークワークフローを 1 回実行してください。完了するまで待ち、どの テストが成功または失敗したかを報告し、レポートへのリンクも含めてください。
エージェントは同じ会話の中で、プロジェクトを検出し、ワークフローを作成して実行を開始し、返された証跡を確認できます。保存したワークフローは、チームメイトや CI からも引き続き利用できます。
Codex · Claude · Cursor · Gemini CLI · Antigravity · Grok
接続手順と機能はクライアントによって異なります。リモートの Streamable HTTP と OAuth に対応したクライアント、またはシェルを利用できるエージェントから CLI を使用してください。 接続方法を選択 → MCP ガイドを読む →
テストスイートを繰り返し実行できるチェックに
- テストを用意します。 既存の Playwright リポジトリを使用するか、インラインスクリプトから始めます。
- 実行場所を決めます。 環境と任意の Authentication Profile を選択し、ワークフローの実行場所を指定します。
- 好みの方法で実行します。 ビジュアルエディター、エージェント、CLI、またはスケジュールを使用します。
- 証跡を確認します。 テスト結果、ログ、レポート、実行によって生成されたアーティファクトを確認します。ジョブが開始されたからといって、テストが成功したとは限りません。
Your agent / CI / schedule
↓
Environment → Playwright → Pass or fail → Your next action
↓
Report · traces · screenshots · video

テスト、環境、ランナー、そして次のアクション。すべてをひとつのワークフローで可視化。
テスト基盤の負担を減らし、役立つフィードバックを増やす
| 必要なもの | Playrunner が提供するもの |
|---|---|
| チームが理解できるワークフロー | テスト、条件、分岐、後続アクションを視覚化するキャンバス。 |
| 大規模なスイートからの迅速なフィードバック | キャパシティを考慮した計画による自動シャーディングと、統合レポート。 |
| テストの実行場所を選べること | ローカル Docker、マネージドクラウドランナー、セルフホスト実行。 |
| 失敗を調査する方法 | ノードのライブ状態とログに加え、Playwright レポートと取得したアーティファクト。 |
| サインイン済みで始まるテスト | 環境ごとに分離された、再利用可能な Authentication Profile。 |
| シークレットのコピーを減らすこと | ワークフローから参照できる、管理対象の環境と認証情報。 |
| 役立つ次のアクション | GitHub、Slack、Jira、AI 分析、Webhook などとの連携。 |

4 つのシャード。ひとつの統合レポート。失敗したテストも見逃しません。
CI でも同じワークフローを実行する
保存済みのワークフローを開始して進捗をストリーミングし、ワークフローが失敗、キャンセル、またはタイムアウトした場合は失敗終了コードを返します。
export PLAYRUNNER_URL='https://playrunner.cloud'
export PLAYRUNNER_API_KEY='<your-api-token>'
npx playrunner WORKFLOW_ID
ワークフローをコードとして管理したい場合は、定義をアプリケーションと一緒に保管できます。
npx playrunner workflow create --file playrunner-workflow.json
サインイン済みのブラウザーが必要ですか?Authentication Profile を再利用できます。
ブラウザーセッションを対話形式で取得し、Playwright ノードでプロファイルを選択します。Playrunner は保存済みのセッションを実行時に復元するため、ID プロバイダーのパスワードを保存する必要はありません。
Playrunner Cloud では、認証用コンパニオンを使ってコンピューターをペアリングしてください。
npm install --global playrunner@latest
playrunner login
playrunner auth connect
セッションを取得または更新する間は、コンパニオンを開いたままにしてください。ホストされたワークフローの実行では、コンパニオンが接続されていなくても、暗号化して保存された状態を復元できます。
クイックスタート
前提条件
- Docker Desktop
- Node.js 20+
- npm
ローカルの全スタックを起動する
git clone https://github.com/playrunner/playrunner.git
cd playrunner
./install-local.sh
./start-local.sh
初回実行時、Playrunner にセットアップアプリが表示されます。表示された URL にアクセスし、PostgreSQL を確認して最初の管理者アカウントを作成してください。デフォルトのポートでは、次の URL を使用します。
- Playrunner:
http://127.0.0.1:3100 - セットアップ:
http://127.0.0.1:3100/setup - ドキュメント:
http://127.0.0.1:3104/playrunner/
初回実行前にポートを変更する場合を除き、.env.local ファイルは省略できます。このファイルがない場合、./start-local.sh がサンプルから作成します。手順の全体については、はじめにをご覧ください。
セットアップを再度開く、またはローカルのデフォルト設定を変更する
セットアップウィザードを再度開くには、次のコマンドを実行します。
./start-local.sh --setup
Playrunner でローカルのポートと PostgreSQL のデフォルト設定を再生成する場合は、.env.local も削除してください。
ドキュメントサイトのみを実行する
cd docs
npm run start -- --port 3104
その後、http://127.0.0.1:3104/playrunner/ を開きます。
詳しく見る
| まずはこちら | 内容 |
|---|---|
| 自動シャーディング | テストスイートの検出、処理能力を考慮した計画、レポートの統合 |
| 統合リファレンス | 利用可能なノード、プロバイダー、設定 |
| ランナーのアーキテクチャ | ローカル、マネージド、セルフホスト可能な実行 |
| ワークフローの実行 | API、オーケストレーター、一時的なランナーの連携方法 |
| コントリビューション | ランナー、統合機能、レポート、製品を拡張する方法 |
コントリビューションをお考えですか?パッケージのエンドツーエンドテストを実行してください。
パッケージの E2E テストでは、実際の Vite フロントエンドと Playrunner API を、分離された playrunner_e2e PostgreSQL スキーマに対して実行します。まずローカル環境のセットアップを完了し、apps/api/.env に動作する DATABASE_URL が設定されていることを確認してください。また、PostgreSQL は起動したままにしてください。
新しい開発マシンでは、Chromium を一度インストールします。
npm exec --prefix apps/frontend -- playwright install chromium
決定論的なモックプロバイダースイートを実行します。
npm run test:e2e:mock
Playwright のタグを指定して、統合パッケージを 1 つ実行します。
npm run test:e2e:mock -- --grep @github
npm run test:e2e -- --grep @github
モックモードでも、実際のフロントエンド、認証、API、認証情報の暗号化、データベースを使用します。偽装できるのは、外部プロバイダーとの境界のみです。実際のプロバイダーを使うシナリオはオプトイン方式で、保護された認証情報が必要です。
npm run test:e2e:live
npm run test:e2e:live -- --grep @github
別の PostgreSQL サーバーを使用するには、PLAYRUNNER_E2E_DATABASE_URL を設定します。最新のレポートは npx playwright show-report で開くか、アーキテクチャとパッケージの作成方法についてはテストガイドをご覧ください。
Playrunner の改善にご協力ください
ご自身にとって重要なワークフローで試してみてください。うまくいった点や問題があった点、毎日使いたくなるために必要なことをお聞かせください。
Discord に参加 · 問題を報告 · プロジェクトにスターを付ける
ライセンス
Playrunner はPlayrunner Sustainable Use Licenseに基づいてソースを公開しています。著作権 © 2026 Concept AI PTY LTD。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

