Browser MCP for Claude and other models

이것은 Playwright와 Streamable HTTP를 통해 일반적인 브라우저 도구를 제공하는 원격 MCP 서버입니다. 서버 내부에서 Claude에 의존하지 않습니다. HTTPS를 통해 MCP를 지원하는 모든 클라이언트가 사용할 수 있으며, Claude나 Gemini, OpenAI 또는 로컬 모델을 사용하는 미들웨어 계층도 포함됩니다.

서버는 페이지를 열고 읽고 민감하지 않은 필드를 채우지만, 비밀번호 필드, 파일, 최종 제출, 결제 또는 삭제 작업은 차단합니다.

Replit에 배포

Docker를 사용하여 이 저장소를 Replit으로 가져온 다음, Reserved VM 또는 계속 실행되는 서비스를 선택하세요. Secrets에 다음 변수를 추가하세요:

비밀번호, 인증 코드, 사이트 키를 GitHub나 코드에 넣지 마세요.

배포 후 endpoint는 다음과 같습니다:

https://YOUR-REPL-DOMAIN/mcp

그리고 HTTPS를 통해 공개되어야 합니다. Claude는 Anthropic 클라우드 인프라에서 서버에 연결하며, 로컬 휴대폰에서 연결하는 것이 아닙니다.

Related MCP server: mcp-browser

Claude Web 연결

휴대폰의 Claude에서 Customize → Connectors → + → Add custom connector를 열고 /mcp 링크를 입력하세요. 인터페이스에서 OAuth Client ID/Secret을 요청하면 해당 입력란에 MCP_AUTH_TOKEN을 넣지 마세요. 이 입력란은 OAuth용입니다. Claude가 계정에 대해 제공하는 인증 메커니즘을 사용하거나, 서버가 직접 Bearer token을 필요로 하는 경우 Claude API를 통해 연결을 구현하세요.

추가 후 대화에서 + → Connectors를 통해 커넥터를 활성화하세요. 공개 페이지 열기, 텍스트 스냅샷 가져오기 같은 읽기 전용 명령부터 시작하세요. 각 도구 요청을 허용하기 전에 검토하세요.

다중 모델

MCP 서버는 모델을 강제하지 않습니다. Claude, Gemini, OpenAI 또는 MCP를 지원하는 다른 모델이 도구 호출을 결정하는 클라이언트입니다. Playwright나 MCP 서버를 수정하지 않고도 모델을 변경할 수 있습니다.

서버 도구

• browser_open(url): 공개 HTTP(S) 페이지를 엽니다.

• browser_snapshot(): 현재 페이지를 읽고 상호작용 가능한 요소의 참조를 표시합니다.

• browser_click(ref): 최종 제출이 아닌 요소를 클릭합니다.

• browser_fill(ref, value): 민감하지 않은 텍스트 필드를 채웁니다.

• browser_select(ref, label_or_value): 목록에서 항목을 선택합니다.

• browser_back(): 한 페이지 뒤로 갑니다.

• browser_close(): 브라우저 세션을 닫습니다.

보안 제한 사항

서버는 MCP_AUTH_TOKEN이 설정되어 있지 않으면 실행을 거부합니다. 공개 HTTPS 뒤에서 실행해야 하며, 필요에 따라 사이트와 데이터에 대한 접근을 제한하세요. CAPTCHA나 사이트 제어를 우회하는 데 사용하지 말고, Claude에게 구매, 삭제 또는 제출 작업에 대한 자동 권한을 부여하지 마세요. 프로덕션 계정과 함께 사용하기 전에 실제 OAuth를 추가하세요.

참고 자료

• Claude custom connectors

• MCP Python SDK

• MCP Streamable HTTP specification

• Microsoft Playwright MCP