BrowserStack

Servidor MCP do BrowserStack

Plataforma de Testes Abrangente

Gerencie casos de teste, execute testes manuais ou automatizados, depure problemas e até mesmo corrija código — diretamente em ferramentas como Cursor, Claude ou qualquer cliente habilitado para MCP, usando inglês simples.

Teste de qualquer lugar:

Conecte facilmente a Plataforma de Testes BrowserStack às suas ferramentas de IA favoritas, como IDEs, LLMs ou fluxos de trabalho agentivos.

Teste com linguagem natural:

Gerencie, execute, depure testes e até mesmo corrija código usando prompts em inglês simples.

Troca de contexto reduzida:

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

⚡️ Configuração MCP com Um Clique

Clique nos botões abaixo para instalar o MCP no seu respectivo IDE:

   

Nota : Certifique-se de estar usando a versão do Node >= 18.0

• Verifique a versão do seu 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 Node.js LTS

.

💡 Exemplos de Uso

📱 Teste Manual de Aplicativos

Teste aplicativos móveis em dispositivos reais nas versões mais recentes do sistema operacional. Reproduza bugs e depure falhas sem complicações de configuração. Abaixo estão alguns exemplos de prompts para usar seus aplicativos móveis na extensa nuvem de dispositivos reais do 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?"

• Diferente de emuladores, teste o desempenho real do seu aplicativo em dispositivos reais. Com recursos avançados de Criação de Perfil de Aplicativo, você pode depurar falhas e problemas de desempenho em tempo real.
• Acesse todos os principais dispositivos e versões de sistema operacional da nossa grade de dispositivos. Temos SLAs rigorosos para provisionar nossos datacenters globais com dispositivos recém-lançados no dia do lançamento.

🌐 Teste Manual Web

Semelhante ao teste de aplicativos, você pode usar os seguintes prompts para testar seus websites na extensa nuvem de navegadores e dispositivos reais do BrowserStack. Não tem o navegador Edge instalado na sua máquina? Nós resolvemos isso para você!

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

• Teste websites em diferentes navegadores e dispositivos. Suportamos todos os principais navegadores em todos os principais sistemas operacionais.
• Teste websites hospedados localmente na sua máquina de forma transparente, sem necessidade de implantar em um servidor remoto!

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

Analise, diagnostique e até corrija automaticamente scripts de teste quebrados diretamente no seu IDE ou LLM. Obtenha logs instantaneamente, identifique as causas raiz e aplique correções sensíveis ao contexto. Chega de ciclos de depuração. Abaixo estão alguns exemplos de prompts para executar/depurar/corrigir seus testes automatizados na Plataforma de Testes do BrowserStack.

Nota: Ao buscar a Análise de Causa Raiz (RCA) para um teste, o servidor retorna a correção sugerida apenas como uma 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 utilizando nossos recursos líderes do setor de Observabilidade de Testes. Encontre mais informações aqui.
• Execute testes escritos em Jest, Playwright, Selenium e mais na Plataforma de Testes do BrowserStack

🌐 Acessibilidade

Detecte problemas de acessibilidade antecipadamente com varreduras a11y automatizadas e locais. Obtenha correções sugeridas por IA com um clique. Sem busca em documentação, sem surpresas na CI. Garanta a conformidade com WCAG e ADA com nossa ferramenta de Teste 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 acione execuções de teste usando linguagem natural. Abaixo estão alguns exemplos de prompts para utilizar os recursos do Gerenciamento de Testes do 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"

🧪 Acesse os agentes de IA do 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 do BrowserStack, perfeitamente integrados ao seu fluxo de trabalho. Abaixo estão alguns exemplos de prompts para acessar os agentes de IA do 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”

🛠️ Instalação

📋 Pré-requisitos para Configuração do MCP

Nota : Certifique-se de estar usando a versão do Node >= 18.0

• Verifique a versão do seu node usando node --version. Versão recomendada: v22.15.0 (LTS)

Configuração MCP com Um Clique

Clique nos botões abaixo para instalar o MCP no seu respectivo IDE:

   

Formas alternativas de configurar o servidor MCP

1. Crie uma Conta no BrowserStack

   • Cadastre-se no BrowserStack se você ainda não tem uma conta.

   • ℹ️ Se você tem um projeto de código aberto, podemos fornecer um plano gratuito.

   • Assim que tiver uma conta (e adquirido o plano apropriado), anote seu username e access_key nas Configurações da Conta.

