Claude×Playwright複数セッション干渉をChromeプロファイル分離で解決する

Playwright MCPで2つ目のセッションを立ち上げた瞬間、1つ目が固まった——心当たりありませんか？ この干渉問題、原因はChromeプロファイルとポートの共有です。本記事では、Chromeプロファイル分離による解決策をメインに、ポート分離やGit Worktreeなど他の手段もセットで紹介します。設定ファイルのサンプル付きなので、読み終わったらすぐ手元で試せます。

複数セッションで起きる干渉問題とは

Playwright MCPを複数セッション同時に動かすと、ブラウザが排他制御に引っかかって片方が止まります。

「1つ目のセッションでスクレイピング中に、2つ目でフォーム入力しようとしたらブラウザが動かなくなった」——テックビルドの解説記事でもまさにこの現象が報告されています。Playwright MCPを単体で使っている分には気づかない落とし穴です。

干渉するとどうなるか

具体的に起きる症状はこのあたりです。

正直、2セッション目を起動しただけでこれが起きるので、初見だと「Playwright MCPのバグかな？」と疑いたくなります。でもバグじゃないんです。

原因はプロファイルとポートの共有

Playwright MCPはデフォルトで同一のChromeプロファイルディレクトリと同一のデバッグポートを使います。Chromeのプロファイルにはロック機構があるので、2つのプロセスが同時にアクセスすると排他制御が働いて片方がブロックされます。

もう少し噛み砕くと、こういう構図です。

要するに、「1つのブラウザを2人で操縦しようとしている」のが干渉の正体です。解決策は明快——ブラウザ環境を分ければいい。

Chromeプロファイル分離で解決する

一番おすすめの解決策がこれです。Chromeプロファイルをセッションごとに分離すれば、各セッションが独立したブラウザ環境を持つので干渉が起きません。

MCP設定ファイルの書き方

テックビルドの記事を参照しながら、設定の流れを紹介します。@anthropic/playwright-mcpの起動引数でプロファイルパスとポートを分けるのがポイントです。

{
  "mcpServers": {
    "playwright-session-a": {
      "command": "npx",
      "args": [
        "@anthropic/playwright-mcp",
        "--profile", "/tmp/chrome-profiles/session-a",
        "--port", "9222"
      ]
    },
    "playwright-session-b": {
      "command": "npx",
      "args": [
        "@anthropic/playwright-mcp",
        "--profile", "/tmp/chrome-profiles/session-b",
        "--port", "9223"
      ]
    }
  }
}

mkdir -p /tmp/chrome-profiles/session-a
mkdir -p /tmp/chrome-profiles/session-b

プロジェクトレベル設定の追加

チームで開発しているなら、グローバル設定（~/.config/claude/配下）ではなく、プロジェクトルートの.mcp.jsonに書くのがおすすめです。理由はシンプルで、Git管理できるから。プロジェクト固有のプロファイルパスを相対パスで指定すれば、チームメンバーが同じ設定を使えます。

{
  "mcpServers": {
    "playwright-a": {
      "command": "npx",
      "args": [
        "@anthropic/playwright-mcp",
        "--profile", "./.chrome-profiles/a",
        "--port", "9222"
      ]
    }
  }
}

.chrome-profiles/ディレクトリは.gitignoreに追加しておきましょう。キャッシュやCookieをリポジトリに入れるのは事故のもとです。

動作確認と注意点

設定が正しいか、以下のポイントを順に確認してください。見落としがちな項目をまとめました。

他の解決策も知っておこう

プロファイル分離がメインの推奨策ですが、状況によっては別のアプローチも有効です。サクッと紹介します。

ポート分離で対応する方法

プロファイルはデフォルトのまま、CDPポートだけを分ける方法です。--port 9222と--port 9223のように起動引数を変えるだけなので手軽ですが、プロファイルロックの問題は残ります。認証状態も共有されるため、ログイン操作が絡むタスクには向きません。

一方、デメリットは以下です。

Git Worktreeで分離する

プロジェクトディレクトリ自体を分けてしまう方法です。git worktree addでブランチごとに独立した作業ディレクトリを作り、それぞれに.mcp.jsonを置きます。まず以下のコマンドでワークツリーを作成します。

git worktree add ../project-branch-b feature/branch-b

作成された../project-branch-bディレクトリに独自の.mcp.jsonを配置すれば、そのブランチ専用のPlaywright MCPプロファイル・ポート設定を持てます。プロファイル分離と組み合わせることで、「ブランチ単位でブラウザ環境も完全分離」が実現します——セッションが混線する余地がなくなるという意味で、複数ブランチ並行開発においては最も堅牢な構成です。

複数セッション運用のベストプラクティス

日常運用で意識しておくと事故が減るポイントを3つだけ紹介します。

この3つを守れば、Playwright MCP複数セッションの干渉で時間を溶かすことはなくなります。ぜひ設定ファイルの作成から始めてみてください。

あわせて読みたい