BrowserStack

BrowserStack MCP Server

종합 테스트 플랫폼

Cursor, Claude 또는 MCP를 지원하는 클라이언트와 같은 도구에서 자연어를 사용해 테스트 케이스를 관리하고, 수동 또는 자동 테스트를 실행하고, 문제를 디버깅하고, 코드까지 수정할 수 있습니다.

어디서나 테스트:

BrowserStack Test Platform을 IDE, LLM 또는 에이전트 워크플로와 같은 즐겨 사용하는 AI 도구에 쉽게 연결하세요.

자연어로 테스트:

자연어 프롬프트를 사용해 테스트를 관리하고 실행 및 디버깅하고, 코드까지 수정하세요.

컨텍스트 전환 감소:

작업 흐름을 유지하세요. 모든 프로젝트 컨텍스트를 한곳에 모으고 IDE 또는 LLM에서 직접 작업을 실행하세요.

⚡️ 원클릭 MCP 설정

아래 버튼을 클릭해 사용하는 IDE 또는 어시스턴트에 MCP를 설치하세요.

        

참고: 호스팅된 Remote MCP 서버(mcp.browserstack.com)는 이제 Streamable HTTP를 통해 완전히 무상태로 작동합니다. 모든 Streamable-HTTP 클라이언트(Claude, Cursor, VS Code, ChatGPT)가 설정을 변경하지 않고 연결할 수 있습니다.

Kiro: 이 서버용 Kiro 파워는 integrations/kiro-power에 있습니다. Kiro IDE에서 Powers 패널을 열고 → Add Custom Power → Import power from GitHub를 선택한 다음 https://github.com/browserstack/mcp-server/tree/main/integrations/kiro-power을 입력하세요. 또는 이 저장소를 클론하고 해당 디렉터리에서 Import power from a folder를 사용하세요.

사전 요구 사항

• BrowserStack 계정. 계정이 없다면 가입하세요. 오픈 소스 프로젝트는 무료 플랜을 이용할 수 있습니다.
• 계정 설정에서 username 및 access_key을 확인하세요.

MCP 클라이언트에서 수동으로 설정하려면 MCP 서버를 로컬에 설치하거나 원격 MCP 서버 설정을 참조하세요.

참고: Node 버전이 >= 22인지 확인하세요

