跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

WebMCP

最后更新 查看 MarkdownAgent 设置

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 ↗ 中。

快速入门

使用 DevTools 手动测试

1. 启动 Lab 会话并打开 DevTools

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。

2. 与页面交互

你现在可以像在常规浏览器中一样与页面交互。

  1. 前往 WebMCP 文档 ↗ 中列出的网站之一。以下说明基于 L'Atelier Hotel Chain ↗ 演示。
  2. 打开酒店连锁演示 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(确认预订) 后,你将收到确认消息,预订完成。

使用 AI 智能体

1. 配置 Chrome DevTools MCP

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 工具。

2. 与 WebMCP 网站交互

配置完成后,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。

3.(可选)打开 DevTools 观看智能体

某些 WebMCP 工具在完成敏感操作前需要人工确认。例如,complete_booking 会等待你选择 Confirm Reservation(确认预订) 后再完成预订。 要与这些 Human in the Loop(HITL)提示交互,你需要打开浏览器的 Live View。

智能体启动会话后,列出活动会话以获取会话 ID:

wrangler browser list

然后,使用上一步响应中的会话 ID 打开浏览器的 Live View:

wrangler browser view $SESSION_ID

你现在可以查看实时浏览器会话并与之交互。

将 WebMCP 与 Kitesurf 一起使用

Kitesurf 有自己的 WebMCP 实现,不需要 lab 会话。要连接 CDP 客户端,使用此 WebSocket URL:

wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?browser=kitesurf

Kitesurf 还支持声明式表单工具,这些工具使用 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 常见问题与故障排除指南。

这篇文档对您有帮助吗?