Browser Use
既存のChromeセッションに対するブラウザタスクにこれを使用します。
設定修復の詳細はmcporter-config.mdにあります。
ルート
- 現在のセッションでCodexの
ChromeまたはChrome [Internal]プラグインが呼び出し可能な場合、そのバンドルされたChrome制御スキルを使用します。 - それ以外の場合は、以下のmcporter
chrome-devtoolsルートを使用します。
ディスクにバンドルまたはインストールされていても利用可能とは限りません。プラグインはアクティブセッションで呼び出し可能である必要があります。両方のルートでユーザーの既存のChromeプロファイルを使用する必要があります。
mcporterフォールバックには、以下のターゲットを使用します。
mcporter call chrome-devtools.<tool>
ログインが必要なほとんどのサイトは、孤立したプロファイルでは失敗します。新しいセッションではキャプチャ、デバイスチェック、SSO/拡張機能の状態の欠落が発生するためです。ログインが必要なWebサイトでは、既存のChromeプロファイルを強く推奨します。
ユーザーが明示的に孤立した/新しいブラウザを要求しない限り、chrome-isolated、Playwright、Puppeteer、Codexアプリ内ブラウザ、AppleScript、osascript、GUIスクリプティング、macOSのopenをブラウザ制御に使用しないでください。
スクリーンショットやライブUIのバグには、この既存のChromeパスが必要です。curl、ソース検査、Workerスモークテスト、ローカルPlaywrightは補助的な証拠に過ぎません。ユーザーがレンダリングされたブラウザの問題や、ログイン/プロファイル状態に依存する可能性のあるページを示した場合、これらを同等とみなさないでください。
MCPを確認
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pagesはユーザーの実際の開いているタブを表示する必要があります。空の/デフォルトの孤立したChromeが表示された場合は停止し、再アタッチに失敗したと報告してください。
Chromeが認証/アタッチ/更新プロンプトを表示している間に呼び出しがハングしているように見える場合は、フォールバックする前にアタッチアラートを処理してください。表示されているChromeのAllowボタンを押すにはPeekabooを優先し、それ以外の場合は人間が操作するのを待ちます。最初の出力が遅いからといってデーモンを再起動したりMCPプロセスを強制終了したりしないでください。
テスト済みのアタッチプロンプトリカバリー:
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# UIにChromeの「リモートデバッグを許可しますか?」と表示されている場合、表示されている許可ボタンのみをクリックします。
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
現在のPeekabooスナップショットの座標を使用し、古いメモは使用しないでください。成功すると、list_pagesはユーザーの実際のChromeタブを返します。
アタッチアラートのルール: 現在のスナップショットにChromeがDevTools/MCP/ブラウザ自動化アタッチメントを許可するよう求めていることが明確に示されている場合、表示されているAllowボタンを1回クリックし、その後list_pagesを再実行します。ボタンが表示されていないか、プロンプトがあいまいな場合は停止して質問してください。黙ってPlaywright/Puppeteerに切り替えないでください。
list_pagesがDevToolsActivePortで失敗した場合、ユーザーにChromeまたはDevToolsブリッジの再起動を依頼し、その後1回再試行します:
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
それでも失敗する場合は停止し、Chrome DevTools MCPが利用不可であると報告してください。AppleScriptは使用しないでください。
ノイズの多いリカバリループは避けてください。MCP/ブラウザの再起動を繰り返すと、再接続/ログインプロンプトやアラートが発生する可能性があります。1回試行したら一時停止し、より静かなパスを選択してください。
一般的なフロー
# list_pagesからページIDを選択
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# ページを検査
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# 選択したページを移動
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# 最新のスナップショットから要素のUIDをクリック
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# 入力/記入
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text
# JSを実行し、シークレットは出力から除外
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
アクションの前にtake_snapshotを使用し、現在のuid値のみを使用してください。視覚的なレイアウトが重要でない限り、take_screenshotは避けてください。
ライブUIの証明
スクリーンショットの回帰、デプロイされたダッシュボードのチェック、またはレンダリングされたブラウザ自体がバグである場合:
mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json
既存のログイン済み/プロファイル保持タブセットを使用してください。ブラウザ自動化が利用できない場合は、代わりに孤立したブラウザツールを使用するのではなく、検証ギャップとして報告してください。
シークレットの取り扱い
ページDOM、ネットワークログ、または入力からトークン/パスワードを決して出力しないでください。トークンチェックの場合、形状のみを返します: 存在/不在、長さ、ステータスコード、アカウント/組織名。