2. Nota : Certifique-se de estar usando a versão do Node >= 18.0

   • Verifique a versão do seu node usando node --version. Versão recomendada: v22.15.0 (LTS)

3. Instale o Servidor MCP

   • VSCode (Copilot - Modo Agente): .vscode/mcp.json:

     • Localize ou Crie o Arquivo de Configuração: No diretório raiz do seu projeto, procure por uma pasta chamada .vscode. Esta pasta geralmente fica oculta, então você precisará encontrá-la conforme mencionado na expansão.

     • Se esta pasta não existir, crie-a.

     • Dentro da pasta .vscode, crie um novo arquivo chamado mcp.json

     • Adicione a Configuração: Abra o arquivo mcp.json e adicione o seguinte conteúdo JSON.

     • Substitua o nome de usuário e <access_key> pelas suas credenciais do BrowserStack.

   {
     "servers": {
       "browserstack": {
         "command": "npx",
         "args": ["-y", "@browserstack/mcp-server@latest"],
         "env": {
           "BROWSERSTACK_USERNAME": "<username>",
           "BROWSERSTACK_ACCESS_KEY": "<access_key>"
         }
       }
     }
   }
   

   • No VSCode, certifique-se de clicar no botão Start no Servidor MCP para iniciar o servidor.

   ** Forma alternativa de configurar o MCP no VSCode Copilot

   1.Clique no ícone de engrenagem para Selecionar Ferramentas

   
   2. Um menu de ferramentas aparecerá no centro superior, role para baixo no menu superior e clique em Adicionar Servidor MCP
   
   3. Selecione a opção de pacote NPM (Instalar a partir de um pacote NPM) - 3ª na lista
   
   4. Insira o Nome do Pacote NPM (@browserstack/mcp-server)
   
   5. Insira o nome de usuário e a chave de acesso do BrowserStack
   • Para Cursor: .cursor/mcp.json:

   {
     "mcpServers": {
       "browserstack": {
         "command": "npx",
         "args": ["-y", "@browserstack/mcp-server@latest"],
         "env": {
           "BROWSERSTACK_USERNAME": "<username>",
           "BROWSERSTACK_ACCESS_KEY": "<access_key>"
         }
       }
     }
   }
   

   • Claude Desktop: ~/claude_desktop_config.json:

   {
     "mcpServers": {
       "browserstack": {
         "command": "npx",
         "args": ["-y", "@browserstack/mcp-server@latest"],
         "env": {
           "BROWSERSTACK_USERNAME": "<username>",
           "BROWSERSTACK_ACCESS_KEY": "<access_key>"
         }
       }
     }
   }
   

   • Cline

Clique no ícone “Servidores MCP” na barra de navegação Selecione a aba “Instalado”. Clique no botão “Configurar Servidores MCP” na parte inferior do painel.

{
  "mcpServers": {
    "browserstack": {
      "command": "npx",
      "args": ["-y", "@browserstack/mcp-server@latest"],
      "env": {
        "BROWSERSTACK_USERNAME": "<username>",
        "BROWSERSTACK_ACCESS_KEY": "<access_key>"
      }
    }
  }
}

💡 Lista de Ferramentas MCP do BrowserStack

Atualmente, oferecemos suporte a 44 ferramentas.

Nota sobre MCP Remoto: Ferramentas marcadas (não disponível no MCP Remoto) dependem do estado de arquivos/processos locais e estão desabilitadas no Servidor MCP Remoto multi-inquilino. Elas estão disponíveis na configuração local (npx).

---

🧾 Gerenciamento de Testes

1. createProjectOrFolder — Cria um projeto de Gerenciamento de Testes e/ou pastas para organizar casos de teste. Retorna com o ID da Pasta, ID do Projeto e Link do Gerenciamento de Testes para acessar o Painel do Projeto TM. Exemplo de prompt

Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout

2. createTestCase — Adiciona um caso de teste manual em um projeto/pasta específico (usa identificador do projeto como PR-xxxxx e um ID de pasta). Exemplo de prompt

Add a test case named 'Invalid Login Scenario' to the Login folder in the 'Shopping App' project with PR-53617, Folder ID: 117869

