setup-profiles

Setup Playwright Authentication Profiles

Set up persistent Playwright storageState authentication profiles for the current project. This enables authenticated browser automation without logging in every session.

Step 1: Check MCP Configuration

Verify that a Playwright MCP server is configured. Check the project's .mcp.json and the user's global MCP config (~/.claude/settings.json) for a Playwright MCP server entry.

If no Playwright MCP server is configured, guide the user to add one:

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

The Playwright MCP server runs in headed mode by default, which is required for the interactive login flow.

Step 2: Check for Existing Profiles

Check if .playwright/profiles.json already exists in the project root.

If it exists: Read it and present the existing profiles to the user. Ask whether they want to:

• Refresh specific existing profiles (ask which ones)
• Add new profiles
• Refresh all profiles

Then skip to the appropriate step below.

If it does not exist: Proceed to Step 3 for fresh setup.

Step 3: Define Profiles

Ask the user the following questions, one at a time:

1. What user roles/profiles do you need? (e.g., "admin, planner, speaker" or just "user")
2. What is the login URL? Ask per-profile if they might differ, but often all roles share the same login page.
3. Optional: brief description for each role (e.g., "Full admin permissions" or "Can only view assigned decks"). If the user skips this, generate reasonable descriptions based on the role names.

For projects spanning multiple apps, suggest using descriptive prefixed names (e.g., admin-panel-admin, storefront-buyer).

Step 4: Write Configuration

Create the directory structure:

.playwright/
  profiles.json
  profiles/

Write .playwright/profiles.json with the profile definitions. Format:

{
  "profiles": {
    "role-name": {
      "loginUrl": "https://example.com/login",
      "description": "Role description"
    }
  }
}