关于 Playwright Cloud Browsers
Playwright Cloud Browsers 是为 AI Agent 提供的托管云浏览器 MCP 服务,可通过远程会话执行网页导航、检查和交互。它通过 Streamable HTTP 连接,无需在本地安装 Playwright 或浏览器;该 MCP 服务仍处于预览阶段。
主要功能
- 01创建和关闭托管浏览器会话
- 02导航并检查网页
- 03与页面元素交互
- 04通过 Streamable HTTP 访问
- 05使用 Microsoft Entra ID 认证
适用场景
- 01让 Agent 打开网页并报告主要标题
- 02在云浏览器中检查页面
- 03让 Agent 与网页元素交互
- 04在无需本地浏览器的环境中运行浏览器任务
MCP 相关
该远程 MCP 服务通过 Streamable HTTP 向 AI Agent 提供托管浏览器会话及网页导航、检查和交互能力。目前处于预览阶段。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcpclaude mcp add --transport http com-microsoft-playwright-cloud-browsers https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp{"mcpServers":{"com-microsoft-playwright-cloud-browsers":{"type":"http","url":"https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"}}}在 Cursor 中打开{"servers":{"com-microsoft-playwright-cloud-browsers":{"type":"http","url":"https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-microsoft-playwright-cloud-browsers":{"type":"http","url":"https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"}}}{"mcpServers":{"com-microsoft-playwright-cloud-browsers":{"serverUrl":"https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Playwright Workspaces
✅ Playwright Workspaces 现已正式发布!
Playwright Workspaces 是一项基于 Playwright 构建的全托管端到端 Web 测试服务。借助 Playwright Workspaces,你可以使用托管的云端浏览器并行运行测试,大幅加快测试执行速度。该服务负责底层基础设施和复杂性,让你能够在 Linux 和 Windows 上的主流浏览器中验证 Web 应用,从而更快地发布功能,并提升信心。
👉 从快速入门开始
文档
完整文档现已发布在 learn.microsoft.com
你可以在其中了解如何:
- 在云端运行和扩展 Playwright 测试
- 优化测试套件的性能和可靠性
- 在多种浏览器和操作系统中进行测试
- 设置安全且具备区域感知能力的测试环境
- 集成 CI/CD
Playwright Cloud Browsers 远程 MCP(预览版)
Playwright Cloud Browsers 远程 MCP 服务 通过 Streamable HTTP 为 AI Agent 提供托管的云端浏览器。Agent 可以创建 浏览器会话、浏览和检查页面、与元素交互,并关闭会话,而无需在本地安装 Playwright 或浏览器。
该远程 MCP 服务目前处于预览版,与已正式发布的 Playwright Workspaces 服务相互独立。预览功能不提供服务级别协议, 不建议用于生产工作负载。
先决条件和身份验证
你需要一个 Azure 订阅、一个有权使用远程 MCP 预览版的 Playwright workspace、其区域和 workspace ID,以及一个有权限在该 workspace 中使用 浏览器会话的身份。
请使用与你的 workspace 区域对应的终结点:
https://<region>.mcp.playwright.microsoft.com/playwrightworkspaces/<workspace-id>/mcp
将两个占位符替换为你的 workspace 值。使用支持 OAuth 发现机制的客户端 通过 Microsoft Entra ID 进行身份验证。该服务会发布受保护资源元数据; 已登录的身份还必须拥有所需的 workspace RBAC 访问权限。有关权限和受支持的 兼容性选项,请参阅身份验证和设置指南。 切勿提交访问令牌,也不要将其粘贴到提示词中。
从 VS Code 或 GitHub Copilot app 连接
- VS Code: 从命令面板运行 MCP: Add Server,选择 HTTP, 输入解析后的 workspace 终结点,并选择配置目标。 按照服务信任和 Microsoft Entra 登录提示操作。请参阅 在 VS Code 中添加 MCP 服务。
- GitHub Copilot app: 打开 Customize > MCP,使用解析后的 workspace 终结点添加自定义服务,并按照支持的身份验证提示操作。 请参阅配置 MCP 服务。
连接服务后,请让 Agent 创建浏览器会话、打开
https://example.com、报告页面的主标题,然后关闭会话,
包括发生故障时也要关闭。检查实际的 MCP 工具调用和输出以验证
连接。有关会话限制、支持的工具,以及身份验证、超时和会话过期的故障排除,
请参阅服务指南。请通过此仓库的
问题跟踪器报告服务问题。
注册表元数据
该服务以 com.microsoft/playwright-cloud-browsers 的名称发布在
Official MCP Registry 中。
根目录下的 server.json 是已发布元数据的公开副本。发布和元数据更新由服务团队管理;
更改此副本不会发布更新,也不会在下游客户端目录中建立条目。
示例
探索适用于不同测试运行器的示例项目:
- 使用 JavaScript/TypeScript 的 Playwright Test
- 使用 C# 的 NUnit
- Python
- Playwright Library 项目
- 使用 Playwright Workspaces Remote MCP 的 Foundry Prompt Agents
- 使用 Playwright Workspaces Remote MCP 的 Foundry Hosted Agents
- 应用验证技能(verify skill)
从 Microsoft Playwright Testing 迁移
问题
如需报告错误、请求功能或申请提高配额限制,请使用此仓库的 Issues 部分。
更多资源
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。