Playwright MCP

Amp VS Code 확장 설정 화면에서 추가하거나 settings.json 파일을 업데이트하여 추가합니다:

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

Amp CLI 설정:

아래 amp mcp add 명령을 통해 추가합니다

amp mcp add playwright -- npx @playwright/mcp@latest

Antigravity 설정에서 추가하거나 구성 파일을 업데이트하여 추가합니다:

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

Claude Code CLI를 사용하여 Playwright MCP 서버를 추가합니다:

claude mcp add playwright npx @playwright/mcp@latest

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다.

MCP 서버 구성 섹션의 지침을 따릅니다.

예: 로컬 설정

cline_mcp_settings.json 파일에 다음을 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

Codex CLI를 사용하여 Playwright MCP 서버를 추가합니다:

codex mcp add playwright npx "@playwright/mcp@latest"

또는 구성 파일 ~/.codex/config.toml을 생성하거나 편집하고 다음을 추가합니다:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

자세한 내용은 Codex MCP 문서를 참조하세요.

Copilot CLI를 사용하여 대화형으로 Playwright MCP 서버를 추가합니다:

/mcp add

또는 구성 파일 ~/.copilot/mcp-config.json을 생성하거나 편집하고 다음을 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "tools": [
        "*"
      ],
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

자세한 내용은 Copilot CLI 문서를 참조하세요.

버튼을 클릭하여 설치:

또는 수동으로 설치:

Cursor Settings -> MCP -> Add new MCP Server로 이동합니다. 원하는 이름을 지정하고, command 유형과 npx @playwright/mcp@latest 명령을 사용합니다. Edit을 클릭하여 구성을 확인하거나 인수와 같은 명령을 추가할 수도 있습니다.

Factory CLI를 사용하여 Playwright MCP 서버를 추가합니다:

droid mcp add playwright "npx @playwright/mcp@latest"

또는 Factory droid 내에서 /mcp을 입력하여 MCP 서버를 관리하는 대화형 UI를 엽니다.

자세한 내용은 Factory MCP 문서를 참조하세요.

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다.

버튼을 클릭하여 설치:

또는 수동으로 설치:

Advanced settings -> Extensions -> Add custom extension로 이동합니다. 원하는 이름을 지정하고, STDIO 유형을 사용하고, command을 npx @playwright/mcp로 설정합니다. "Add Extension"을 클릭합니다.

Grok CLI를 사용하여 Playwright MCP 서버를 추가합니다:

grok mcp add playwright -- npx @playwright/mcp@latest

또는 구성 파일 ~/.grok/config.toml을 생성하거나 편집하고 다음을 추가합니다:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

자세한 내용은 Grok MCP 문서를 참조하세요.

Junie CLI에서 Playwright MCP 서버를 추가하려면:

1. /mcp을 입력합니다
2. Ctrl+A을 눌러 새 MCP 서버를 추가합니다
3. 목록에서 Playwright를 선택합니다

또는 .junie/mcp/mcp.json에 추가합니다:

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

자세한 내용은 Junie MCP 구성 문서를 참조하세요.

MCP 서버 문서를 따릅니다. 예를 들어 .kiro/settings/mcp.json에서:

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

버튼을 클릭하여 설치:

또는 수동으로 설치:

오른쪽 사이드바의 Program -> Install -> Edit mcp.json로 이동합니다. 위의 표준 구성을 사용합니다.

MCP 서버 문서를 따릅니다. 예를 들어 ~/.config/opencode/opencode.json에서:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

VSCode 또는 IntelliJ에서 Qodo Gen 채팅 패널을 엽니다 → Connect more tools → + Add new MCP → 위의 표준 구성을 붙여넣습니다.

Save를 클릭합니다.

버튼을 클릭하여 설치:

또는 수동으로 설치:

MCP 설치 가이드를 따르고 위의 표준 구성을 사용합니다. VS Code CLI를 사용하여 Playwright MCP 서버를 설치할 수도 있습니다:

# For VS Code
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

설치 후 Playwright MCP 서버는 VS Code에서 GitHub Copilot 에이전트와 함께 사용할 수 있습니다.

Settings -> AI -> Manage MCP Servers -> + Add로 이동하여 MCP 서버를 추가합니다. 위의 표준 구성을 사용합니다.

또는 Warp 프롬프트에서 슬래시 명령 /add-mcp을 사용하고 위의 표준 구성을 붙여넣습니다:

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

Windsurf MCP 문서를 따릅니다. 위의 표준 구성을 사용합니다.

