🔧

CodexでPlaywright MCPが起動しない？request timed out・program not foundエラーの解決方法

に公開
Chrome
CLI
Playwright
Model Context Protocol
Codex
tech

こんにちは、とまだです。

「Codex CLIでPlaywright MCPサーバーを設定したのに、エラーが出て動かない...」と困っていませんか？

せっかくMCPサーバーを追加したのに、タイムアウトエラーやプログラムが見つからないエラーが出ると、心が折れそうになりますよね。

この記事では、Codex CLIでPlaywright MCPサーバを設定する際によく発生する主要エラーと、その具体的な解決方法の一例を環境別に解説します。

忙しい人のために要約

  • request timed outエラー → Codex CLIアップデート、キャッシュ削除、非公式MCP利用の3段階で対処
  • program not foundエラー（Windows） → npxの絶対パス指定で解決
  • 両エラーとも段階的に試すことが重要
  • 解決しない場合はGitHub Issuesやコミュニティを活用

Playwright MCPサーバーとは？

Playwright MCPサーバーは、ブラウザの自動操作をCodex CLIから実行できるようにするツールです。

Playwrightは、Webページを自動で操作してテストしたり、スクリーンショットを撮影したりできるライブラリです。そして、これをMCP（Model Context Protocol）としてCodex CLIに組み込むことで、コマンドラインから直接ブラウザ操作が可能になります。

ただし、設定する際に環境によってはいくつかのエラーが発生することがあります。

（参考：Playwright MCPサーバの解説）

https://youtu.be/TDECUH62yYQ?si=9BMoMHc_DZIfjOpv

エラー1: request timed out（タイムアウトエラー）

どんな症状？

Playwright MCPサーバーの起動時に、以下のようなエラーメッセージが表示されます。

MCP client for `playwright` failed to start: request timed out

さらに、/mcpコマンドを実行しても、Playwrightのツール一覧が表示されず、(none)と表示される状態になります。

つまり、このエラーは、Codex CLIがPlaywright MCPサーバーとの接続を確立できないときに発生します。

なぜこのエラーが起きるのか？

では、タイムアウトエラーが発生する主な原因を見ていきましょう。主に次の3つが考えられます。

まず、Codex CLI側にバグがある場合があります。
特にWindows環境で報告されていますが、一部のMac環境でも発生することがあります。

次に、以前のインストールやキャッシュが残っていて、新しい設定と競合している可能性があります。

これは、古い設定ファイルが残っていて、新しい設定を読み込めない状態と考えると分かりやすいですね。

そして最後に、複数のユーザーで同じマシンを使用している場合、設定が競合することもあります。

対処法1: Codex CLIをアップデート

まず試すべきは、Codex CLIのアップデートです。

Codex CLIの最新バージョンでは、このバグが修正されている可能性が高いので、、まずは以下のコマンドでアップデートを試してみましょう。

npm install -g @openai/codex@latest

アップデートが完了したら、Codex CLIを再起動して、Playwright MCPが正常に動作するか確認してください。/mcpコマンドでツール一覧が表示されれば成功です。

もしこれで解決しなかった場合は、次の対処法に進みましょう。焦らず1つずつ試していくことが大切です。

対処法2: キャッシュを削除

それでは、アップデートしても解決しない場合の対処法を見ていきましょう。キャッシュが原因かもしれません。

以前のインストールやキャッシュが残っていると、新しい設定が正しく読み込まれないことがあります。

そのため、まずは以下のコマンドでエラーメッセージを確認し、原因を特定しましょう。

npx -y @playwright/mcp@latest --help

このコマンドを実行すると、エラーメッセージが表示される場合があります。

もしキャッシュが原因と判明した場合は、該当するキャッシュディレクトリを削除してから、Codex CLIを再起動してください。

なお、複数のユーザーで同じマシンを使用している場合は、他のユーザーのキャッシュや設定が影響している可能性もあります。

その場合は、各ユーザーのキャッシュディレクトリを確認する必要があります。

まだ解決しない場合は、次の対処法を試してみましょう。

対処法3: 非公式MCPサーバーを試す

公式のPlaywright MCPサーバーでエラーが解消しない場合、最後の手段として非公式のMCPサーバーを試すことができます。

公式ではないため強く推奨はしませんが、同等の機能を提供しているサーバーがあります。

それでは、以下のようにconfig.tomlに設定を追加してください。

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@automatalabs/mcp-server-playwright"]

設定を保存したら、Codex CLIを再起動して動作を確認してください。

ただし、非公式サーバーを使用する際は、自己責任で利用することを忘れないでください。

また、公式サーバーのアップデートで問題が解決する可能性もあるので、定期的に公式サーバーの動作も確認することをおすすめします。

エラー2: program not found（Windows環境）

どんな症状？

Codex CLIでMCPサーバーを追加しようとすると、以下のようなエラーが表示されます。

program not found

また、/mcpコマンドを実行しても、ツールが正しく認識されない状態になります。

このエラーは、主にWindows環境で発生します。

なぜこのエラーが起きるのか？

それでは、このエラーが発生する原因を見ていきましょう。Windows環境では、Codex CLIがnpxコマンドの場所を正しく認識できない場合があります。

