MCP 工具与本地 HTTP API

1. check_connection → list_profiles
2. 用准确的 profile_id 调用 open_profile，保留返回的 browser_session_id。
3. 通过 browser_pages 选择准确的 page_id。
4. 用 browser_snapshot 获取新的元素引用和 snapshot_id。
5. 操作时使用同一会话、页面、快照和元素引用；页面变化后重新获取快照。
6. 完成后 release_browser，只有要求关闭环境时才调用 close_profile。

同一环境同一时刻由一个客户端独占控制。ID 是不透明标识，浏览器重启后不能复用。需要登录或人工检查时使用 visible；适合后台运行的任务可选择 headless。

环境与页面

• check_connection
• list_profiles
• open_profile
• close_profile
• release_browser
• browser_pages
• browser_new_page
• browser_close_page
• browser_activate_page

导航与操作

• browser_navigate
• browser_back
• browser_forward
• browser_reload
• browser_snapshot
• browser_click
• browser_click_coordinates
• browser_type
• browser_press
• browser_hover
• browser_select
• browser_scroll
• browser_drag
• browser_wait
• browser_handle_next_dialog

数据与文件

• browser_screenshot
• browser_upload_files
• browser_get_cookies
• browser_set_cookies
• browser_clear_cookies
• browser_storage_get
• browser_storage_set
• browser_storage_clear
• browser_grant_permissions
• browser_prepare_download
• browser_wait_download
• browser_evaluate

此处列出工具名称，不是完整请求参数表。已连接的 MCP 服务会向 AI 客户端提供当前参数和必填字段，请使用服务返回的 schema，不要猜测参数。Cookie、存储、上传和 JavaScript 工具可能访问敏感数据。

仅在本地集成需要 HTTP 时开启 Local API。从 API & MCP 复制当前回环地址和访问令牌，端口动态分配。关闭 HTTP 不影响 MCP。

GET http://127.0.0.1:<port>/v1/status
Authorization: Bearer <access-token>
X-IFox9-Client-ID: my-integration

令牌必填。可选但建议设置客户端 ID，长度为 1–64 个 ASCII 字母、数字、下划线或连字符。示例只有占位符，不要公开真实令牌。

GET /v1/profiles 列出环境；POST /v1/profiles/open 打开环境。成功返回 {"ok":true,"data":…}；失败返回 {"ok":false,"error":{"code":…,"message":…}}。详见常见错误码。

HTTP 监听 127.0.0.1、验证 Host，并且不开放浏览器跨域 CORS。不要通过公网反向代理暴露此接口，也不要公开本地发现文件。轮换令牌后旧凭据失效，请同步更新本地集成。