{
  /**
   * The browser to use.
   */
  browser?: {
    /**
     * The type of browser to use.
     */
    browserName?: 'chromium' | 'firefox' | 'webkit';

    /**
     * Keep the browser profile in memory, do not save it to disk.
     */
    isolated?: boolean;

    /**
     * Path to a user data directory for browser profile persistence.
     * Temporary directory is created by default.
     */
    userDataDir?: string;

    /**
     * Launch options passed to
     * @see https://playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context
     *
     * This is useful for settings options like `channel`, `headless`, `executablePath`, etc.
     */
    launchOptions?: playwright.LaunchOptions;

    /**
     * Context options for the browser context.
     *
     * This is useful for settings options like `viewport`.
     */
    contextOptions?: playwright.BrowserContextOptions;

    /**
     * Chrome DevTools Protocol endpoint to connect to an existing browser instance in case of Chromium family browsers.
     */
    cdpEndpoint?: string;

    /**
     * CDP headers to send with the connect request.
     */
    cdpHeaders?: Record<string, string>;

    /**
     * Timeout in milliseconds for connecting to CDP endpoint. Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
     */
    cdpTimeout?: number;

    /**
     * Remote endpoint to connect to an existing Playwright server. May be a
     * WebSocket URL string, or a [ConnectOptions] object that mirrors the
     * `connectOptions` shape used by the test runner. When passed as an object,
     * `exposeNetwork`, `headers`, `slowMo`, and `timeout` are forwarded to the
     * underlying connect call.
     */
    remoteEndpoint?: string | playwright.ConnectOptions & { endpoint: string };

    /**
     * Paths to TypeScript files to add as initialization scripts for Playwright page.
     */
    initPage?: string[];

    /**
     * Paths to JavaScript files to add as initialization scripts.
     * The scripts will be evaluated in every page before any of the page's scripts.
     */
    initScript?: string[];
  },

  /**
   * Connect to a running browser instance (Edge/Chrome only). If specified, `browser`
   * config is ignored.
   * Requires the "Playwright Extension" to be installed.
   */
  extension?: boolean;

  server?: {
    /**
     * The port to listen on for SSE or MCP transport.
     */
    port?: number;

    /**
     * The host to bind the server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
     */
    host?: string;

    /**
     * The hosts this server is allowed to serve from. Defaults to the host server is bound to.
     * This is not for CORS, but rather for the DNS rebinding protection.
     */
    allowedHosts?: string[];
  },

  /**
   * List of enabled tool capabilities. Possible values:
   *   - 'core': Core browser automation features.
   *   - 'pdf': PDF generation and manipulation.
   *   - 'vision': Coordinate-based interactions.
   *   - 'devtools': Developer tools features.
   */
  capabilities?: ToolCapability[];

  /**
   * Whether to save the Playwright session into the output directory.
   */
  saveSession?: boolean;

  /**
   * Whether to collect and expose the tools that a page registers through the
   * experimental WebMCP API. Enabled by default.
   */
  webmcp?: boolean;

  /**
   * Reuse the same browser context between all connected HTTP clients.
   */
  sharedBrowserContext?: boolean;

  /**
   * Secrets are used to replace matching plain text in the tool responses to prevent the LLM
   * from accidentally getting sensitive data. It is a convenience and not a security feature,
   * make sure to always examine information coming in and from the tool on the client.
   */
  secrets?: Record<string, string>;

  /**
   * The directory for automatically named output files, for example a screenshot taken without an
   * explicit file name. Files with an explicit name are resolved against the workspace root instead
   * and are not affected by this option.
   */
  outputDir?: string;

  /**
   * Threshold for evicting old output files, in bytes.
   */
  outputMaxSize?: number;

  console?: {
    /**
     * The level of console messages to return. Each level includes the messages of more severe levels. Defaults to "info".
     */
    level?: 'error' | 'warning' | 'info' | 'debug';
  },

  network?: {
    /**
     * List of origins to allow the browser to request. Default is to allow all. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    allowedOrigins?: string[];

    /**
     * List of origins to block the browser to request. Origins matching both `allowedOrigins` and `blockedOrigins` will be blocked.
     *
     * Supported formats:
     * - Full origin: `https://example.com:8080` - matches only that origin
     * - Wildcard port: `http://localhost:*` - matches any port on localhost with http protocol
     */
    blockedOrigins?: string[];
  };

  /**
   * Specify the attribute to use for test ids, defaults to "data-testid".
   */
  testIdAttribute?: string;

  timeouts?: {
    /*
     * Configures default action timeout: https://playwright.dev/docs/api/class-page#page-set-default-timeout. Defaults to 5000ms.
     */
    action?: number;

    /*
     * Configures default navigation timeout: https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout. Defaults to 60000ms.
     */
    navigation?: number;

    /**
     * Configures default expect timeout: https://playwright.dev/docs/test-timeouts#expect-timeout. Defaults to 5000ms.
     */
    expect?: number;

    /**
     * How long to wait after each action for triggered work (navigations, requests) to settle before responding. Defaults to 500ms.
     */
    settle?: number;

    /**
     * Close the browser after this many milliseconds without a tool call, and relaunch it on the next one.
     * Defaults to one hour for headless browsers Playwright launched, and to no timeout for headed or attached ones. Pass 0 to disable.
     * The CLI shuts the whole session down instead of relaunching.
     */
    idle?: number;
  };

  /**
   * Whether to send image responses to the client. Can be "allow", "omit", or "only". Defaults to "allow".
   * With "only", a response that carries an image consists of the image parts alone, without the text part.
   */
  imageResponses?: 'allow' | 'omit' | 'only';

  /**
   * How file paths are rendered in tool results. Can be "relative" to the workspace root or "absolute". Defaults to "relative".
   */
  filePaths?: 'relative' | 'absolute';

  snapshot?: {
    /**
     * When taking snapshots for responses, specifies the mode to use.
     */
    mode?: 'full' | 'none';

    /**
     * Whether to include each element's bounding box as [box=x,y,width,height] in snapshots.
     * Coordinates are viewport-relative, in CSS pixels (Element.getBoundingClientRect).
     */
    boxes?: boolean;
  };

  /**
   * allowUnrestrictedFileAccess acts as a guardrail to prevent the LLM from accidentally
   * wandering outside its intended workspace. It is a convenience defense to catch unintended
   * file access, not a secure boundary; a deliberate attempt to reach other directories can be
   * easily worked around, so always rely on client-level permissions for true security.
   */
  allowUnrestrictedFileAccess?: boolean;

  /**
   * Specify the language to use for code generation.
   */
  codegen?: 'typescript' | 'python' | 'java' | 'csharp' | 'none';
}