3. updateTestCase — Atualiza um caso de teste existente. Qualquer subconjunto de campos pode ser alterado (nome, prioridade, status, etapas, tags, etc.); apenas os campos fornecidos são modificados. Exemplo de prompt

Update test case TC-482 in the 'Shopping App' project and set its priority to high

4. listTestCases — Lista casos de teste para um projeto, opcionalmente com escopo em uma pasta (suporta filtros como case_type, prioridade e paginação). Exemplo de prompt

List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457

5. listFolders — Lista pastas em um projeto de Gerenciamento de Testes (retorna o id, nome, contagens de casos e contagens de subpastas de cada pasta). Passe um parent_id para listar subpastas. Exemplo de prompt

List all folders in the 'Shopping App' project with project_identifier: PR-59457

6. listTestCaseTemplates — Lista modelos de caso de teste com seu template_id numérico, para uso com createTestCase para aplicar um modelo personalizado. Exemplo de prompt

List the available test case templates in the 'Shopping App' project

7. createTestRun — Cria uma execução de teste (suíte) para casos de teste selecionados em um projeto. Exemplo de prompt

Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'

8. listTestRuns — Lista execuções de teste para um projeto (filtra por datas, responsável, estado). Exemplo de prompt

List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress

9. updateTestRun — Atualiza o nome/estado de uma execução de teste e/ou adiciona casos de teste a ela. Exemplo de prompt

Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'

10. addTestResult — Adiciona um resultado de execução manual (aprovado/reprovado/bloqueado/pulado) para um caso de teste dentro de uma execução. Exemplo de prompt

Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project

11. createTestCasesFromFile — Gera casos de teste em massa a partir de um arquivo enviado usando o Agente de IA Gerador de Casos de Teste. (não disponível no MCP Remoto) Exemplo de prompt

Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management

12. listTestPlans — Lista planos de teste (TP-*) em um projeto, com nome, status, datas e contagens de execuções ativas/encerradas. Suporta paginação. Exemplo de prompt

List all test plans in the 'Shopping App' project with project_identifier: PR-59457

13. getTestPlan — Busca um plano de teste pelo identificador (TP-*) com seus metadados, execuções de teste vinculadas, contagem total de casos de teste e resumo de status. Exemplo de prompt

Get the details of test plan TP-120 in the 'Shopping App' project

14. listSubTestPlans — Lista subplanos de teste (STP-) sob um plano de teste pai (TP-). Suporta paginação. Exemplo de prompt

List sub-test-plans under test plan TP-120 in the 'Shopping App' project

15. getSubTestPlan — Busca um subplano de teste (STP-*) sob um plano pai, com seus metadados e execuções de teste vinculadas. Exemplo de prompt

Get sub-test-plan STP-45 under test plan TP-120 in the 'Shopping App' project

---

⚙️ Configuração do SDK do BrowserStack / Automatizar Teste

16. setupBrowserStackAutomateTests — Integra o SDK do BrowserStack e executa testes web no BrowserStack. Para testes visuais/Percy, use as ferramentas dedicadas do Percy. Exemplo de prompt

Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox.

17. fetchAutomationScreenshots — Busca capturas de tela capturadas durante uma determinada sessão do Automate/App Automate. Exemplo de prompt

Get screenshots from Automate session ID abc123xyz for my desktop test run

---

🔍 Observabilidade

18. getFailureLogs — Recupera logs de erro para sessões do Automate/App Automate (opcionalmente por ID de Build para App Automate). Exemplo de prompt

Get the error logs from the session ID: 21a864032a7459f1e7634222249b316759d6827f, Build ID: dt7ung4wmjittzff8kksrjadjax9gzvbscoyf9qn of App Automate test session

19. fetchBuildInsights — Busca insights sobre uma build do BrowserStack combinando detalhes da build e resultados do quality-gate. Exemplo de prompt

Get the build insights for build UUID <your-build-uuid> on BrowserStack

---

📱 App Live

20. runAppLiveSession — Inicia uma sessão de teste manual de aplicativo em um dispositivo real na nuvem. Exemplo de prompt

Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa

---

💻 Live

21. runBrowserLiveSession — Inicia uma sessão Live para teste de website em navegadores desktop ou móveis. Exemplo de prompt

Open www.google.com on the latest version of Microsoft Edge on Windows 11

---

📲 App Automate

