Playwright MCP：クライアントで最初のブラウザナビゲーションを完了する

誰向けか

このガイドは、すでに MCP クライアントを使っており、このマシンでブラウザを起動してページ自動化を行う準備ができている人向けです。判断すべきなのは、今すぐ Playwright MCP をいまのクライアントにつなぐかどうかであり、長い紹介文として先に読むことではありません。いちばん硬い前提は、このマシンの Node.js が 18 以上であることです。バージョンが足りなければ、設定の記入を続けないでください。リポジトリは、これをブラウザ自動化を提供する MCP サーバーだと説明しており、スクリーンショットではなくアクセシビリティスナップショットでページを理解します。受け入れなければならないことは二つです。このマシンにブラウザ関連プロセスが現れること、そして指定したアドレスへ実際のアクセスが行われることです。リポジトリを眺めるだけで、クライアントにブラウザ操作を一切させたくないなら、この経路は向きません。証拠には適用業種、職種、チーム規模は書かれておらず、ここでも想像上のユーザー像は足しません。

3分で最初の試行を完了する

使うのは公式の標準 MCP 設定、この一本の経路だけです。いま使っている MCP クライアント自身のサーバー設定場所を開いてください。証拠は具体的なファイル名を示していないので、そのクライアントの MCP 設定入口から開けば十分です。名前が playwright のサービスを追加し、コマンドは npx、引数は @playwright/mcp@latest にします。これと並べて第二の主インストール方法を置かないでください。

先にこのマシンが Node.js 18 以上を満たしていることを確認してから、次の JSON を設定へそのまま書き込みます。バイト一致を保ち、キー名も空白も変えないでください：

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

保存したあと、そのクライアントを再起動するか再読み込みします。成功の合図は、ツール一覧に browser_navigate と browser_navigate_back という二つの名前が出ることです。名前が見えて初めて接続できたことになります。ブラウザウィンドウが開いたか、ページが開いたかをインストール完了と見なさないでください。

接続できたあと、試しの呼び出しは一度だけ行います。使うのは browser_navigate です。証拠が記録しているのはツール名だけであり、パラメータ表も、サンプル URL も、取り消し経路もありません。したがって記入内容は、そのときクライアントが表示しているツール説明に従うほかなく、パラメータやエンドポイントを自分で作り出さないでください。この呼び出しは、このマシンのブラウザにあなたが与えたアドレスへアクセスさせ、ネットワークリクエストとページ読み込みを発生させ、このマシンにブラウザ関連プロセスを残します。読み取り専用ではなく、リスクゼロでもありません。呼び出す前に、アドレスはあなた本人が指定したものであり、そのアドレスがアクセスを受け付けられることを確認しなければなりません。呼び出し後は、この呼び出しが返ったかどうかを確認点とします。続けて browser_navigate_back を使う場合も、同様にブラウザの現在ページが変わり、再びネットワークリクエストが発生する可能性があります。呼び出す前に、現在のセッションに戻れる閲覧履歴があることを確認してください。

利用ケース

ケース1：browser_navigate を使って、あなたが明確に指定したページを開きます。タイミングは、二つのツール名がすでに出ており、手元にアクセスを受け付けられるアドレスがあるときです。証拠が対応づけられるのはこのツール名だけであり、見本の URL もなく、パラメータ欄も書かれていません。副作用は実際のナビゲーションとネットワークアクセスです。呼び出す前にアドレスを再度確かめ、呼び出し後はこの呼び出しが終わったかを見てください。ローカルのオフラインプレビューだと理解しないでください。ページ内容が読まれないとも仮定しないでください。

ケース2：browser_navigate_back を使って前のページへ戻ります。タイミングは、同じ閲覧セッションでつい先ほどナビゲーションが完了したときです。証拠はここでもこのツール名だけを示しており、履歴一覧の API も、取り消しや undo の経路もありません。前方へのナビゲーションがまだ成功していなければ、戻りは失敗するか、想定していないページに着く可能性があります。失敗後の状態は証拠に書かれていません。この呼び出しも現在ページを変え、再びネットワークへリクエストする可能性があります。呼び出す前に、実際にナビゲート済みであることを確認してください。確認点は、やはりこの呼び出しが返ったかどうかです。

利用の境界

実行の下限は Node.js 18 以上です。低いバージョンで無理に動かさないでください。能力はブラウザ自動化までであり、スクリーンショットではなくアクセシビリティスナップショットを使うと説明されています。証拠にはスクリーンショット系のツールは出てきません。ブラウザを閉じる、セッションを掃除する、アンインストールする、undo するコマンドもありません。ネットワークなし、このマシンでの読み取りなし、プライバシー境界なし、とは仮定しないでください。ナビゲートした時点で対象サイトは訪問され、ページ内容はクライアントのコンテキストに入る可能性があり、このマシンにもブラウザプロセスが現れます。最初の試行が失敗したときは、まず Node のバージョンと、JSON が公式断片とバイト一致しているかを確かめ、次に二つのツール名が出たかを見てください。証拠に出てこないインストール方法へ切り替えないでください。証拠で名前が挙がっていない能力を、すでに対応済みと考えないでください。