참고: 현재 Docker 구현은 headless chromium만 지원합니다.

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}

또는 MCP 클라이언트가 컨테이너를 생성하도록 두는 대신 장기 실행 서비스로 실행하려면 다음을 사용하세요:

docker run -d -i --rm --init --pull=always \
  --entrypoint node \
  --name playwright \
  -p 8931:8931 \
  mcr.microsoft.com/playwright/mcp \
  /app/cli.js --headless --browser chromium --no-sandbox --port 8931 --host 0.0.0.0

서버는 호스트 포트 8931에서 수신 대기하며 모든 MCP 클라이언트가 접근할 수 있습니다.

Docker 이미지를 직접 빌드할 수 있습니다.

docker build -t mcr.microsoft.com/playwright/mcp .

import http from 'http';

import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

http.createServer(async (req, res) => {
  // ...

  // Creates a headless Playwright MCP server with SSE transport
  const connection = await createConnection({ browser: { launchOptions: { headless: true } } });
  const transport = new SSEServerTransport('/messages', res);
  await connection.connect(transport);

  // ...
});

• browser_click
  • 제목: 클릭
  • 설명: 웹 페이지에서 클릭을 수행합니다
  • 매개변수:
    • element (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • doubleClick (부울, 선택): 단일 클릭 대신 더블 클릭을 수행할지 여부
    • button (문자열, 선택): 클릭할 버튼, 기본값은 왼쪽
    • modifiers (배열, 선택): 누를 보조 키
  • 읽기 전용: false

• browser_close
  • 제목: 브라우저 닫기
  • 설명: 페이지를 닫습니다
  • 매개변수: 없음
  • 읽기 전용: false

• browser_console_messages
  • 제목: 콘솔 메시지 가져오기
  • 설명: 모든 콘솔 메시지를 반환합니다
  • 매개변수:
    • level (문자열): 반환할 콘솔 메시지의 수준. 각 수준은 더 심각한 수준의 메시지를 포함합니다. 기본값은 "info"입니다.
    • all (부울, 선택): 마지막 탐색 이후가 아닌 세션 시작 이후의 모든 콘솔 메시지를 반환할지 여부. 기본값은 false입니다.
    • filename (문자열, 선택): 콘솔 메시지를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 제공되지 않으면 메시지가 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_drag
  • 제목: 마우스 드래그
  • 설명: 두 요소 사이에서 드래그 앤 드롭을 수행합니다
  • 매개변수:
    • startElement (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 소스 요소 설명
    • startTarget (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • endElement (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 대상 요소 설명
    • endTarget (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: false

• browser_drop
  • 제목: 요소에 파일 또는 데이터 드롭
  • 설명: 페이지 외부에서 끌어온 것처럼 요소에 파일 또는 MIME 유형 데이터를 드롭합니다. "paths" 또는 "data" 중 하나 이상을 제공해야 합니다.
  • 매개변수:
    • element (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • paths (배열, 선택): 요소에 드롭할 파일의 절대 경로.
    • data (객체, 선택): MIME 유형을 문자열 값에 매핑한 데이터 드롭 (예: {"text/plain": "hello", "text/uri-list": "https://example.com"}).
  • 읽기 전용: false

• browser_emulate_media
  • 제목: 미디어 기능 에뮬레이션
  • 설명: 페이지의 CSS 미디어 기능을 에뮬레이션합니다. 예를 들어 밝은 색 구성표와 어두운 색 구성표 사이를 전환합니다. 생략된 매개변수는 변경되지 않으며, null은 재정의를 지웁니다.
  • 매개변수:
    • colorScheme (선택): prefers-color-scheme 미디어 기능을 에뮬레이션합니다
    • reducedMotion (선택): prefers-reduced-motion 미디어 기능을 에뮬레이션합니다
    • forcedColors (선택): forced-colors 미디어 기능을 에뮬레이션합니다
    • contrast (선택): prefers-contrast 미디어 기능을 에뮬레이션합니다
    • media (선택): 페이지의 CSS 미디어 유형을 변경합니다
  • 읽기 전용: false

• browser_evaluate
  • 제목: JavaScript 평가
  • 설명: 페이지 또는 요소에서 JavaScript 표현식을 평가합니다
  • 매개변수:
    • element (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열, 선택): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • function (문자열): () => { /* 코드 / } 또는 요소가 제공된 경우 (element) => { / 코드 */ }
    • filename (문자열, 선택): 결과를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 제공되지 않으면 결과가 텍스트로 반환됩니다.
  • 읽기 전용: false

• browser_file_upload
  • 제목: 파일 업로드
  • 설명: 하나 또는 여러 파일을 업로드합니다
  • 매개변수:
    • paths (배열, 선택): 업로드할 파일의 절대 경로. 단일 파일 또는 여러 파일일 수 있습니다. 생략하면 파일 선택기가 취소됩니다.
  • 읽기 전용: false

• browser_fill_form
  • 제목: 양식 채우기
  • 설명: 여러 양식 필드를 채웁니다
  • 매개변수:
    • fields (배열): 채울 필드
  • 읽기 전용: false

• browser_find
  • 제목: 페이지 스냅샷에서 찾기
  • 설명: 현재 페이지의 접근성 스냅샷에서 텍스트 또는 정규식을 검색합니다. 각 노드가 트리 루트에서의 경로 아래에 표시되는 주변 컨텍스트(검색 스니펫과 같은) 몇 줄과 함께 일치하는 스냅샷 노드를 반환합니다. 요소와 해당 ref만 찾으면 되는 경우 전체 스냅샷을 캡처하는 것보다 저렴합니다.
  • 매개변수:
    • text (문자열, 선택): 페이지 스냅샷에서 검색할 일반 텍스트(대소문자 구분 없는 부분 문자열 일치). 텍스트 또는 정규식 중 하나만 제공하세요.
    • regex (문자열, 선택): 페이지 스냅샷에서 검색할 정규식. 기본적으로 대소문자를 구분합니다. 플래그를 추가하려면 패턴을 슬래시로 감싸세요. 예: 대소문자 구분 없는 "/error/i". 텍스트 또는 정규식 중 하나만 제공하세요.
    • filename (문자열, 선택): 응답에서 반환하는 대신 결과를 파일에 저장합니다. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다.
  • 읽기 전용: true

• browser_handle_dialog
  • 제목: 대화상자 처리
  • 설명: 대화상자를 처리합니다
  • 매개변수:
    • accept (부울): 대화상자를 수락할지 여부.
    • promptText (문자열, 선택): 프롬프트 대화상자의 경우 프롬프트 텍스트.
  • 읽기 전용: false

• browser_hover
  • 제목: 마우스 호버
  • 설명: 페이지의 요소 위에 마우스를 올립니다
  • 매개변수:
    • element (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • 읽기 전용: false

• browser_navigate
  • 제목: URL로 이동
  • 설명: URL로 이동합니다
  • 매개변수:
    • url (문자열): 이동할 URL
  • 읽기 전용: false

• browser_navigate_back
  • 제목: 뒤로 가기
  • 설명: 기록의 이전 페이지로 돌아갑니다
  • 매개변수: 없음
  • 읽기 전용: false

• browser_network_request
  • 제목: 네트워크 요청 세부 정보 표시
  • 설명: 단일 네트워크 요청의 전체 세부 정보(헤더 및 본문)를 반환하거나, part가 설정된 경우 단일 부분을 반환합니다. browser_network_requests의 번호를 사용하세요.
  • 매개변수:
    • index (정수): browser_network_requests에 의해 출력된 요청의 1부터 시작하는 인덱스.
    • part (문자열, 선택): 요청의 이 부분만 반환합니다. 전체 세부 정보를 반환하려면 생략하세요.
    • filename (문자열, 선택): 결과를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 제공되지 않으면 출력이 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_network_requests
  • 제목: 네트워크 요청 목록
  • 설명: 페이지 로드 이후 네트워크 요청의 번호가 매겨진 목록을 반환합니다. 전체 세부 정보를 얻으려면 browser_network_request를 번호와 함께 사용하세요.
  • 매개변수:
    • static (부울): 이미지, 글꼴, 스크립트 등 성공적인 정적 리소스를 포함할지 여부. 기본값은 false입니다.
    • filter (문자열, 선택): URL이 이 정규식과 일치하는 요청만 반환합니다 (예: "/api/.*user").
    • filename (문자열, 선택): 네트워크 요청을 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 제공되지 않으면 요청이 텍스트로 반환됩니다.
  • 읽기 전용: true

• browser_press_key
  • 제목: 키 누르기
  • 설명: 키보드에서 키를 누릅니다
  • 매개변수:
    • key (문자열): 누를 키의 이름 또는 생성할 문자 (예: ArrowLeft 또는 a)
  • 읽기 전용: false

• browser_resize
  • 제목: 브라우저 창 크기 조정
  • 설명: 브라우저 창 크기를 조정합니다
  • 매개변수:
    • width (숫자): 브라우저 창의 너비
    • height (숫자): 브라우저 창의 높이
  • 읽기 전용: false

• browser_run_code_unsafe
  • 제목: Playwright 코드 실행 (안전하지 않음)
  • 설명: Playwright 코드 스니펫을 실행합니다. 안전하지 않음: Playwright 서버 프로세스에서 임의의 JavaScript를 실행하며 RCE와 동일합니다.
  • 매개변수:
    • code (문자열, 선택): 실행할 Playwright 코드가 포함된 JavaScript 함수. 단일 인수 page로 호출되며, 페이지 상호작용에 사용할 수 있습니다. 예: async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }
    • filename (문자열, 선택): 지정된 파일에서 코드를 로드합니다. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 코드와 파일 이름이 모두 제공되면 코드는 무시됩니다.
  • 읽기 전용: false

• browser_select_option
  • 제목: 옵션 선택
  • 설명: 드롭다운에서 옵션을 선택합니다
  • 매개변수:
    • element (문자열, 선택): 요소와 상호작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • values (배열): 드롭다운에서 선택할 값의 배열. 단일 값 또는 여러 값일 수 있습니다.
  • 읽기 전용: false

• browser_snapshot
  • Title: 페이지 스냅샷
  • Description: 현재 페이지의 접근성 스냅샷을 캡처합니다. 스크린샷보다 더 유용합니다.
  • Parameters:
    • target (string, optional): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • filename (string, optional): 응답으로 반환하는 대신 스냅샷을 파일로 저장합니다. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다.
    • depth (number, optional): 스냅샷 트리의 깊이 제한
    • boxes (boolean, optional): 각 요소의 경계 상자를 스냅샷에 [box=x,y,width,height]로 포함합니다. 좌표는 뷰포트 기준이며 CSS 픽셀 단위입니다 (Element.getBoundingClientRect).
  • Read-only: true

• browser_take_screenshot
  • Title: 스크린샷 찍기
  • Description: 현재 페이지의 스크린샷을 찍습니다. 스크린샷을 기반으로 작업을 수행할 수 없으므로 작업에는 browser_snapshot을 사용하세요.
  • Parameters:
    • element (string, optional): 요소와 상호 작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (string, optional): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • type (string, optional): 스크린샷의 이미지 형식. 설정하지 않으면 파일 이름 확장자에서 유추되며, 그 외에는 png입니다.
    • filename (string, optional): 스크린샷을 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 지정하지 않으면 스크린샷은 page-{timestamp}.{png|jpeg|webp}로 출력 디렉터리에 저장됩니다.
    • fullPage (boolean, optional): true이면 현재 보이는 뷰포트 대신 전체 스크롤 가능한 페이지의 스크린샷을 찍습니다. 요소 스크린샷과 함께 사용할 수 없습니다.
    • scale (string): 이미지 해상도 배율. "css"는 CSS 픽셀 단위의 스크린샷을 생성합니다(더 작고 장치 간 일관됨). "device"는 장치 픽셀을 사용하는 고해상도 스크린샷을 생성합니다(더 크고 장치 픽셀 비율을 고려함). 기본값은 css입니다.
  • Read-only: true

• browser_type
  • Title: 텍스트 입력
  • Description: 편집 가능한 요소에 텍스트를 입력합니다
  • Parameters:
    • element (string, optional): 요소와 상호 작용하기 위한 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (string): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
    • text (string): 요소에 입력할 텍스트
    • submit (boolean, optional): 입력한 텍스트를 제출할지 여부(입력 후 Enter 누르기)
    • slowly (boolean, optional): 한 번에 한 문자씩 입력할지 여부. 페이지의 키 핸들러를 트리거하는 데 유용합니다. 기본적으로 전체 텍스트가 한 번에 채워집니다.
  • Read-only: false

• browser_wait_for
  • Title: 대기
  • Description: 텍스트가 나타나거나 사라지거나 지정된 시간이 경과할 때까지 대기합니다
  • Parameters:
    • time (number, optional): 대기할 시간(초), 최대 30초
    • text (string, optional): 대기할 텍스트
    • textGone (string, optional): 사라질 때까지 대기할 텍스트
  • Read-only: false

• browser_tabs
  • Title: 탭 관리
  • Description: 브라우저 탭을 나열, 생성, 닫기 또는 선택합니다.
  • Parameters:
    • action (string): 수행할 작업
    • index (number, optional): 탭 인덱스. 닫기/선택에 사용됩니다. 닫기에서 생략하면 현재 탭이 닫힙니다.
    • url (string, optional): 새 탭에서 이동할 URL. 새 탭 생성에 사용됩니다.
  • Read-only: false

• browser_get_config
  • Title: 구성 가져오기
  • Description: CLI 옵션, 환경 변수 및 구성 파일을 병합한 후 최종 확인된 구성을 가져옵니다.
  • Parameters: 없음
  • Read-only: true

• browser_network_state_set
  • Title: 네트워크 상태 설정
  • Description: 브라우저 네트워크 상태를 온라인 또는 오프라인으로 설정합니다. 오프라인일 때 모든 네트워크 요청이 실패합니다.
  • Parameters:
    • state (string): 오프라인 모드를 시뮬레이션하려면 "offline"으로, 네트워크 연결을 복원하려면 "online"으로 설정합니다
  • Read-only: false

• browser_route
  • Title: 네트워크 요청 모의
  • Description: URL 패턴과 일치하는 네트워크 요청을 모의하는 경로를 설정합니다
  • Parameters:
    • pattern (string): 일치시킬 URL 패턴 (예: "/api/users", "/*.{png,jpg}")
    • status (number, optional): 반환할 HTTP 상태 코드 (기본값: 200)
    • body (string, optional): 응답 본문 (텍스트 또는 JSON 문자열)
    • contentType (string, optional): Content-Type 헤더 (예: "application/json", "text/html")
    • headers (array, optional): "Name: Value" 형식으로 추가할 헤더
    • removeHeaders (string, optional): 요청에서 제거할 쉼표로 구분된 헤더 이름 목록
  • Read-only: false

• browser_route_list
  • Title: 네트워크 경로 목록
  • Description: 모든 활성 네트워크 경로를 나열합니다
  • Parameters: 없음
  • Read-only: true

• browser_unroute
  • Title: 네트워크 경로 제거
  • Description: 패턴과 일치하는 네트워크 경로를 제거합니다(패턴을 지정하지 않으면 모든 경로 제거)
  • Parameters:
    • pattern (string, optional): 제거할 URL 패턴(모든 경로를 제거하려면 생략)
  • Read-only: false

• browser_cookie_clear
  • Title: 쿠키 지우기
  • Description: 모든 쿠키를 지웁니다
  • Parameters: 없음
  • Read-only: false

• browser_cookie_delete
  • Title: 쿠키 삭제
  • Description: 특정 쿠키를 삭제합니다
  • Parameters:
    • name (string): 삭제할 쿠키 이름
  • Read-only: false

• browser_cookie_get
  • Title: 쿠키 가져오기
  • Description: 이름으로 특정 쿠키를 가져옵니다
  • Parameters:
    • name (string): 가져올 쿠키 이름
  • Read-only: true

• browser_cookie_list
  • Title: 쿠키 목록
  • Description: 모든 쿠키를 나열합니다(선택적으로 도메인/경로로 필터링)
  • Parameters:
    • domain (string, optional): 도메인별로 쿠키 필터링
    • path (string, optional): 경로별로 쿠키 필터링
  • Read-only: true

• browser_cookie_set
  • Title: 쿠키 설정
  • Description: 선택적 플래그(도메인, 경로, 만료, httpOnly, secure, sameSite)로 쿠키를 설정합니다
  • Parameters:
    • name (string): 쿠키 이름
    • value (string): 쿠키 값
    • domain (string, optional): 쿠키 도메인
    • path (string, optional): 쿠키 경로
    • expires (number, optional): Unix 타임스탬프로 표시된 쿠키 만료
    • httpOnly (boolean, optional): 쿠키가 HTTP 전용인지 여부
    • secure (boolean, optional): 쿠키가 보안 쿠키인지 여부
    • sameSite (string, optional): 쿠키 SameSite 속성
  • Read-only: false

• browser_localstorage_clear
  • Title: localStorage 지우기
  • Description: 모든 localStorage를 지웁니다
  • Parameters: 없음
  • Read-only: false

• browser_localstorage_delete
  • Title: localStorage 항목 삭제
  • Description: localStorage 항목을 삭제합니다
  • Parameters:
    • key (string): 삭제할 키
  • Read-only: false

• browser_localstorage_get
  • Title: localStorage 항목 가져오기
  • Description: 키로 localStorage 항목을 가져옵니다
  • Parameters:
    • key (string): 가져올 키
  • Read-only: true

• browser_localstorage_list
  • Title: localStorage 목록
  • Description: 모든 localStorage 키-값 쌍을 나열합니다
  • Parameters: 없음
  • Read-only: true

• browser_localstorage_set
  • Title: localStorage 항목 설정
  • Description: localStorage 항목을 설정합니다
  • Parameters:
    • key (string): 설정할 키
    • value (string): 설정할 값
  • Read-only: false

• browser_sessionstorage_clear
  • Title: sessionStorage 지우기
  • Description: 모든 sessionStorage를 지웁니다
  • Parameters: 없음
  • Read-only: false

• browser_sessionstorage_delete
  • Title: sessionStorage 항목 삭제
  • Description: sessionStorage 항목을 삭제합니다
  • Parameters:
    • key (string): 삭제할 키
  • Read-only: false

• browser_sessionstorage_get
  • Title: sessionStorage 항목 가져오기
  • Description: 키로 sessionStorage 항목을 가져옵니다
  • Parameters:
    • key (string): 가져올 키
  • Read-only: true

• browser_sessionstorage_list
  • Title: sessionStorage 목록
  • Description: 모든 sessionStorage 키-값 쌍을 나열합니다
  • Parameters: 없음
  • Read-only: true

• browser_sessionstorage_set
  • Title: sessionStorage 항목 설정
  • Description: sessionStorage 항목을 설정합니다
  • Parameters:
    • key (string): 설정할 키
    • value (string): 설정할 값
  • Read-only: false

• browser_set_storage_state
  • Title: 저장소 상태 복원
  • Description: 파일에서 저장소 상태(쿠키, 로컬 저장소)를 복원합니다. 복원하기 전에 기존 쿠키와 로컬 저장소를 지웁니다.
  • Parameters:
    • filename (string): 복원할 저장소 상태 파일의 경로. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다.
  • Read-only: false

• browser_storage_state
  • Title: 저장소 상태 저장
  • Description: 나중에 재사용할 수 있도록 저장소 상태(쿠키, 로컬 저장소)를 파일에 저장합니다
  • Parameters:
    • filename (string, optional): 저장소 상태를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 지정하지 않으면 저장소 상태는 storage-state-{timestamp}.json로 출력 디렉터리에 저장됩니다.
  • Read-only: true

• browser_annotate
  • Title: 현재 페이지에 주석 달기
  • Description: 현재 페이지에 대해 주석 모드로 Playwright Dashboard를 열고 사용자가 주석을 그릴 때까지 기다립니다. 주석이 달린 스크린샷, ARIA 스냅샷 및 주석 목록을 반환합니다.
  • Parameters: 없음
  • Read-only: true

• browser_hide_highlight
  • Title: 요소 하이라이트 숨기기
  • Description: 이전에 요소에 추가된 하이라이트 오버레이를 제거합니다.
  • Parameters:
    • element (string, optional): 하이라이트를 추가할 때 사용된 사람이 읽을 수 있는 요소 설명; browser_highlight에 전달된 값과 일치해야 합니다.
    • target (string, optional): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택자
  • Read-only: true

• browser_highlight
  • 제목: 요소 강조
  • 설명: 페이지의 요소 주위에 지속적인 강조 오버레이를 표시합니다.
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택기
    • style (문자열, 선택 사항): 강조 오버레이에 적용되는 추가 인라인 CSS(예: "outline: 2px dashed red").
  • 읽기 전용: true

• browser_resume
  • 제목: 일시 중지된 스크립트 실행 재개
  • 설명: 일시 중지된 후 스크립트 실행을 재개합니다. step이 true로 설정된 경우 다음 작업 전에 실행이 다시 일시 중지됩니다.
  • 매개변수:
    • step (부울, 선택 사항): true인 경우 다음 작업 전에 실행이 다시 일시 중지되어 단계별 디버깅이 가능합니다.
    • location (문자열, 선택 사항): 특정 :에서 실행을 일시 중지합니다(예: "example.spec.ts:42").
  • 읽기 전용: false

• browser_start_recording
  • 제목: 사용자 작업 기록 시작
  • 설명: 사용자가 브라우저에서 수행하는 작업을 Playwright 코드로 기록하기 시작합니다. 사용자가 흐름을 수동으로 시연하려는 경우 사용합니다. 사용자가 완료했다고 말하면 browser_stop_recording을 호출하여 기록된 작업을 검색합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_start_tracing
  • 제목: 추적 시작
  • 설명: 추적 기록 시작
  • 매개변수: 없음
  • 읽기 전용: true

• browser_start_video
  • 제목: 비디오 시작
  • 설명: 비디오 녹화 시작
  • 매개변수:
    • filename (문자열, 선택 사항): 비디오를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 지정하지 않으면 비디오는 video-{timestamp}.webm로 출력 디렉터리에 저장됩니다.
    • size (객체, 선택 사항): 비디오 크기
    • fps (숫자, 선택 사항): 초당 프레임 수의 비디오 프레임 속도, 기본값은 25
    • cursor (부울, 선택 사항): 각 작업 지점으로 이동하는 애니메이션 마우스 커서를 렌더링합니다. 커서가 이동할 시간을 확보하기 위해 작업을 800ms 간격으로 조정합니다.
  • 읽기 전용: true

• browser_stop_recording
  • 제목: 사용자 작업 기록 중지
  • 설명: browser_start_recording으로 시작된 기록을 중지하고 기록된 작업을 Playwright 코드로 반환합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_stop_tracing
  • 제목: 추적 중지
  • 설명: 추적 기록 중지
  • 매개변수: 없음
  • 읽기 전용: true

• browser_stop_video
  • 제목: 비디오 중지
  • 설명: 비디오 녹화 중지
  • 매개변수: 없음
  • 읽기 전용: true

• browser_video_chapter
  • 제목: 비디오 챕터
  • 설명: 비디오 녹화에 챕터 마커를 추가합니다. 흐릿한 배경이 있는 전체 화면 챕터 카드를 표시합니다.
  • 매개변수:
    • title (문자열): 챕터 제목
    • description (문자열, 선택 사항): 챕터 설명
    • duration (숫자, 선택 사항): 챕터 카드를 표시할 시간(밀리초)
  • 읽기 전용: true

• browser_video_hide_actions
  • 제목: 작업 오버레이 숨기기
  • 설명: 페이지에서 수행된 작업에 주석을 추가하는 것을 중지합니다.
  • 매개변수: 없음
  • 읽기 전용: true

• browser_video_show_actions
  • 제목: 작업 오버레이 표시
  • 설명: 페이지에서 수행된 후속 작업에 작업 이름을 지정하고 스타일이 지정된 경우 작업 지점을 표시하고 대상 요소를 강조하는 콜아웃으로 주석을 추가합니다. 비디오 녹화 또는 화면 캐스팅 중에 유용합니다.
  • 매개변수:
    • duration (숫자, 선택 사항): 각 작업 주석이 화면에 표시되는 시간(밀리초). 기본값은 500입니다.
    • position (문자열, 선택 사항): 페이지를 기준으로 작업 제목을 배치할 위치. 기본값은 오른쪽 위입니다.
    • cursor (문자열, 선택 사항): 포인터 작업에 대한 커서 장식. "pointer"(기본값)는 이전 작업 지점에서 다음 작업 지점으로 마우스 포인터를 애니메이션합니다. "none"은 커서 장식을 비활성화합니다.
    • style (객체, 선택 사항): 작업 장식의 스타일.
  • 읽기 전용: true

• browser_mouse_click_xy
  • 제목: 클릭
  • 설명: 지정된 위치에서 마우스 버튼 클릭
  • 매개변수:
    • x (숫자): X 좌표
    • y (숫자): Y 좌표
    • button (문자열, 선택 사항): 클릭할 버튼, 기본값은 왼쪽
    • clickCount (숫자, 선택 사항): 클릭 횟수, 기본값은 1
    • delay (숫자, 선택 사항): 마우스 다운과 마우스 업 사이의 대기 시간(밀리초), 기본값은 0
  • 읽기 전용: false

• browser_mouse_down
  • 제목: 마우스 누르기
  • 설명: 마우스 누르기
  • 매개변수:
    • button (문자열, 선택 사항): 누를 버튼, 기본값은 왼쪽
  • 읽기 전용: false

• browser_mouse_drag_xy
  • 제목: 마우스 드래그
  • 설명: 지정된 위치로 왼쪽 마우스 버튼 드래그
  • 매개변수:
    • startX (숫자): 시작 X 좌표
    • startY (숫자): 시작 Y 좌표
    • endX (숫자): 끝 X 좌표
    • endY (숫자): 끝 Y 좌표
  • 읽기 전용: false

• browser_mouse_move_xy
  • 제목: 마우스 이동
  • 설명: 지정된 위치로 마우스 이동
  • 매개변수:
    • x (숫자): X 좌표
    • y (숫자): Y 좌표
  • 읽기 전용: false

• browser_mouse_up
  • 제목: 마우스 놓기
  • 설명: 마우스 놓기
  • 매개변수:
    • button (문자열, 선택 사항): 놓을 버튼, 기본값은 왼쪽
  • 읽기 전용: false

• browser_mouse_wheel
  • 제목: 마우스 휠 스크롤
  • 설명: 마우스 휠 스크롤
  • 매개변수:
    • deltaX (숫자): X 델타
    • deltaY (숫자): Y 델타
  • 읽기 전용: false

• browser_pdf_save
  • 제목: PDF로 저장
  • 설명: 페이지를 PDF로 저장
  • 매개변수:
    • filename (문자열, 선택 사항): PDF를 저장할 파일 이름. 상대 파일 이름은 작업 영역 루트를 기준으로 확인됩니다. 지정하지 않으면 PDF는 page-{timestamp}.pdf로 출력 디렉터리에 저장됩니다.
  • 읽기 전용: true

• browser_generate_locator
  • 제목: 요소에 대한 로케이터 생성
  • 설명: 테스트에서 사용할 지정된 요소에 대한 로케이터 생성
  • 매개변수:
    • element (문자열, 선택 사항): 요소와 상호 작용할 수 있는 권한을 얻는 데 사용되는 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조 또는 고유한 요소 선택기
  • 읽기 전용: true

• browser_verify_element_visible
  • 제목: 요소 표시 확인
  • 설명: 요소가 페이지에 표시되는지 확인
  • 매개변수:
    • role (문자열): 요소의 ROLE. 스냅샷에서 다음과 같이 찾을 수 있습니다: - {ROLE} "Accessible Name":
    • accessibleName (문자열): 요소의 ACCESSIBLE_NAME. 스냅샷에서 다음과 같이 찾을 수 있습니다: - role "{ACCESSIBLE_NAME}"
  • 읽기 전용: false

• browser_verify_list_visible
  • 제목: 목록 표시 확인
  • 설명: 목록이 페이지에 표시되는지 확인
  • 매개변수:
    • element (문자열): 사람이 읽을 수 있는 목록 설명
    • target (문자열): 목록을 가리키는 정확한 대상 요소 참조
    • items (배열): 확인할 항목
  • 읽기 전용: false

• browser_verify_text_visible
  • 제목: 텍스트 표시 확인
  • 설명: 텍스트가 페이지에 표시되는지 확인합니다. 가능하면 browser_verify_element_visible을 선호합니다.
  • 매개변수:
    • text (문자열): 확인할 TEXT. 스냅샷에서 다음과 같이 찾을 수 있습니다: - role "Accessible Name": {TEXT} 또는 다음과 같이: - text: {TEXT}
  • 읽기 전용: false

• browser_verify_value
  • 제목: 값 확인
  • 설명: 요소 값 확인
  • 매개변수:
    • type (문자열): 요소 유형
    • element (문자열): 사람이 읽을 수 있는 요소 설명
    • target (문자열): 페이지 스냅샷의 정확한 대상 요소 참조
    • value (문자열): 확인할 값. 체크박스의 경우 "true" 또는 "false"를 사용합니다.
  • 읽기 전용: false