BrowserStack

BrowserStack MCP Server

Plataforma de testes abrangente

Gerencie casos de teste, execute testes manuais ou automatizados, depure problemas e até corrija código — diretamente em ferramentas como Cursor, Claude ou qualquer cliente compatível com MCP, usando linguagem simples.

Teste de qualquer lugar:

Conecte facilmente a BrowserStack Test Platform às suas ferramentas de IA favoritas, como IDEs, LLMs ou fluxos de trabalho agênticos.

Teste com linguagem natural:

Gerencie, execute e depure testes, e até corrija código usando comandos em linguagem simples.

Menos alternância de contexto:

Mantenha o fluxo — reúna todo o contexto do projeto em um só lugar e acione ações diretamente na sua IDE ou LLM.

⚡️ Configuração do MCP com um clique

Clique nos botões abaixo para instalar o MCP na sua IDE ou assistente:

        

Observação: O servidor MCP remoto hospedado (mcp.browserstack.com) agora é totalmente sem estado via Streamable HTTP — qualquer cliente Streamable-HTTP (Claude, Cursor, VS Code, ChatGPT) se conecta sem precisar alterar a configuração.

Kiro: há um power do Kiro para este servidor em integrations/kiro-power. Na IDE Kiro, abra o painel Powers → Add Custom Power → Import power from GitHub e informe https://github.com/browserstack/mcp-server/tree/main/integrations/kiro-power, ou clone este repositório e use Import power from a folder com esse diretório.

Pré-requisitos

• Uma conta BrowserStack. Cadastre-se se ainda não tiver uma; projetos de código aberto podem obter um plano gratuito.
• Seu username e access_key em Account Settings.

Para configurar manualmente em qualquer cliente MCP, consulte Instalar o servidor MCP localmente ou Configurar o servidor MCP remoto.

Observação: verifique se está usando a versão do Node >= 22

