WebMCP ↗(Web Model Context Protocol)是一种浏览器 API,让网站为 AI 智能体暴露结构化工具以供直接发现和使用。智能体可以调用 searchFlights() 或 bookTicket() 等网站函数并传入类型化参数,而非缓慢的截图-分析-点击循环,使浏览器自动化更快、更可靠、更不易出错。
Browser Run 通过两种浏览器后端支持 WebMCP:
- Chrome Lab:使用
lab=true、wrangler browser create --lab,或在@cloudflare/puppeteer或@cloudflare/playwright的launch()选项中使用lab: true启动会话。 - Kitesurf:向 CDP WebSocket URL 添加
browser=kitesurf。
页面使用 document.modelContext 注册工具,定义见 WebMCP Community Group 草案 ↗。两种后端都支持 WebMCP CDP 域,CDP 客户端和 Chrome DevTools MCP 使用它列出并运行页面工具。你也可以在 Chrome DevTools 的 Application > WebMCP 面板中运行工具,位于 Lab 会话的 Live View 或 Kitesurf playground ↗ 中。
WebMCP 是实验性 Chrome 功能,因此需要 lab(实验)会话。Browser Run 有一个实验性池,其中浏览器实例启用实验性 Chrome 功能,以便在到达稳定版 Chrome 之前测试新浏览器功能。你在标准池上的生产工作负载仍使用稳定版 Chrome。
Lab 会话为实验性功能,不应用于生产工作负载。
使用新的 wrangler browser 命令获取 lab(实验)浏览器会话:
# 确保已安装最新版本的 wrangler
npm i -g wrangler@latest
# 创建 keep-alive 为 5 分钟的 lab 浏览器会话
wrangler browser create --lab --keepAlive 300它将打开浏览器会话的 Live View。
你现在可以像在常规浏览器中一样与页面交互。
- 前往 WebMCP 文档 ↗ 中列出的网站之一。以下说明基于 L'Atelier Hotel Chain ↗ 演示。
- 打开酒店连锁演示 URL ↗,然后在 Chrome DevTools 中选择 Application > WebMCP。
Available Tools(可用工具) 列表显示页面注册的工具:lookup_amenity、search_location 和 view_hotel。要运行工具,选择它,输入其输入,然后选择 Run tool(运行工具)。Tool Activity(工具活动) 列表显示每次调用的状态、输入和输出。详情请参阅 在 Chrome DevTools 中调试 WebMCP 工具 ↗。
工具列表取决于你访问的网站以及你在页面上执行的操作。
例如,在酒店连锁网站上,使用以下输入执行 search_location 工具后:
{ "query": "Paris" }页面重定向到搜索结果,新的 filter_search_results 工具变为可用。
你可以调用它按设施筛选。例如,如果你想在早上吃到好的可颂:
{ "amenities": ["breakfast"] }你将获得筛选后的结果列表,可以从中选择最适合你需求的选项。选择酒店后,可以使用空输入调用 start_booking 工具:
{}然后,你可以使用 complete_booking 完成预订:
{
"firstName": "James",
"lastName": "Bond",
"email": "[email protected]"
}请注意,complete_booking 工具需要人工确认。该工具会等待你在浏览器中选择 Confirm Reservation(确认预订) 按钮。这是 Human in the Loop(HITL)的示例:WebMCP 工具可以暂停执行并等待用户交互后再完成敏感操作。
选择 Confirm Reservation(确认预订) 后,你将收到确认消息,预订完成。
Chrome DevTools MCP ↗ 允许 AI 智能体通过 CDP 控制浏览器。使用以下设置为 MCP 客户端(如 Claude Desktop、Claude Code、Cursor 或 OpenCode)进行配置。有关 MCP 客户端配置的更多详情,请参阅与 MCP 客户端配合使用。
{
"browser-rendering-cdp": {
"command": [
"npx",
"-y",
"chrome-devtools-mcp@latest",
"--wsEndpoint=wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?keep_alive=600000&lab=true",
"--wsHeaders={\"Authorization\":\"Bearer <CLOUDFLARE_API_TOKEN>\"}",
"--category-experimental-webmcp"
]
}
}将 <ACCOUNT_ID> 替换为你的 Cloudflare 账户 ID,将 <CLOUDFLARE_API_TOKEN> 替换为你的 API token。lab=true 参数确保智能体连接到启用了 WebMCP 的 lab(实验)会话。要改用 Kitesurf,将 keep_alive=600000&lab=true 替换为 browser=kitesurf。Kitesurf 不接受 keep_alive。
--category-experimental-webmcp 标志会向 Chrome DevTools MCP 添加 list_webmcp_tools 和 execute_webmcp_tool 工具。
配置完成后,AI 智能体可以导航到启用了 WebMCP 的网站并使用 WebMCP 工具。以下是对话示例:
你: 前往 https://googlechromelabs.github.io/webmcp-tools/demos/hotel-chain/ ↗ 并为我找一家巴黎有早餐的酒店。有 WebMCP 工具时优先使用。
智能体导航到网站,列出 WebMCP 工具,执行 search_location 并输入 "Paris",然后执行 filter_search_results 并筛选早餐设施,最后呈现结果。
你: 选第一家,为 Bond、James Bond([email protected])预订。
智能体点击酒店,执行 start_booking,然后使用提供的客人信息执行 complete_booking。
某些 WebMCP 工具在完成敏感操作前需要人工确认。例如,complete_booking 会等待你选择 Confirm Reservation(确认预订) 后再完成预订。
要与这些 Human in the Loop(HITL)提示交互,你需要打开浏览器的 Live View。
智能体启动会话后,列出活动会话以获取会话 ID:
wrangler browser list然后,使用上一步响应中的会话 ID 打开浏览器的 Live View:
wrangler browser view $SESSION_ID你现在可以查看实时浏览器会话并与之交互。
Kitesurf 有自己的 WebMCP 实现,不需要 lab 会话。要连接 CDP 客户端,使用此 WebSocket URL:
wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?browser=kitesurfKitesurf 还支持声明式表单工具,这些工具使用 toolname 和 tooldescription 表单属性。
- Lab 会话使用实验性 Chrome 功能,可能存在稳定性问题。
- Kitesurf 未实现 WebMCP
tools权限策略或基于源的工具过滤。 - Kitesurf 不会通过 CDP 暴露在 iframe 或弹出页面中注册的工具。
- Kitesurf 会话不会出现在
wrangler browser list中,也没有 Live View。当智能体将 Chrome DevTools MCP 与 Kitesurf 一起使用时,你无法确认等待用户交互的工具(例如complete_booking)。要确认这些工具,请在 Kitesurf playground ↗ 的 DevTools WebMCP 面板中手动运行它们。 - Lab 会话计入你的常规速率限制和定价。
如有疑问或遇到错误,请参阅 Browser Run 常见问题与故障排除指南。