22. takeAppScreenshot — Inicia o aplicativo em um dispositivo especificado e captura uma captura de tela de verificação rápida para confirmar que seu aplicativo foi iniciado. Exemplo de prompt

Take a screenshot of my app on Google Pixel 6 with Android 12 while testing on App Automate. App file path: /Users/xyz/app-debug.apk

23. runAppTestsOnBrowserStack — Executa suítes de teste móveis nativas pré-construídas (Espresso/XCUITest) por upload direto de arquivos de teste .apk/.ipa compilados. Exemplo de prompt

Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 12. App path is /apps/beta-release.apk under project 'Checkout Flow'

24. setupBrowserStackAppAutomateTests — Configura a integração do SDK do BrowserStack App Automate para testes de aplicativos móveis baseados em Appium. Exemplo de prompt

Set up my Appium test suite to run on BrowserStack App Automate

---

♿ Acessibilidade

25. accessibilityExpert — Pergunte ao Especialista A11y (WCAG 2.0/2.1/2.2, usabilidade mobile/web, melhores práticas). Exemplo de prompt

What WCAG guidelines apply to form field error messages on mobile web?

26. startAccessibilityScan — Inicia uma varredura de acessibilidade web e recupera o caminho de um relatório CSV local. Exemplo de prompt

Run accessibility scan for "www.example.com"

27. createAccessibilityAuthConfig — Cria uma configuração de autenticação (baseada em formulário ou básica) para varreduras de acessibilidade protegidas por login. Exemplo de prompt

Create a basic-auth accessibility config named 'site-login' for https://www.example.com with username testuser and password <password>

28. getAccessibilityAuthConfig — Recupera uma configuração de autenticação de acessibilidade existente pelo ID. Exemplo de prompt

Get accessibility auth config with ID <config-id>

29. fetchAccessibilityIssues — Busca problemas de acessibilidade de uma varredura concluída, com suporte a paginação. Exemplo de prompt

Fetch the accessibility issues for scan ID <scan-id> and scan run ID <scan-run-id>

---

🎨 Testes Visuais Percy

30. percyVisualTestIntegrationAgent — Integra testes visuais Percy em um novo projeto e demonstra a detecção de mudanças visuais com uma simulação passo a passo. Exemplo de prompt

Integrate Percy for this project

31. expandPercyVisualTesting — Configura ou expande a cobertura de testes visuais Percy para projetos existentes (Percy Web Standalone e Percy Automate). Exemplo de prompt

Expand Percy coverage for this project

32. addPercySnapshotCommands — Adiciona comandos de snapshot Percy aos arquivos de teste especificados. (não disponível no MCP Remoto) Exemplo de prompt

Add Percy snapshot commands to my Cypress test files

33. listTestFiles — Lista todos os arquivos de teste para um determinado conjunto de diretórios. (não disponível no MCP Remoto) Exemplo de prompt

List the test files under my ./tests directory

34. runPercyScan — Executa uma varredura de teste visual Percy. (não disponível no MCP Remoto) Exemplo de prompt

Run this Percy build

35. fetchPercyChanges — Recupera e resume as mudanças visuais detectadas pela IA do Percy entre a build mais recente e a anterior. Exemplo de prompt

Summarize the visual changes Percy detected in my latest build

36. managePercyBuildApproval — Aprova ou rejeita uma build Percy. Exemplo de prompt

Approve the latest Percy build

---

🤖 Agentes de IA do BrowserStack

37. uploadProductRequirementFile — Faz upload de um PRD/captura de tela/PDF e obtém um ID de mapeamento de arquivo (usado com createTestCasesFromFile). (não disponível no MCP Remoto) Exemplo de prompt

Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases

38. createLCASteps — Gera etapas de Automação de Baixo Código (LCA) a partir de um caso de teste manual no Gerenciamento de Testes. Exemplo de prompt

Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps

39. fetchSelfHealedSelectors — Recupera seletores auto-reparados por IA (mais código-fonte do teste) para corrigir testes instáveis causados por mudanças no DOM. Exemplo de prompt

Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP

40. prepareSelfHealingPlan — Constrói um plano de edição auto-reparável que agrupa pares de localizadores com código-fonte do teste para seu LLM aplicar. NÃO modifica os arquivos por conta própria. Exemplo de prompt

