Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
chore(mcp): --grant-permissions cli option (#37431)
Yury Semikhatskyf07c8c0ac4d0
diff --git a/packages/playwright/src/mcp/browser/config.ts b/packages/playwright/src/mcp/browser/config.tsindex f0c98c6253..1f9f0aa48e 100644--- a/packages/playwright/src/mcp/browser/config.ts+++ b/packages/playwright/src/mcp/browser/config.ts@@ -34,6 +34,7 @@ export type CLIOptions = {config?: string;device?: string;executablePath?: string;+ grantPermissions?: string[];headless?: boolean;host?: string;ignoreHttpsErrors?: boolean;@@ -182,6 +183,9 @@ export function configFromCLIOptions(cliOptions: CLIOptions): Config {if (cliOptions.blockServiceWorkers)contextOptions.serviceWorkers = 'block';+ if (cliOptions.grantPermissions)+ contextOptions.permissions = cliOptions.grantPermissions;+const result: Config = {browser: {browserName,@@ -227,6 +231,7 @@ function configFromEnv(): Config {options.config = envToString(process.env.PLAYWRIGHT_MCP_CONFIG);options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);+ 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);options.ignoreHttpsErrors = envToBoolean(process.env.PLAYWRIGHT_MCP_IGNORE_HTTPS_ERRORS);diff --git a/packages/playwright/src/mcp/program.ts b/packages/playwright/src/mcp/program.tsindex 4a81b873ef..acc349ba00 100644--- a/packages/playwright/src/mcp/program.ts+++ b/packages/playwright/src/mcp/program.ts@@ -39,6 +39,7 @@ export function decorateCommand(command: Command, version: string) {.option('--device <device>', 'device to emulate, for example: "iPhone 15"').option('--executable-path <path>', 'path to the browser executable.').option('--extension', 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.')+ .option('--grant-permissions <permissions...>', 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', commaSeparatedList).option('--headless', 'run browser in headless mode, headed by default').option('--host <host>', 'host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.').option('--ignore-https-errors', 'ignore https errors')diff --git a/tests/mcp/clipboard.spec.ts b/tests/mcp/clipboard.spec.tsnew file mode 100644index 0000000000..264948b924--- /dev/null+++ b/tests/mcp/clipboard.spec.ts@@ -0,0 +1,48 @@+/**+ * Copyright (c) Microsoft Corporation.+ *+ * Licensed under the Apache License, Version 2.0 (the "License");+ * you may not use this file except in compliance with the License.+ * You may obtain a copy of the License at+ *+ * http://www.apache.org/licenses/LICENSE-2.0+ *+ * Unless required by applicable law or agreed to in writing, software+ * distributed under the License is distributed on an "AS IS" BASIS,+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.+ * See the License for the specific language governing permissions and+ * limitations under the License.+ */++import { test, expect } from './fixtures';++test('clipboard write without permission dialog', async ({ startClient, server, mcpBrowser }) => {+ test.skip(mcpBrowser === 'firefox' || mcpBrowser === 'webkit', 'Clipboard permissions are fully supported only in Chromium');+ const { client } = await startClient({+ args: [`--grant-permissions=clipboard-read,clipboard-write`]+ });+ await client.callTool({+ name: 'browser_navigate',+ arguments: { url: server.HELLO_WORLD },+ });+ const writeResult = await client.callTool({+ name: 'browser_evaluate',+ arguments: {+ function: `() => navigator.clipboard.writeText('Hello from Playwright!').then(+ () => 'Write successful',+ e => 'Write failed: ' + e.message)`,+ },+ });+ expect(writeResult).toHaveResponse({+ result: '"Write successful"',+ });+ const readResult = await client.callTool({+ name: 'browser_evaluate',+ arguments: {+ function: `() => navigator.clipboard.readText()`,+ },+ });+ expect(readResult).toHaveResponse({+ result: '"Hello from Playwright!"',+ });+});