Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

feat(mcp): add support for PLAYWRIGHT_MCP_EXTENSION environment variable (#39017)

Yury Semikhatsky17b10f78a75e
diff --git a/packages/playwright/src/mcp/browser/config.ts b/packages/playwright/src/mcp/browser/config.ts
index 7c3a628e13..3b1329b4e3 100644
--- a/packages/playwright/src/mcp/browser/config.ts
+++ b/packages/playwright/src/mcp/browser/config.ts
@@ -278,6 +278,7 @@ export function configFromCLIOptions(cliOptions: CLIOptions): Config {
initPage: cliOptions.initPage,
initScript: cliOptions.initScript,
},
+ extension: cliOptions.extension,
server: {
port: cliOptions.port,
host: cliOptions.host,
@@ -328,6 +329,7 @@ function configFromEnv(): Config {
options.consoleLevel = enumParser<'error' | 'warning' | 'info' | 'debug'>('--console-level', ['error', 'warning', 'info', 'debug'], process.env.PLAYWRIGHT_MCP_CONSOLE_LEVEL);
options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);
options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);
+ options.extension = envToBoolean(process.env.PLAYWRIGHT_MCP_EXTENSION);
options.grantPermissions = commaSeparatedList(process.env.PLAYWRIGHT_MCP_GRANT_PERMISSIONS);
options.headless = envToBoolean(process.env.PLAYWRIGHT_MCP_HEADLESS);
options.host = envToString(process.env.PLAYWRIGHT_MCP_HOST);
diff --git a/packages/playwright/src/mcp/config.d.ts b/packages/playwright/src/mcp/config.d.ts
index ca6c49517a..59d1265f8e 100644
--- a/packages/playwright/src/mcp/config.d.ts
+++ b/packages/playwright/src/mcp/config.d.ts
@@ -96,6 +96,13 @@ export type Config = {
initScript?: string[];
},
+ /**
+ * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
+ * config is ignored.
+ * Requires the "Playwright MCP Bridge" browser extension to be installed.
+ */
+ extension?: boolean;
+
server?: {
/**
* The port to listen on for SSE or MCP transport.
diff --git a/packages/playwright/src/mcp/program.ts b/packages/playwright/src/mcp/program.ts
index 67c8234f4c..24f6e59f88 100644
--- a/packages/playwright/src/mcp/program.ts
+++ b/packages/playwright/src/mcp/program.ts
@@ -111,7 +111,7 @@ export function decorateCommand(command: Command, version: string) {
const extensionContextFactory = new ExtensionContextFactory(config.browser.launchOptions.channel || 'chrome', config.browser.userDataDir, config.browser.launchOptions.executablePath);
if (options.daemon) {
- const contextFactory = options.extension ? extensionContextFactory : browserContextFactory;
+ const contextFactory = config.extension ? extensionContextFactory : browserContextFactory;
const serverBackendFactory: mcpServer.ServerBackendFactory = {
name: 'Playwright',
nameInConfig: 'playwright-daemon',
@@ -123,7 +123,7 @@ export function decorateCommand(command: Command, version: string) {
return;
}
- if (options.extension) {
+ if (config.extension) {
const serverBackendFactory: mcpServer.ServerBackendFactory = {
name: 'Playwright w/ extension',
nameInConfig: 'playwright-extension',