• Verifique sua versão do Node usando node --version. Versão recomendada: v22.15.0 (LTS)
• Para atualizar o Node:
• 1. No 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. No Windows (nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0
• 👉 Ou baixe diretamente o instalador LTS do Node.js

🪄 Configuração assistida por agente

A maioria dos agentes de IA pode adicionar o servidor MCP da BrowserStack, conectar-se a ele e orientar você durante o login sem configuração manual. Cole este comando no seu agente:

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.

Para adicioná-lo por conta própria, use o comando ou menu do seu cliente:

Cliente	Comando ou configuração
Claude Code	claude mcp add --scope user --transport http browserstack https://mcp.browserstack.com/mcp, depois execute /mcp em uma sessão e faça login
Claude Desktop / claude.ai	Settings → Connectors → Add custom connector, com a URL https://mcp.browserstack.com/mcp
ChatGPT	Instale o plugin da BrowserStack
Codex	codex mcp add browserstack --url https://mcp.browserstack.com/mcp, depois codex mcp login browserstack para fazer login
VS Code / GitHub Copilot	code --add-mcp '{"name":"browserstack","type":"http","url":"https://mcp.browserstack.com/mcp"}', depois inicie o servidor na visualização MCP e faça login
Cursor	Adicione "browserstack": { "url": "https://mcp.browserstack.com/mcp" } em mcpServers em ~/.cursor/mcp.json, depois faça login em Cursor Settings → MCP
Qualquer outro cliente MCP	Aponte-o para https://mcp.browserstack.com/mcp

💡 Exemplos de uso

📱 Testes manuais de aplicativos

Teste aplicativos móveis em dispositivos reais com as versões mais recentes dos sistemas operacionais. Reproduza bugs e depure falhas sem complicações de configuração. Abaixo estão alguns exemplos de comandos para testar seus aplicativos na ampla nuvem de dispositivos reais da 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?"

• Ao contrário dos emuladores, teste o desempenho do seu aplicativo no mundo real, em dispositivos reais. Com os recursos avançados de App-Profiling, você pode depurar falhas e problemas de desempenho em tempo real.
• Acesse os principais dispositivos e versões de sistemas operacionais na nossa grade de dispositivos. Temos SLAs rigorosos para disponibilizar dispositivos recém-lançados em nossos datacenters globais no dia do lançamento.

🌐 Testes manuais na Web

Assim como nos testes de aplicativos, você pode usar os comandos a seguir para testar seus sites na ampla nuvem de navegadores e dispositivos reais da BrowserStack. Não tem o navegador Edge instalado na sua máquina? Nós ajudamos!

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

• Teste sites em diferentes navegadores e dispositivos. Oferecemos suporte a todos os principais navegadores nos principais sistemas operacionais.
• Teste facilmente sites hospedados localmente na sua máquina, sem precisar implantá-los em um servidor remoto!

🧪 Testes automatizados (Playwright, Selenium, A11y e mais...)

Analise, diagnostique e até corrija automaticamente scripts de teste com falhas diretamente na sua IDE ou LLM. Busque logs instantaneamente, identifique as causas raiz e aplique correções contextualizadas. Chega de ciclos intermináveis de depuração. Abaixo estão alguns exemplos de comandos para executar, depurar e corrigir seus testes automatizados na Test Platform da BrowserStack.

Observação: Ao buscar a análise da causa raiz (RCA) de um teste, o servidor retorna a correção sugerida apenas como proposta. Ele nunca aplica alterações de código automaticamente — seu assistente deve apresentar a sugestão e aguardar sua aprovação explícita antes de editar qualquer arquivo.

#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?"

• Corrija falhas de teste relatadas pelo seu pipeline de CI/CD usando os recursos líderes do setor de Test Observability. Saiba mais aqui.
• Execute testes escritos em Jest, Playwright, Selenium e outras ferramentas na Test Platform da BrowserStack.

🌐 Acessibilidade

Identifique problemas de acessibilidade antecipadamente com verificações a11y locais automatizadas. Obtenha correções sugeridas por IA com um clique. Sem precisar procurar na documentação nem enfrentar surpresas no CI. Garanta a conformidade com WCAG e ADA usando nossa ferramenta de testes de acessibilidade.

#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”

📋 Gerenciamento de testes

Crie e gerencie casos de teste, crie planos de teste e inicie execuções de teste usando linguagem natural. Abaixo estão alguns exemplos de comandos para usar os recursos do Test Management da BrowserStack com o servidor MCP.

# 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"

⚡ Testes de carga

Execute e analise testes de carga em grande escala sem sair da sua IDE ou conversa — encontre testes, inicie e interrompa execuções, leia relatórios e insights de IA, compare execuções e consulte suas horas de VU. Compatível com testes de carga de API (JMeter, k6, Gatling, Locust), navegador (Playwright, Selenium, WebdriverIO, Nightwatch) e híbridos na Load Testing da BrowserStack. Eles usam as ferramentas principais.

# 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?"

🧪 Acesse os agentes de IA da BrowserStack

Gere casos de teste a partir de PRDs, converta testes manuais em automação low-code e corrija automaticamente scripts instáveis com os agentes de IA da BrowserStack, integrados perfeitamente ao seu fluxo de trabalho. Abaixo estão alguns exemplos de comandos para acessar os agentes de IA da BrowserStack.

#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”

🧭 Ferramentas principais

Cinco ferramentas principais permitem que seu assistente de IA encontre e execute qualquer fluxo de trabalho da BrowserStack. Seu assistente carrega todas as ferramentas expostas por um servidor MCP no início de cada sessão; portanto, uma ferramenta para cada fluxo de trabalho ocuparia toda a janela de contexto e deixaria a sessão inteira mais lenta. Em vez disso, seu assistente usa as ferramentas principais para pesquisar um catálogo de ferramentas da BrowserStack em linguagem simples e executar a ferramenta necessária.

Ferramenta	Descrição
listProducts	Lista os produtos da BrowserStack no catálogo, com um breve resumo do que cada produto oferece
describeEntity	Explica uma entidade: seus aliases, formato de ID, entidade principal e entidades relacionadas, além dos recursos que atuam sobre ela
searchCapability	Encontra os recursos correspondentes a uma solicitação em linguagem simples, com tudo de que seu assistente precisa para executar cada um
describeCapability	Retorna todos os detalhes de um recurso, como parâmetros, corpo da solicitação e formato da resposta
invokeCapability	Executa um recurso e retorna a resposta do produto sem alterações. Alterações nos dados precisam da sua aprovação

Consulte Ferramentas principais para ver os parâmetros e saber como as alterações nos dados são aprovadas.

Todas as ferramentas — Consulte docs/TOOLS.md para ver todas as ferramentas organizadas por produto ou Ferramentas e fluxos de trabalho do BrowserStack MCP para conhecer os fluxos de trabalho dos produtos.

Uploads de arquivos e aplicativos: as ferramentas que enviam um arquivo/aplicativo local (uploadProductRequirementFile, takeAppScreenshot, runAppTestsOnBrowserStack, runAppLiveSession) exigem que a variável de ambiente MCP_UPLOAD_BASE_DIR esteja definida como um diretório que contenha esses arquivos; os uploads ficam restritos a ele.

🚀 Servidor MCP remoto

O MCP remoto oferece todas as funcionalidades de um servidor MCP sem as complicações de uma configuração complexa ou instalação local.

Principais benefícios:

• ✅ Funciona perfeitamente em redes corporativas, sem preocupações com firewalls, binários ou restrições à instalação local.

• ✅ Integração segura com OAuth — sem compartilhamento de senhas ou gerenciamento manual de credenciais.

Limitações:

• ❌ Não oferece suporte a testes locais (não é possível testar aplicativos atrás de VPNs, firewalls ou em localhost). Se precisar fazer testes locais, use um servidor MCP local da BrowserStack.
• ❌ A latência pode ser um pouco maior, mas a diferença é insignificante — geralmente você não vai notar durante o uso normal.

⚠️ Observações importantes

• O servidor MCP da BrowserStack está em desenvolvimento ativo e atualmente oferece suporte a um subconjunto da especificação MCP. Mais recursos serão adicionados em breve.
• As chamadas de ferramentas dependem do cliente MCP, que por sua vez depende de um LLM; por isso, pode haver comportamentos não determinísticos que levem a resultados inesperados. Se tiver sugestões ou comentários, abra uma issue para conversar sobre eles.

📝 Contribuições

Contribuições são bem-vindas! Abra uma issue para conversar sobre as alterações que gostaria de fazer. 👉 Clique aqui para ver nossas diretrizes de contribuição

📞 Suporte

Para obter suporte:

• Abra uma issue no nosso repositório do GitHub se tiver algum problema relacionado ao servidor MCP.
• Entre em contato com nossa equipe de suporte para outras dúvidas.
• Envie um e-mail para support@browserstack.com.
• Política de privacidade: browserstack.com/privacy.

🚀 Mais recursos em breve

Fique de olho nas novidades! Tem alguma sugestão? Abra uma issue para conversar sobre ela.