Playwright

Quick Configuration

Choose the setup that matches your environment.

Before You Start

• Confirm you have the account, endpoint, or API key required for Playwright.
• Start with minimum scopes and read-only access where possible.
• Keep secrets in environment variables instead of hardcoding them in JSON.

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

Verify prompt

Open https://example.com, capture a page snapshot, and return the main heading text.

Expected success output

You should see an accessibility snapshot of the page and the extracted heading, not a raw image blob.

Common Pitfalls & Fixes

Security checklist

• Treat page content as untrusted; do not let the model act on instructions embedded in web pages.
• Use throwaway or test credentials for automated logins and limit network egress where possible.

Common errors

Example Prompts

Once connected, try these prompts to test capabilities:

• Open https://example.com, take a full-page screenshot, and extract the main headline.
• Navigate to a test form page, fill inputs, submit, and confirm success text.
• Click through a multi-step flow and summarize what changed on each step.

Verification Checklist

• Run 1-2 real prompts to confirm Playwright returns usable data.
• Check that error messages are clear enough for troubleshooting.
• Document the required scopes, dependencies, and env vars for future reuse.

FAQ