webpage-mcp — 기존 브라우저를 AI 에이전트 MCP 서버로 바꾸는 도구

Playwright로 웹 자동화를 구현할 때 가장 먼저 막히는 지점이 있다. 로그인이다.

자동화 브라우저는 기존 세션이 없다. 매번 로그인해야 하고, 2FA가 있으면 복잡해진다. 사내 시스템처럼 SSO를 써야 하는 경우엔 아예 불가능할 때도 있다.

webpage-mcp는 이 문제를 다른 방식으로 접근한다. 새 브라우저를 띄우는 게 아니라, 지금 쓰고 있는 Chrome을 MCP 서버로 바꾼다.

작동 방식

구조는 두 레이어다.

Chrome 확장: 브라우저 내부에서 동작하는 레이어. 탭 접근, 스크린샷, DOM 조작, 네트워크 모니터링 등을 처리한다. Chrome Extension API를 직접 쓰기 때문에 DevTools 없이도 깊은 수준의 브라우저 제어가 가능하다.

stdio MCP 서버: AI 클라이언트(Claude, VS Code 에이전트 등)가 표준 MCP 프로토콜로 연결하는 레이어. npx webpage-mcp-stdio로 실행하면 확장과 연결된 MCP 서버가 뜬다.

[💡 잠깐! 이 용어는?] MCP(Model Context Protocol): AI 에이전트가 외부 도구를 사용하기 위한 표준 인터페이스. 서버를 정의하면 Claude, VS Code 에이전트 등이 공통 방식으로 도구를 호출할 수 있다.

설치와 설정

# 1. Chrome Web Store에서 확장 설치
# "Webpage MCP Connector" 검색
 
# 2. MCP 클라이언트 설정

{
  "mcpServers": {
    "webpage-mcp": {
      "command": "npx",
      "args": ["-y", "-p", "webpage-mcp@latest", "webpage-mcp-stdio"]
    }
  }
}

Chrome이 열린 상태에서 MCP 클라이언트를 시작하면 자동으로 등록된다. 별도 브라우저 설치 없음. 지금 쓰는 Chrome 그대로다.

주요 기능

20개 이상의 도구: 스크린샷, 요소 클릭, 폼 입력, JavaScript 실행, 네트워크 모니터링, 키보드/마우스 입력까지.

시맨틱 검색: WASM 기반 벡터 임베딩으로 열린 탭 전체에서 관련 콘텐츠를 검색한다. 여러 탭을 열어둔 상태에서 AI가 맥락에 맞는 정보를 찾을 수 있다.

워크플로우 자동화: 브라우저 액션을 기록하고 재생할 수 있다. 반복 작업을 MCP 도구로 등록해서 재사용 가능한 자동화를 만든다.

웹 에디터: 페이지 내 DOM을 시각적으로 편집하는 인터페이스. undo/redo, 트랜잭션 지원.

SIMD 가속 AI: WebAssembly SIMD 명령으로 벡터 연산을 4~8배 빠르게 처리한다.

Playwright 기반 도구와 차이점

webpage-mcp의 핵심 장점은 기존 세션이다. 이미 로그인된 사내 시스템, Gmail, GitHub — 별도 인증 없이 에이전트가 그대로 접근할 수 있다.

반대로 CI/CD 파이프라인처럼 서버에서 실행해야 하는 경우엔 Playwright가 맞다. Chrome GUI가 없는 환경이니까.

실제 활용 예시

Claude에게: "열린 탭에서 GitHub PR 목록 확인하고, 리뷰어가 나인 PR 제목들 알려줘"

webpage-mcp가 설치된 상태에서 GitHub에 로그인되어 있으면, Claude가 직접 탭을 읽어서 PR 목록을 가져온다. 별도 GitHub API 토큰 설정 없이.

Claude에게: "Jira 보드 열어서 이번 주 내 할일 정리해줘"  

사내 SSO로 로그인된 Jira라도, 이미 세션이 있으면 에이전트가 그대로 접근 가능하다.

주의할 점

AI 에이전트가 로그인된 브라우저에 접근한다는 건 강력하지만, 리스크도 있다. 에이전트가 실수로 데이터를 수정하거나 삭제할 수 있다. 민감한 환경에서는 에이전트에게 어떤 탭에 접근 권한을 줄지 신중하게 설정해야 한다.

또한 확장이 백그라운드에서 실행되므로, 실제로 무슨 일이 일어나는지 로그를 확인하는 습관이 필요하다.

마무리

webpage-mcp는 "AI 에이전트가 웹을 다룬다"는 개념을 현실적으로 만드는 도구다. 새 브라우저 인스턴스를 뜨게 하고 로그인부터 다시 시작하는 게 아니라, 지금 쓰는 환경 그대로 에이전트가 들어온다. 개인 생산성 자동화에서 특히 유용하다. 로그인이 필요한 모든 반복 작업이 자동화 대상이 된다.

참고:

• webpage-mcp GitHub: https://github.com/mcpland/webpage-mcp
• MCP 문서: https://modelcontextprotocol.io