Playwright Workspaces
✅ Playwright Workspaces is now Generally Available!
Playwright Workspaces is a fully managed service for end-to-end web testing, built on top of Playwright. With Playwright Workspaces, you can significantly speed up test execution by running tests in parallel using managed cloud-based browers. The service takes care of the underlying infrastructure and complexity, allowing you to validate your web app across major browsers on both Linux and Windows—so you can ship features faster and with greater confidence.
👉 Get started with the Quickstart
Documentation
The full documentation is now available on learn.microsoft.com
There you’ll learn how to:
- Run and scale Playwright tests in the cloud
- Optimize test suite performance and reliability
- Test across multiple browsers and operating systems
- Set up secure, region-aware test environments
- Integrate with CI/CD
Playwright Cloud Browsers remote MCP (preview)
The Playwright Cloud Browsers remote MCP server
gives AI agents managed cloud browsers over Streamable HTTP. Agents can create a
browser session, navigate and inspect pages, interact with elements, and close
the session without installing Playwright or a browser locally.
The remote MCP server is in preview, separately from the generally available
Playwright Workspaces service. Preview features do not have a service-level
agreement and are not recommended for production workloads.
Prerequisites and authentication
You need an Azure subscription, a Playwright workspace with access to the remote
MCP preview, its region and workspace ID, and an identity with permission to use
browser sessions in that workspace.
Use the endpoint for your workspace's region:
https://<region>.mcp.playwright.microsoft.com/playwrightworkspaces/<workspace-id>/mcp
Replace both placeholders with your workspace values. Use Microsoft Entra ID
with a client that supports OAuth discovery. The server publishes
protected-resource metadata; your signed-in identity must also have the required
workspace RBAC access. See the authentication and setup guide
for permissions and supported compatibility options. Never commit access tokens
or paste them into prompts.
Connect from VS Code or the GitHub Copilot app
- VS Code: Run MCP: Add Server from the Command Palette, select HTTP,
enter the resolved workspace endpoint, and choose a configuration destination.
Follow the server trust and Microsoft Entra sign-in prompts. See
Add MCP servers in VS Code.
- GitHub Copilot app: Open Customize > MCP, add a custom server using the
resolved workspace endpoint, and follow the supported authentication prompts.
See Configuring MCP servers.
With the server connected, ask the agent to create a browser session, open
https://example.com, report the page's main heading, and close the session,
including on failure. Inspect the actual MCP tool calls and outputs to verify
the connection. See the service guide for session
limits, supported tools, and troubleshooting authentication, timeouts, and
expired sessions. Report service issues through this repository's
issue tracker.
The server is published as com.microsoft/playwright-cloud-browsers in the
Official MCP Registry.
The root server.json is a public copy of the published
metadata. Publication and metadata updates are managed by the service team;
changing this copy does not publish an update or establish a listing in
downstream client catalogs.
Samples
Explore sample projects for different test runners:
Migrating from Microsoft Playwright Testing
Issues
To report a bug, request a feature, or ask for a quote limit increase, please use the Issues section of this repository.
More Resources