Claude Code의 Playwright MCP, 내 Chrome 프로필 그대로 쓰기

claude plugin list

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--extension"],
      "env": {
        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "여기에-복사한-토큰"
      }
    }
  }
}

# 현재 세션 종료 (Ctrl+C 두 번 또는 /exit)
# 같은 디렉토리에서 다시 실행
claude

# MCP 서버 등록 확인
claude mcp list

# Connect Playwright MCP to Existing Chrome Profile

I want to fix the issue where Playwright MCP launches a fresh Chrome profile every time, which means I can't use my logged-in sessions. Please configure it to connect to my existing Chrome profile via the Chrome Web Store extension method.

## Steps

### Step 1: Guide me to install the Chrome extension

Please ask me the following in Korean:

- Chrome 웹 스토어에서 Playwright MCP Bridge 확장 프로그램을 설치해주세요:
  https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm
- 설치 후 Chrome 툴바의 확장 프로그램 아이콘을 클릭하면 `PLAYWRIGHT_MCP_EXTENSION_TOKEN` 값이 표시됩니다.
- 그 토큰 값을 복사해서 채팅에 붙여넣어 주세요.

**Important: Wait until I provide the token before moving to the next step.** Do not proceed without it.

### Step 2: Detect existing Playwright plugin

Before deciding where to apply the config, check whether a Playwright plugin from the Claude Code plugin marketplace is already installed. This matters because plugin-provided MCP servers take priority over user-defined ones with the same name, which would cause the new config to be silently ignored.

Run the following to detect installed plugins:

```bash
claude plugin list
```

Look for any plugin named `playwright` (typically from `claude-plugins-official` marketplace).

Branch based on the result:

#### Case A: Playwright plugin is already installed

Inform me in Korean:

> Playwright 플러그인이 이미 설치되어 있어서, 사용자 설정(`~/.claude.json` 또는 `.mcp.json`)에 같은 이름으로 추가하면 플러그인 설정에 가려져 적용되지 않습니다. 따라서 **플러그인의 `.mcp.json`을 직접 수정**하는 방식으로 진행하겠습니다.

Then:

1. Locate the plugin's `.mcp.json`. Typically under `~/.claude/plugins/` or similar — find the actual path on this machine.
2. Show me the current content and ask for confirmation before editing.
3. Modify the `playwright` entry to add `--extension` to args and the `PLAYWRIGHT_MCP_EXTENSION_TOKEN` env var while preserving any other existing settings.

Resulting config should look like:
```json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--extension"],
      "env": {
        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<token-I-provided>"
      }
    }
  }
}
```

Also warn me in Korean:

> ⚠️ 플러그인이 업데이트되거나 재설치되면 이 변경 사항이 사라질 수 있습니다. 그 경우 이 프롬프트를 다시 실행하면 됩니다.

Skip Step 3 (which is for non-plugin installs) and go directly to Step 4.

#### Case B: Playwright plugin is NOT installed

Ask me in Korean:

> Playwright MCP를 설치하는 방법은 두 가지입니다. 어느 쪽으로 진행할까요?
>
> 1. **공식 플러그인 설치**: `claude-plugins-official` 마켓플레이스의 playwright 플러그인을 설치합니다. 플러그인 시스템으로 자동 업데이트가 가능합니다.
> 2. **사용자 설정으로 직접 추가**: 플러그인 없이 `~/.claude.json` 또는 프로젝트의 `.mcp.json`에 직접 MCP 설정을 추가합니다. dotfiles 등으로 관리하기 쉽습니다.

Wait for my answer.

- If I choose option 1: guide me through installing the plugin first (e.g., via `/plugin` or the appropriate command), then once installed, treat it as Case A and modify the plugin's `.mcp.json`.
- If I choose option 2: proceed to Step 3.

### Step 3: Ask me where to apply the config (only for Case B option 2)

Ask me in Korean which location to add the MCP config to:

- **프로젝트 단위 설정**: 현재 프로젝트 루트의 `.mcp.json`에 추가 (해당 프로젝트에서만 사용)
- **사용자 글로벌 설정**: `~/.claude.json`에 추가 (모든 프로젝트에서 사용)

Wait for my answer, then add or update the config in that file:

- If the file does not exist, create it.
- If it exists, read the current contents and add a `playwright` entry under `mcpServers`, or overwrite it if one already exists.
- Leave any other MCP server configs untouched.

Config to add:
```json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--extension"],
      "env": {
        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<token-I-provided>"
      }
    }
  }
}
```

After applying, verify the file is valid JSON.

### Step 4: Restart Claude Code

Tell me in Korean to restart Claude Code so the config takes effect:

- 현재 Claude Code 세션을 종료한 뒤(`Ctrl+C` 두 번 또는 `/exit` 입력), 동일한 디렉토리에서 다시 실행해주세요:
  ```bash
  claude
  ```
- 재시작 후 MCP 서버가 정상 등록되었는지 확인하려면:
  ```bash
  claude mcp list
  ```
  목록에 `playwright`가 보이면 정상입니다.

Then ask me explicitly: **"재시작 하셨나요? 완료하셨다면 알려주세요."**

Wait for my confirmation before proceeding to Step 5.

### Step 5: Verify Playwright actually opens

Once I confirm the restart, walk me through a verification flow in Korean:

1. 평소 사용하는 Chrome 프로필이 열려 있는지 확인해주세요. (열려있지 않다면 먼저 열어주세요.)
2. 다음과 같이 간단한 테스트 명령을 내려달라고 안내해주세요:
   > "Playwright로 https://github.com 페이지를 열어서 제목을 알려줘"
3. 명령 실행 시 다음 흐름이 나타나는지 확인해주세요:
   - 첫 호출이라면 어느 탭에 연결할지 선택하는 페이지가 Chrome에 뜸
   - 작업할 탭을 선택하면 해당 탭에서 페이지 이동이 일어남
   - 새 Chrome 창이 따로 뜨지 않고, 평소 쓰던 프로필 안에서 동작함
4. 만약 새 Chrome 창이 따로 열린다면 확장 프로그램이 제대로 인식되지 않은 것이므로:
   - Chrome 확장 프로그램 페이지(`chrome://extensions`)에서 Playwright MCP Bridge가 활성화되어 있는지 확인
   - 토큰 값이 설정 파일에 정확히 들어갔는지 확인
   - 실제 실행 중인 MCP 프로세스가 어떤 설정 파일에서 시작되었는지 확인 (플러그인 vs 사용자 설정)
   - Claude Code를 다시 한 번 재시작

If anything fails, help me debug based on the symptom.

### Step 6: Final notes

Once verification succeeds, share the following with me in Korean:

- 사용 시에는 평소 쓰던 Chrome 프로필이 열려 있는 상태여야 합니다.
- 처음 Playwright MCP를 호출하면 어느 탭에 연결할지 선택하는 페이지가 뜹니다. 작업하려는 탭을 선택하세요.
- SSO/2FA가 필요한 사내 시스템도 이미 로그인된 세션을 그대로 활용할 수 있습니다.

## Ground rules

- Do not move to the next step until I respond.
- The token, plugin choice, and config location must come from me directly.
- All user-facing messages (questions, instructions, final notes) must be in Korean. Internal reasoning and tool usage can be in English.
- When a Playwright plugin is detected, prefer modifying its config directly to avoid the silent override problem caused by name collision.