Playwright Cloud Browsers — Claude Code MCP server setup
Playwright Cloud Browsers is an MCP server for Claude Code that gives coding assistants remote Azure browser sessions to navigate web pages without local browser binaries.
MIT ★ 18 updated 2026-10-27
Open on GitHubWhat Playwright Cloud Browsers does
This remote server exposes cloud-hosted browsers to coding assistants via Streamable HTTP. Agents can spin up clean browser instances, open target URLs, inspect the DOM tree, interact with inputs, and tear down sessions. You do not need to download Chromium or configure test drivers on your host machine.
Setup requires an active Azure subscription, an existing Playwright Workspaces resource ID, and authentication through Microsoft Entra ID. If your Entra identity lacks the appropriate RBAC role on the workspace, session requests will fail.
Microsoft currently marks this remote endpoint as a preview capability, meaning standard production service agreements do not apply.
What it helps with
- interact with web pages from agents without local browser binaries
- run remote Playwright automation flows inside Azure infrastructure
- inspect live DOM trees and element states during agent workflows
- isolate browser execution away from developer workstations
Example prompts for the agent
- Open a browser session, fetch the title from
https://example.com, and shut down the session - Navigate to the staging login page in the cloud browser and verify the header text
- Inspect the checkout form inputs on our demo site using the remote session
How to install Playwright Cloud Browsers
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http playwright-cloud-browsers https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add playwright-cloud-browsers --url https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"playwright-cloud-browsers": {
"url": "https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"playwright-cloud-browsers": {
"type": "http",
"url": "https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http playwright-cloud-browsers https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Playwright Cloud Browsers
How to install Playwright Cloud Browsers in Claude Code?
Run claude mcp add --transport http playwright-cloud-browsers https://{region}.mcp.playwright.microsoft.com/playwrightworkspaces/{workspaceId}/mcp, substituting {region} and {workspaceId} with values from your Azure workspace.
What does Playwright Cloud Browsers do?
It lets coding assistants create, drive, and inspect managed cloud browser sessions over MCP without maintaining local browser engines.
What credentials are required to connect?
You need an Azure subscription, an enabled Playwright workspace, and Microsoft Entra ID authentication with RBAC permissions on that workspace.