これは、環境変数のPATH設定や、npxの実行ファイルの場所が標準的でない場合に発生します。

特に、パスにスペースが含まれる場合（例: C:\Program Files\...）に問題が起きやすくなっています。

解決手順1: npxのフルパスを確認

まず、npxコマンドがどこにあるかを確認します。

PowerShellまたはコマンドプロンプトで、以下のコマンドを実行してください。

where.exe npx

実行すると、以下のような結果が表示されます。

C:\Program Files\nodejs\npx
C:\Program Files\nodejs\npx.cmd

2つのパスが表示される場合は、.cmd拡張子が付いている方を使用してください。この例では、C:\Program Files\nodejs\npx.cmdを使います。

なぜ.cmdが必要かというと、Windows環境ではこの拡張子がないと、実行ファイルとして正しく認識されないためです。

解決手順2: 絶対パスでMCPサーバーを登録

それでは、確認したフルパスを使って、Playwright MCPサーバーを登録します。

以下のコマンドをPowerShellで実行してください。

codex mcp add playwright -- "C:\Program Files\nodejs\npx.cmd" "@playwright/mcp@latest"

ここで重要なのは、以下の3つのポイントです。

まず、パスにスペース（Program Filesなど）が含まれる場合は、必ずダブルクォーテーション（"）で囲んでください。

これにより、スペースを含むパスが正しく認識されます。

次に、.cmdが付いている方のパスを使用することです。先ほど確認したパスをそのまま使いましょう。

そして最後に、コマンドと引数をそれぞれ個別に"で囲むことです。

これにより、それぞれが正しく解釈されます。

成功すると、以下のメッセージが表示されます。

Added global MCP server 'playwright'.

解決手順3: 動作確認

最後に、正しく設定されたか確認しましょう。

Codex CLIを起動してください。

codex

起動したら、以下のコマンドを実行します。

/mcp

成功すると、以下のような表示が出ます。

- playwright
  • Status: enabled
  • Command: C:\Program Files\nodejs\npx.cmd @playwright/mcp@latest
  • Tools: browser_click, browser_close, browser_console_messages, ...

ツール一覧が正しく表示されれば、設定完了です。おめでとうございます！

もし、設定を間違えてしまった場合は、一度MCPサーバーを削除してから再登録できます。

# Playwright MCPサーバーを削除
codex mcp remove playwright

# 正しいコマンドで再登録
codex mcp add playwright -- "C:\Program Files\nodejs\npx.cmd" "@playwright/mcp@latest"

焦らず、1つずつ確認しながら進めましょう。

それでも解決しない場合は？

上記の方法を試してもエラーが解消しない場合は、以下の対応を検討してみてください。

GitHub Issuesで同様の問題を確認

まず、他のユーザーが同じ問題に遭遇していないか確認しましょう。

Codex CLIの公式GitHubリポジトリには、多くのユーザーが報告した問題と解決策が共有されています。

https://github.com/openai/codex/issues

検索機能を使って、「playwright timeout」や「program not found」などのキーワードで探してみてください。既存の解決策や回避策が見つかる可能性があります。

バグレポートの提出

まだ報告されていない問題の場合、開発チームに報告することで修正される可能性があります。

https://github.com/openai/codex/issues

GitHub IssuesからBug Reportを選択して、詳細を記載してください。英語が苦手な場合は、ChatGPTなどを使って翻訳すると良いでしょう。

バグレポートを提出する際は、以下の情報を含めるとスムーズです。

  • 使用しているCodex CLIのバージョン
  • 実行したコマンド
  • 表示されたエラーメッセージ
  • 使用しているOS（Windows、Mac、Linuxなど）

公式アップデートを待つ

Codex CLIは頻繁にアップデートされています。

現在解決できない問題でも、次のバージョンで修正される可能性があります。定期的に以下のコマンドでアップデートを確認してください。

npm install -g @openai/codex@latest

Chrome DevTools MCPを試す

Playwrightが使えなくても、開発自体には大きな支障はありません。

E2Eテストは手動で実行できますし、焦らず対応しましょう。

また、Chrome限定とはなりますが、Playwright MCP以上の機能を持つChrome DevTools MCPを試してみるのも有効です。

こちらの動画で詳しく解説しています。

https://youtu.be/gXwS9dJewrU?si=nHy6vrKfpFXJPYRH

まとめ

Codex CLIでPlaywright MCPサーバーが起動しないエラーについて、2つの主要なエラーと対処法を解説しました。

すぐに解決しなくても、段階的に試していけば、ほとんどの場合は解決できます。

もし、それでも解決しない場合は、GitHub Issuesで同様の問題を確認したり、バグレポートを提出したりすることで、開発チームや他のユーザーからサポートを得られる可能性があります。

トラブルに遭遇したときは、「自分だけじゃない」と思うことも大切です。

コミュニティを活用しながら、一緒に解決していきましょう。

また、私が運営しているコミュニティ「Vibe Coding Studio」で質問を投げていただけると、私を含め誰かが解決策を見つけられるかもしれません。
気軽に質問してください。

https://www.vibecodingstudio.dev/community

参考情報

Discussion