OpenCode Browse 設定：配對瀏覽器、限制網站與接手登入
本文目錄
用 OpenCode Browse 測試登入後的頁面時，可以把指定分頁交給 agent，遇到登入或雙重驗證再由你接手。第一次試用，建議用專用的瀏覽器設定檔、測試帳號和單一網站。先驗收 agent 能操作哪個分頁、可以導覽到哪裡，最後再確認如何收回權限。
只配對這次要用的設定檔
Browse 由 MCP server、本機 relay 與 Chromium 擴充功能組成。依 v0.0.14 README，使用 npm 路徑需要 Node.js 22.19 以上。以下以這個版本為準，從終端機啟動安裝流程。安裝器會詢問要寫入哪些 MCP client 的設定，然後引導你在目標瀏覽器安裝擴充功能。 Browse v0.0.14 安裝說明
node --versionnpx @opencode/browse@0.0.14 install安裝後先核對 client 裡是否出現 browse 工具。若擴充功能還沒配對，執行 npx @opencode/browse@0.0.14 pair，到目標設定檔的擴充功能選項輸入一次性配對碼。pair --list 可列出已配對的瀏覽器，方便檢查是否選到了平常工作的設定檔。這一步建立的是擴充功能與 relay 的連線，接下來才由你決定要交給 agent 的分頁。
網站 allowlist 限制頁面導覽
在本機終端機建立具名工作階段。範例用公開測試網域，正式驗收時請換成自己的測試環境，並確認 MCP client 使用同一個工作階段。
npx @opencode/browse@0.0.14 session new smoke-test --allow-origin example.comnpx @opencode/browse@0.0.14 session list也可以在 MCP 的 session_new 設 allowedOrigins，或用 session_allowlist 調整。依官方說明，清單限制分頁導覽，包括離開允許範圍的重新導向；圖片、fetch、iframe、worker 等子資源請求仍可發出。若測試要求所有流量只能到指定主機，還要在瀏覽器或網路環境另外驗證出站限制。若測試站登入會跳到外部身分供應商，先確認允許的主機與實際登入流程，再決定要加入哪個網域。 Browse v0.0.14 安全說明
用一次受控登入驗收分頁與交接
- 在設定檔中打開兩個不含敏感資料的分頁，只借出一個。要求 agent 列出該工作階段能用的分頁，確認另一個分頁未出現。
- 在公開範例工作階段要求開啟
example.com，再要求導覽到未列入清單的example.org。預期前者可開啟、後者遭阻擋。改用自己的測試站時，重跑一次真實登入的重新導向路徑。 - 在測試帳號的登入頁讓 agent 發出 handoff。由你在瀏覽器完成登入，核對目前站點與分頁後再按 Continue。確認恢復後的第一個動作是讀取預先指定的測試畫面。
- 要結束瀏覽器與 relay 的配對，用
pair --list查識別值，再執行npx @opencode/browse@0.0.14 pair --revoke <browser>，把<browser>換成查到的值。再列一次清單，確認該項已消失。
這份流程依 v0.0.14 文件設計，需在讀者自己的測試設定檔跑完才算通過。若目標只是為 CI 查瀏覽器版本與隔離設定，可用 Playwright 的瀏覽器與 sandbox 檢查 釐清另一條啟動路徑。
參考資料：