openwork-docker-chrome-mcp

クイック使用方法（設定済み）

1) 開発スタックを起動する（Docker）

OpenWork リポジトリのルートから実行します：

packaging/docker/dev-up.sh

次の情報が出力されます：

• Web UI の URL（http://localhost:<WEB_PORT>）
• OpenWork サーバーの URL（http://localhost:<OPENWORK_PORT>）
• OPENWORK_TOKEN と OPENWORK_HOST_TOKEN を含むトークンファイルのパス（tmp/.dev-env-<id>）
• このスタックを停止する docker compose ... down コマンド

2) 実際の UI フローを確認する（Chrome MCP）

最低限の確認項目：

1. 出力された Web UI の URL を開きます。
2. セッション／チャット画面に移動します（通常は /session）。
3. メッセージを送信します（例：smoke: hello from chrome mcp）。
4. UI に応答が表示されることを確認します。

Chrome MCP ツールの手順（一般的な例）：

• chrome-devtools_list_pages（任意：既存のタブを確認します）
• Web UI の URL を指定して chrome-devtools_new_page を実行します（ページがすでに開いている場合は chrome-devtools_navigate_page を実行します）
• chrome-devtools_take_snapshot でチャット入力欄と送信ボタンの uid を特定します
• chrome-devtools_fill でチャット入力欄の uid にメッセージを入力します
• chrome-devtools_click で送信ボタンの uid をクリックします
• chrome-devtools_wait_for で応答内の特徴的なテキストを待ちます（または応答が表示されるまで再度スナップショットを取得します）
• chrome-devtools_take_screenshot でスクリーンショットを撮影します（可能な場合は /tmp/...png に保存します）
• デバッグする場合：chrome-devtools_list_console_messages

証跡：

• 応答が表示された後に Chrome MCP のスクリーンショットを撮影します。
• 何かが失敗した場合は、コンソールログと（任意で）Docker ログを記録します。

確認チェックリスト（PR にコピー）

• リポジトリのルートから packaging/docker/dev-up.sh を実行してスタックを起動しました。
• 出力された Web UI の URL を使用しました（推測したポートではありません）。
• UI でユーザーフローを一通り実行しました（入力 → 操作 → 画面上の結果）。
• 成功状態のスクリーンショットを少なくとも 1 枚撮影しました。
• 該当する場合は失敗の証跡（コンソールおよび／または Docker ログ）を記録しました。
• 出力された正確な docker compose -p ... down コマンドでスタックを停止しました。

ユーザー向けの変更で推奨するスクリーンショット一式：

• 操作前の状態。
• 操作中／進行中の状態。
• 成功状態。
• 該当する場合は、失敗または復旧状態。

3) スタックを停止する

dev-up.sh が出力した正確な docker compose -p ... down コマンドを使用します。

コマンドが見つからない場合は、次のコマンドでプロジェクト名を確認できます：

docker ps --format '{{.Names}}' | rg '^openwork-dev-'

その後、スタックを停止します（<project> を置き換えてください）：

docker compose -p <project> -f packaging/docker/docker-compose.dev.yml down

必須の確認事項（必須）

• ユーザー向けの変更、またはリモートの動作に影響する変更は、起動中の UI でエンドツーエンドに検証する必要があります。
• packaging/docker/dev-up.sh で起動した Docker 開発スタックに対して Chrome MCP を使い、変更が正常に動作するまでは、作業は完了ではありません。

よくある注意点

• Docker が必要です（また、docker CLI が PATH 上で使用できる必要があります）。
• dev-up.sh はランダムなホストポートを使用します。5173／8787 と決めつけないでください。
• UI が表示されているのに接続されていない場合は、出力された URL を開いたことと、ヘッドレスモードが正常に動作していることを確認してください。