Prepare a self-healing plan from the self-healed selectors for my build

41. fetchRCA — Busca a Análise de Causa Raiz por IA para seus testes com falha no Automate/App-Automate (pelo ID numérico do teste). Apenas sugere correções; nunca as aplica automaticamente. Exemplo de prompt

Fetch the root cause analysis for failed test IDs 101 and 102 on BrowserStack

42. getBuildId — Obtém o ID da build do BrowserStack para um determinado projeto e nome de build, limitado às suas builds. Exemplo de prompt

Get the build ID for build 'nightly-regression' in project 'Checkout Flow'

43. listBuildId — Obtém o ID da build mais recente para um projeto e nome de build, entre todos os usuários (sem filtro de usuário). Exemplo de prompt

Get the latest build ID for build 'nightly-regression' in project 'Checkout Flow'

44. listTestIds — Lista IDs de teste de uma build do BrowserStack Automate, filtrados por status (passed/failed/pending/skipped). Exemplo de prompt

List the failed test IDs from build UUID <your-build-uuid> on BrowserStack

🚀 Servidor MCP Remoto

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

Principais benefícios:

• ✅ Funciona perfeitamente em redes corporativas sem se preocupar com firewalls, binários ou onde a instalação local não é permitida.

• ✅ Integração OAuth segura – sem compartilhamento de senhas ou manuseio manual de credenciais.

Limitações:

• ❌ Sem suporte a Testes Locais (não é possível testar aplicativos atrás de VPNs, firewalls ou localhost). Se você precisar fazer Testes Locais, terá que usar um servidor MCP Local do BrowserStack.
• ❌ A latência pode ser um pouco maior, mas nada considerável — você geralmente não notará no uso normal.

Etapas de Instalação:

• No VSCode (Copilot - Modo Agente): .vscode/mcp.json:

  • Localize ou Crie o Arquivo de Configuração:

  • No diretório raiz do seu projeto, procure por uma pasta chamada .vscode. Esta pasta geralmente fica oculta, então você precisará encontrá-la conforme mencionado na expansão.

  • Se esta pasta não existir, crie-a.

  • Dentro da pasta .vscode, crie um novo arquivo chamado mcp.json

  • Para configurar o MCP Remoto do BrowserStack em vez do MCP Local do BrowserStack, você pode adicionar o seguinte conteúdo JSON:

    

    Maneira alternativa de configurar o MCP Remoto

  • Passo 1. Clique no ícone de engrenagem para Selecionar Ferramentas

    

  • Passo 2. Um menu de ferramentas aparecerá no centro superior, role para baixo no menu no topo e clique em Adicionar Servidor MCP

  

  • Passo 3. Clique na opção HTTP

    

  • Passo 4. Cole a URL do Servidor MCP Remoto: https://mcp.browserstack.com/mcp

    

  • Passo 5. Forneça o ID do servidor como: browserstack

    

  • Passo 6. No VSCode, clique em Iniciar Servidor MCP e depois clique em "Permitir"

    
    
    

🤝 Clientes MCP Recomendados

• Recomendamos usar Github Copilot ou Cursor para casos de uso de teste automatizado + depuração.
• Para casos de uso de teste manual (Teste ao Vivo), recomendamos usar Claude Desktop.

⚠️ Notas Importantes

• O Servidor MCP do BrowserStack está em desenvolvimento ativo e atualmente suporta um subconjunto da especificação MCP. Mais recursos serão adicionados em breve.
• As invocações de ferramentas dependem do Cliente MCP, que por sua vez depende de um LLM, portanto, pode haver algum comportamento não determinístico que pode levar a resultados inesperados. Se você tiver alguma sugestão ou feedback, por favor, abra uma issue para discutir.

📝 Contribuindo

Contribuições são bem-vindas! Por favor, abra uma issue para discutir quaisquer mudanças que você gostaria de fazer. 👉 Clique aqui para ver nossas Diretrizes de Contribuição

📞 Suporte

Para suporte, por favor:

• Abra uma issue em nosso repositório GitHub se você enfrentar quaisquer problemas relacionados ao Servidor MCP.
• Entre em contato com nossa equipe de suporte para quaisquer outras dúvidas.

🚀 Mais Recursos em Breve

Fique ligado para atualizações empolgantes! Tem alguma sugestão? Por favor, abra uma issue para discutir.