Browserbase MCP (Stagehand) — Claude Code MCP 서버

Browserbase 클라우드 브라우저와 Stagehand를 통해 LLM이 실제 브라우저를 자연어로 제어·자동화하게 해주는 공식 MCP 서버.

Browserbase MCP는 Browserbase의 클라우드 브라우저 인프라와 Stagehand 자동화 프레임워크를 묶어, LLM(Claude 등)이 실제 웹 브라우저를 자연어 지시로 제어할 수 있게 해주는 공식 MCP 서버입니다. 헤드리스 브라우저를 직접 띄우고 셀렉터를 일일이 작성하던 기존 방식 대신, "로그인 폼에 값을 채우고 제출해라", "이 페이지에서 가격 목록을 추출해라" 같은 자연어 의도를 Stagehand가 실제 브라우저 동작(클릭·입력·이동·관찰)으로 변환합니다.

핵심적으로 해결하는 문제는 두 가지입니다. 첫째, 자바스크립트로 렌더링되는 동적 사이트는 단순 HTTP 요청으로는 내용을 가져올 수 없는데, 실제 브라우저를 띄워 렌더링 후 데이터를 추출하므로 SPA·로그인 뒤 페이지·동적 콘텐츠도 다룰 수 있습니다. 둘째, 브라우저 실행 환경을 로컬에 구성·유지하는 부담을 Browserbase 클라우드가 대신 맡아, 세션 관리·확장성·격리된 실행 환경을 위임할 수 있습니다.

주요 기능은 자연어 기반 브라우저 액션 수행, 페이지 관찰·구조화된 데이터 추출, 멀티스텝 웹 자동화, 그리고 클라우드 세션을 통한 스크래핑입니다. Stagehand가 의도를 동작으로 번역하는 계층 역할을 하므로, 깨지기 쉬운 하드코딩 셀렉터 의존도를 낮출 수 있습니다.

추천 대상은 동적 웹사이트에서 데이터를 수집해야 하는 데이터 엔지니어·리서처, 반복적인 웹 업무를 에이전트로 자동화하려는 개발자, 로컬 브라우저 환경 없이 클라우드에서 안정적으로 자동화를 돌리려는 팀입니다. Node 기반(npx)으로 설치하며 실행에는 Browserbase API 키와 프로젝트 ID가 필요합니다. 세부 기능·옵션은 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.

언제 쓰나

자바스크립트로 렌더링되는 동적 사이트나 로그인 뒤 페이지에서 데이터를 추출해야 할 때, 단순 HTTP 스크래핑이 막힐 때 적합합니다. 로그인·폼 입력·다단계 탐색 같은 멀티스텝 웹 작업을 자연어로 자동화하거나, 로컬에 브라우저 실행 환경을 두지 않고 클라우드 세션으로 안정적·확장적으로 돌리고 싶을 때 유용합니다. 셀렉터 하드코딩을 줄이고 의도 기반으로 자동화를 작성하려는 경우에도 좋습니다.

설치

claude mcp add browserbase -e BROWSERBASE_API_KEY=<BROWSERBASE_API_KEY> -e BROWSERBASE_PROJECT_ID=<BROWSERBASE_PROJECT_ID> -- npx -y @browserbasehq/mcp

Node.js 환경이 필요하며 npx로 패키지를 받아 실행합니다. 실행 전 Browserbase 계정에서 API 키와 프로젝트 ID를 발급받아 환경변수 BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID로 전달해야 합니다. 둘 중 하나라도 누락되면 세션 생성이 실패합니다. 클라우드 브라우저 사용량에 따라 Browserbase 요금이 발생할 수 있으니 무료 한도·플랜을 사전에 확인하세요. 패키지명·옵션·지원 도구는 버전에 따라 바뀔 수 있으므로 공식 문서 확인을 권장합니다.

필요 키(직접 발급, 플레이스홀더): BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID

보안 주의

BROWSERBASE_API_KEY와 BROWSERBASE_PROJECT_ID는 클라우드 브라우저 세션을 생성·과금하는 비밀키이므로 절대 커밋·로그·공유하지 말고 환경변수/시크릿 매니저로만 주입하세요. 이 서버는 실제 브라우저로 로그인·폼 제출·데이터 입력 등 부수효과 있는 동작을 수행하므로, LLM이 의도치 않은 사이트에서 결제·삭제·전송을 일으키지 않도록 권한과 대상 도메인을 통제해야 합니다. 특히 가져온 웹 페이지 본문에 악의적 지시가 숨겨져 모델을 조종하는 프롬프트 인젝션 위험이 크니, 추출 콘텐츠는 신뢰하지 말고 자동 실행 액션을 검토·승인 게이트로 제한하세요. 자격증명을 다루는 자동화는 격리된 세션에서 최소 권한으로 운영하길 권장합니다.

자주 묻는 질문

단순 HTTP 스크래핑 도구와 무엇이 다른가요?

실제 클라우드 브라우저를 띄워 페이지를 렌더링한 뒤 다루므로, 자바스크립트로 그려지는 동적 사이트나 로그인 뒤 페이지처럼 단순 HTTP 요청으로는 내용을 얻을 수 없는 경우까지 처리할 수 있습니다. 또한 Stagehand가 자연어 의도를 클릭·입력 같은 실제 동작으로 변환합니다.

실행에 어떤 키가 필요한가요?

Browserbase API 키(BROWSERBASE_API_KEY)와 프로젝트 ID(BROWSERBASE_PROJECT_ID)가 필요합니다. Browserbase 계정에서 발급해 환경변수로 전달하며, 둘 중 하나라도 없으면 세션 생성이 실패합니다.

비용이 발생하나요?

클라우드 브라우저 세션을 사용하므로 사용량에 따라 Browserbase 요금이 발생할 수 있습니다. 무료 한도와 요금 정책은 공식 문서·대시보드에서 확인하세요.