• node --version을 사용해 Node 버전을 확인하세요. 권장 버전: v22.15.0 (LTS)
• Node 업그레이드 방법:
• 1. macOS에서 (Homebrew) - brew update && brew upgrade node or if using (nvm) - nvm install 22.15.0 && nvm use 22.15.0 && nvm alias default 22.15.0
• 2. Windows에서 (nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0
• 👉 또는 Node.js LTS 설치 프로그램을 직접 다운로드하세요

🪄 에이전트 지원 설정

대부분의 AI 에이전트는 BrowserStack MCP 서버를 추가하고 연결한 뒤, 수동 설정 없이 로그인 과정을 안내할 수 있습니다. 다음 프롬프트를 에이전트에 붙여 넣으세요.

Add the BrowserStack MCP server to this agent, following the setup guide at
https://www.browserstack.com/docs/browserstack-mcp-server/get-started/remote-mcp-server
and using the server URL https://mcp.browserstack.com/mcp. Once it is added, start the
BrowserStack sign-in flow so I can log in.

직접 추가하려면 클라이언트의 명령 또는 메뉴를 사용하세요.

클라이언트	명령 또는 설정
Claude Code	claude mcp add --scope user --transport http browserstack https://mcp.browserstack.com/mcp, 그런 다음 세션에서 /mcp을 실행하고 로그인
Claude Desktop / claude.ai	Settings → Connectors → Add custom connector를 선택하고 URL로 https://mcp.browserstack.com/mcp 입력
ChatGPT	BrowserStack 플러그인 설치
Codex	codex mcp add browserstack --url https://mcp.browserstack.com/mcp, 그런 다음 로그인하려면 codex mcp login browserstack
VS Code / GitHub Copilot	code --add-mcp '{"name":"browserstack","type":"http","url":"https://mcp.browserstack.com/mcp"}', 그런 다음 MCP 보기에서 서버를 시작하고 로그인
Cursor	~/.cursor/mcp.json의 mcpServers 아래에 "browserstack": { "url": "https://mcp.browserstack.com/mcp" } 추가한 다음 Cursor Settings → MCP에서 로그인
기타 MCP 클라이언트	https://mcp.browserstack.com/mcp을 지정

💡 사용 예시

📱 수동 앱 테스트

최신 OS 버전을 실행하는 실제 기기에서 모바일 앱을 테스트하세요. 번거로운 설정 없이 버그를 재현하고 충돌을 디버깅할 수 있습니다. 아래는 BrowserStack의 방대한 실제 기기 클라우드에서 모바일 앱을 테스트할 때 사용할 수 있는 프롬프트 예시입니다.

# Open app on specific device
"open my app on a iPhone 15 Pro Max"

# Debug app crashes
"My app crashed on Android 14 device, can you help me debug?"

• 에뮬레이터와 달리 실제 기기에서 앱의 실제 성능을 테스트하세요. 고급 앱 프로파일링 기능을 사용하면 충돌과 성능 문제를 실시간으로 디버깅할 수 있습니다.
• 기기 그리드에서 주요 기기와 OS 버전을 모두 이용하세요. 새로 출시되는 기기를 출시 당일 글로벌 데이터센터에 제공하기 위해 엄격한 SLA를 준수합니다.

🌐 수동 웹 테스트

앱 테스트와 마찬가지로 다음 프롬프트를 사용해 BrowserStack의 방대한 실제 브라우저 및 기기 클라우드에서 웹사이트를 테스트할 수 있습니다. 컴퓨터에 Edge 브라우저가 설치되어 있지 않나요? 걱정하지 마세요!

# Test your websites
"open my website hosted on localhost:3001 on Edge"
"open browserstack.com on latest version of Chrome"

• 다양한 브라우저와 기기에서 웹사이트를 테스트하세요. 주요 OS에서 모든 주요 브라우저를 지원합니다.
• 컴퓨터에서 로컬로 호스팅되는 웹사이트도 원활하게 테스트할 수 있습니다. 원격 서버에 배포할 필요가 없습니다!

🧪 자동 테스트(Playwright, Selenium, A11y 등)

IDE 또는 LLM에서 바로 실패한 테스트 스크립트를 자동으로 분석하고 진단하며 수정할 수도 있습니다. 로그를 즉시 가져오고, 근본 원인을 파악하고, 컨텍스트에 맞는 수정 사항을 적용하세요. 더 이상 디버깅을 반복할 필요가 없습니다. 아래는 BrowserStack의 Test Platform에서 자동 테스트를 실행, 디버깅 또는 수정할 때 사용할 수 있는 프롬프트 예시입니다.

참고: 테스트의 근본 원인 분석(RCA)을 가져오면 서버는 제안된 수정 사항을 제안으로만 반환합니다. 코드 변경 사항을 자동으로 적용하지 않습니다. 어시스턴트는 파일을 수정하기 전에 제안 내용을 제시하고 명시적인 승인을 기다려야 합니다.

#Port test suite to BrowserStack
"Setup test suite to run on BrowserStack infra"

#Run tests on BrowserStack
“Run my tests on BrowserStack”

#AI powered debugging of test failures
"My App Automate tests have failed, can you help me fix the new failures?"

• 업계 최고 수준의 Test Observability 기능을 활용해 CI/CD 파이프라인에서 보고된 테스트 실패를 수정하세요. 자세한 내용은 여기에서 확인하세요.
• Jest, Playwright, Selenium 등으로 작성한 테스트를 BrowserStack의 Test Platform에서 실행하세요.

🌐 접근성

자동화된 로컬 접근성(a11y) 검사로 접근성 문제를 조기에 발견하세요. AI가 제안하는 수정 사항을 원클릭으로 적용할 수 있습니다. 문서를 찾아 헤매거나 CI에서 예상치 못한 문제를 겪을 필요가 없습니다. Accessibility Testing 도구로 WCAG 및 ADA 규정을 준수하세요.

#Scan accessibility issues while development
"Scan & help fix accessibility issues for my website running locally on localhost:3000"

#Scan accessibility issues on production site
“Run accessibility scan & identify issues on my website - www.bstackdemo.com”

📋 테스트 관리

자연어를 사용해 테스트 케이스를 만들고 관리하고, 테스트 계획을 작성하고, 테스트 실행을 시작하세요. 아래는 MCP 서버를 통해 BrowserStack의 Test Management 기능을 활용하는 프롬프트 예시입니다.

# Create project & folder structure
"create new Test management project named My Demo Project with two sub folders - Login & Checkout"

# Add test cases
"add invalid login test case in Test Management project named My Demo Project"

# List added test cases 
"list high priority Login test cases from Test Management project - My Demo Project"

# Create test run
"create a test run for Login tests from Test Management project - My Demo Project"

# Update test results
"update test results as passed for Login tests test run from My Demo Project"

⚡ 부하 테스트

IDE나 채팅을 벗어나지 않고 대규모 부하 테스트를 실행하고 분석하세요. 테스트를 찾고, 실행을 시작 및 중지하고, 보고서와 AI 인사이트를 확인하고, 실행을 비교하고, VU-hours를 확인할 수 있습니다. BrowserStack의 Load Testing에서 API(JMeter, k6, Gatling, Locust), 브라우저(Playwright, Selenium, WebdriverIO, Nightwatch) 및 하이브리드 부하 테스트를 지원합니다. 이러한 작업은 핵심 도구를 통해 수행됩니다.

# Find a test
"find my load test called checkout-api"

# Run it
"run checkout-api for 5 minutes with 100 virtual users"

# Check on it
"is my checkout-api run finished yet?"

# Read the results
"what was the p95 response time and error rate of the last checkout-api run?"

# Compare two runs of the same test
"did the latest checkout-api run regress compared with the previous one?"

# Check quota before a big run
"how many VU-hours do I have left, and what would a 30-minute run with 500 VUs cost?"

🧪 BrowserStack AI 에이전트 사용

BrowserStack의 AI 에이전트를 활용해 PRD에서 테스트 케이스를 생성하고, 수동 테스트를 로우 코드 자동화로 변환하고, 불안정한 스크립트를 자동으로 복구하세요. 워크플로에 원활하게 통합됩니다. 아래는 BrowserStack AI 에이전트를 사용하는 프롬프트 예시입니다.

#Test case generator agent
"With Browserstack AI, create relevant test cases for my PRD located at /usr/file/location"


#Low code authoring agent
“With Browserstack AI, automate my manual test case X, added in Test Management”


#Self healing agent
“Help fix flaky tests in my test script with Browserstack AI self healing”

🧭 핵심 도구

다섯 가지 핵심 도구를 사용하면 AI 어시스턴트가 BrowserStack 워크플로를 찾아 실행할 수 있습니다. MCP 서버가 노출하는 모든 도구는 각 세션이 시작될 때 어시스턴트에 로드됩니다. 따라서 워크플로마다 도구를 하나씩 두면 컨텍스트 창을 가득 채우고 전체 세션을 느리게 만들 수 있습니다. 대신 어시스턴트는 핵심 도구를 사용해 자연어로 BrowserStack 도구 카탈로그를 검색하고 필요한 도구를 실행합니다.

도구	설명
listProducts	카탈로그에 있는 BrowserStack 제품과 각 제품의 기능에 대한 간략한 요약을 나열합니다
describeEntity	하나의 엔터티에 대해 별칭, ID 형식, 상위 및 관련 엔터티, 해당 엔터티에 적용되는 기능을 설명합니다
searchCapability	자연어 요청에 맞는 기능을 찾고, 각 기능을 실행하는 데 필요한 모든 정보를 제공합니다
describeCapability	매개변수, 요청 본문, 응답 형식 등 하나의 기능에 대한 전체 세부 정보를 반환합니다
invokeCapability	하나의 기능을 실행하고 제품의 응답을 변경 없이 반환합니다. 데이터 변경에는 승인이 필요합니다

매개변수와 데이터 변경 승인 방법은 핵심 도구를 참조하세요.

모든 도구 — 제품별로 정리된 전체 도구 목록은 docs/TOOLS.md를, 제품 워크플로는 BrowserStack MCP 도구 및 워크플로를 참조하세요.

파일 및 앱 업로드: 로컬 파일/앱을 업로드하는 도구(uploadProductRequirementFile, takeAppScreenshot, runAppTestsOnBrowserStack, runAppLiveSession)를 사용하려면 해당 파일이 들어 있는 디렉터리로 MCP_UPLOAD_BASE_DIR 환경 변수를 설정해야 합니다. 업로드는 해당 디렉터리로 제한됩니다.

🚀 원격 MCP 서버

Remote MCP는 복잡한 설정이나 로컬 설치의 번거로움 없이 MCP 서버의 모든 기능을 제공합니다.

주요 이점:

• ✅ 방화벽, 바이너리 또는 로컬 설치가 허용되지 않는 환경을 걱정할 필요 없이 엔터프라이즈 네트워크에서 원활하게 작동합니다.

• ✅ 안전한 OAuth 통합 — 비밀번호 공유나 수동 자격 증명 처리가 필요하지 않습니다.

제한 사항:

• ❌ 로컬 테스트를 지원하지 않습니다(VPN, 방화벽 또는 localhost 뒤에 있는 앱은 테스트할 수 없음). 로컬 테스트가 필요한 경우 BrowserStack Local MCP 서버를 사용해야 합니다.
• ❌ 지연 시간이 약간 더 길 수 있지만 큰 차이는 없습니다. 일반적으로 사용 중에는 알아차리지 못합니다.

⚠️ 중요 참고 사항

• BrowserStack MCP Server는 활발히 개발 중이며 현재 MCP 사양의 일부를 지원합니다. 더 많은 기능이 곧 추가될 예정입니다.
• 도구 호출은 MCP 클라이언트에 의존하며, MCP 클라이언트는 다시 LLM에 의존합니다. 따라서 비결정적 동작으로 인해 예상치 못한 결과가 발생할 수 있습니다. 제안이나 의견이 있다면 이슈를 열어 논의해 주세요.

📝 기여

기여를 환영합니다! 변경 사항을 제안하려면 이슈를 열어 논의해 주세요. 👉 기여 가이드라인을 보려면 여기를 클릭하세요

📞 지원

지원이 필요하면 다음을 이용하세요.

• MCP Server 관련 문제가 있으면 GitHub 저장소에서 이슈를 여세요.
• 기타 문의 사항은 지원팀에 문의하세요.
• 이메일: support@browserstack.com.
• 개인정보 처리방침: browserstack.com/privacy.

🚀 더 많은 기능이 곧 제공됩니다

새로운 업데이트를 기대해 주세요! 제안이 있으신가요? 이슈를 열어 논의해 주세요.