BrowserStack

BrowserStack MCP Server

Комплексная платформа для тестирования

Управляйте тест-кейсами, выполняйте ручные или автоматизированные тесты, отлаживайте проблемы и даже исправляйте код — непосредственно в таких инструментах, как Cursor, Claude или любом клиенте с поддержкой MCP, используя простой английский язык.

Тестируйте откуда угодно:

Легко подключайте тестовую платформу BrowserStack к вашим любимым ИИ-инструментам, таким как IDE, LLM или агентные рабочие процессы.

Тестируйте на естественном языке:

Управляйте, выполняйте, отлаживайте тесты и даже исправляйте код с помощью подсказок на простом английском языке.

Меньше переключений контекста:

Оставайтесь в потоке — храните весь контекст проекта в одном месте и запускайте действия прямо из вашей IDE или LLM.

⚡️ Настройка MCP в один клик

Нажмите на кнопки ниже, чтобы установить MCP в вашу IDE:

   

Примечание: Убедитесь, что вы используете Node версии >= 18.0

• Проверьте версию Node с помощью node --version. Рекомендуемая версия: 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 напрямую

.

💡 Примеры использования

📱 Ручное тестирование приложений

Тестируйте мобильные приложения на реальных устройствах с последними версиями ОС. Воспроизводите ошибки и отлаживайте сбои без проблем с настройкой. Ниже приведены примеры запросов для использования ваших мобильных приложений в обширном облаке реальных устройств 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?"

• В отличие от эмуляторов, тестируйте реальную производительность вашего приложения на настоящих устройствах. С расширенными функциями профилирования приложений вы можете отлаживать сбои и проблемы с производительностью в реальном времени.
• Получите доступ ко всем основным устройствам и версиям ОС из нашей сетки устройств. У нас есть строгие SLA для обеспечения наших глобальных дата-центров новыми устройствами в день запуска.

🌐 Ручное веб-тестирование

Как и в случае с тестированием приложений, вы можете использовать следующие запросы для тестирования ваших веб-сайтов в обширном облаке реальных браузеров и устройств BrowserStack. У вас на компьютере не установлен браузер Edge? Мы вас прикроем!

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

• Тестируйте веб-сайты в разных браузерах и на разных устройствах. Мы поддерживаем все основные браузеры на всех основных ОС.
• Легко тестируйте веб-сайты, размещенные локально на вашем компьютере, без необходимости развертывания на удаленном сервере!

🧪 Автоматизированное тестирование (Playwright, Selenium, A11y и многое другое...)

Автоматически анализируйте, диагностируйте и даже исправляйте сломанные тестовые скрипты прямо в вашей IDE или LLM. Мгновенно получайте логи, выявляйте первопричины и применяйте контекстно-зависимые исправления. Больше никаких циклов отладки. Ниже приведены несколько примеров запросов для запуска/отладки/исправления ваших автоматизированных тестов на Тестовой платформе BrowserStack.

Примечание: При получении анализа первопричин (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?"

• Исправляйте сбои тестов, о которых сообщает ваш CI/CD пайплайн, используя наши ведущие в отрасли функции Наблюдаемости за тестами. Больше информации здесь.
• Запускайте тесты, написанные на Jest, Playwright, Selenium и других фреймворках, на Тестовой платформе BrowserStack.

🌐 Доступность

Выявляйте проблемы с доступностью на ранних этапах с помощью автоматического локального сканирования a11y. Получайте предлагаемые ИИ исправления в один клик. Никакого поиска по документации, никаких сюрпризов в CI. Обеспечьте соответствие 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”

📋 Управление тестированием

Создавайте и управляйте тест-кейсами, создавайте планы тестирования и запускайте тестовые прогоны, используя естественный язык. Ниже приведены несколько примеров запросов для использования возможностей Управления тестированием BrowserStack с 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"

🧪 Доступ к ИИ-агентам BrowserStack

Генерируйте тест-кейсы из PRD, конвертируйте ручные тесты в low-code автоматизацию и автоматически исправляйте нестабильные скрипты с помощью ИИ-агентов BrowserStack, легко интегрированных в ваш рабочий процесс. Ниже приведены несколько примеров запросов для доступа к ИИ-агентам 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”

🛠️ Установка

📋 Предварительные требования для настройки MCP

Примечание: Убедитесь, что вы используете Node версии >= 18.0

• Проверьте версию Node с помощью node --version. Рекомендуемая версия: v22.15.0 (LTS)

Настройка MCP в один клик

Нажмите на кнопки ниже, чтобы установить MCP в вашу IDE:

   

Альтернативные способы настройки MCP-сервера

1. Создайте учетную запись BrowserStack

   • Зарегистрируйтесь в BrowserStack, если у вас еще нет учетной записи.

   • ℹ️ Если у вас есть проект с открытым исходным кодом, мы сможем предоставить вам бесплатный план.

   • После создания учетной записи (и приобретения соответствующего плана) запишите ваш username и access_key из Настроек учетной записи.

2. Примечание: Убедитесь, что вы используете Node версии >= 18.0

   • Проверьте версию Node с помощью node --version. Рекомендуемая версия: v22.15.0 (LTS)

3. Установите MCP-сервер

   • VSCode (Copilot - Agent Mode): .vscode/mcp.json:

     • Найдите или создайте файл конфигурации: В корневой директории вашего проекта найдите папку с именем .vscode. Эта папка обычно скрыта, поэтому вам нужно будет найти ее, как указано в развернутом описании.

     • Если этой папки не существует, создайте ее.

     • Внутри папки .vscode создайте новый файл с именем mcp.json

     • Добавьте конфигурацию: Откройте файл mcp.json и добавьте следующее содержимое JSON.

     • Замените имя пользователя и <access_key> на ваши учетные данные BrowserStack.

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

   • В VSCode обязательно нажмите кнопку Start на MCP-сервере, чтобы запустить сервер.

   ** Альтернативный способ настройки MCP в VSCode Copilot

   1. Нажмите на значок шестеренки, чтобы выбрать Инструменты
   
   2. Вверху по центру появится меню инструментов, прокрутите меню вниз и нажмите «Добавить MCP-сервер»
   
   3. Выберите опцию NPM package (Установить из пакета NPM) - 3-я в списке
   
   4. Введите имя пакета NPM (@browserstack/mcp-server)
   
   5. Введите имя пользователя и ключ доступа BrowserStack
   • Для 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

Нажмите значок «MCP-серверы» на панели навигации Выберите вкладку «Установленные». Нажмите кнопку «Настроить MCP-серверы» внизу панели.

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

💡 Список инструментов BrowserStack MCP

На данный момент мы поддерживаем 44 инструмента.

Примечание об удаленном MCP: Инструменты, отмеченные (недоступны в удаленном MCP), зависят от состояния локальных файлов/процессов и отключены в многопользовательском Удаленном MCP-сервере. Они доступны в локальной (npx) настройке.

---

🧾 Управление тестированием

1. createProjectOrFolder — Создать проект и/или папки управления тестированием для организации тест-кейсов. Возвращает ID папки, ID проекта и ссылку на управление тестированием для доступа к панели проекта TM. Пример запроса

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

2. createTestCase — Добавить ручной тест-кейс в определенный проект/папку (использует идентификатор проекта, например PR-xxxxx, и ID папки). Пример запроса

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 — Обновить существующий тест-кейс. Можно изменить любое подмножество полей (название, приоритет, статус, шаги, теги и т.д.); изменяются только предоставленные поля. Пример запроса

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

4. listTestCases — Вывести список тест-кейсов для проекта, опционально ограниченный папкой (поддерживает фильтры, такие как case_type, priority, и пагинацию). Пример запроса

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

5. listFolders — Вывести список папок в проекте управления тестированием (возвращает id, имя, количество кейсов и количество подпапок для каждой папки). Передайте parent_id для вывода списка подпапок. Пример запроса

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

6. listTestCaseTemplates — Вывести список шаблонов тест-кейсов с их числовым template_id для использования с createTestCase для применения пользовательского шаблона. Пример запроса

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

7. createTestRun — Создать тестовый прогон (набор) для выбранных тест-кейсов в проекте. Пример запроса

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

8. listTestRuns — Вывести список тестовых прогонов для проекта (фильтрация по датам, исполнителю, состоянию). Пример запроса

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

9. updateTestRun — Обновить имя/состояние тестового прогона и/или добавить в него тест-кейсы. Пример запроса

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

10. addTestResult — Добавить результат ручного выполнения (пройден/не пройден/заблокирован/пропущен) для тест-кейса в рамках прогона. Пример запроса

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

11. createTestCasesFromFile — Массово сгенерировать тест-кейсы из загруженного файла с помощью ИИ-агента генератора тест-кейсов. (недоступен в удаленном MCP) Пример запроса

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

12. listTestPlans — Вывести список планов тестирования (TP-*) в проекте с именем, статусом, датами и количеством активных/закрытых прогонов. Поддерживает пагинацию. Пример запроса

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

13. getTestPlan — Получить план тестирования по идентификатору (TP-*) с его метаданными, связанными тестовыми прогонами, общим количеством тест-кейсов и сводкой по статусам. Пример запроса

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

14. listSubTestPlans — Вывести список подпланов тестирования (STP-) в рамках родительского плана тестирования (TP-). Поддерживает пагинацию. Пример запроса

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

15. getSubTestPlan — Получить подплан тестирования (STP-*) в рамках родительского плана с его метаданными и связанными тестовыми прогонами. Пример запроса

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

---

⚙️ Настройка BrowserStack SDK / Автоматизация тестов

16. setupBrowserStackAutomateTests — Интегрировать BrowserStack SDK и запускать веб-тесты на BrowserStack. Для визуального тестирования/Percy используйте специальные инструменты Percy. Пример запроса

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

17. fetchAutomationScreenshots — Получить скриншоты, сделанные во время данной сессии Automate/App Automate. Пример запроса

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

---

🔍 Наблюдаемость

18. getFailureLogs — Получить журналы ошибок для сессий Automate/App Automate (опционально по Build ID для App Automate). Пример запроса

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

19. fetchBuildInsights — Получить информацию о сборке BrowserStack, объединив детали сборки и результаты проверки качества. Пример запроса

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

---

📱 App Live

20. runAppLiveSession — Запустить сессию ручного тестирования приложения на реальном устройстве в облаке. Пример запроса

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

---

💻 Live

21. runBrowserLiveSession — Запустить сессию Live для тестирования веб-сайта на десктопных или мобильных браузерах. Пример запроса

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

---

📲 App Automate

22. takeAppScreenshot — Запустить приложение на указанном устройстве и сделать быстрый проверочный скриншот, чтобы подтвердить запуск вашего приложения. Пример запроса

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 — Запустить готовые наборы нативных мобильных тестов (Espresso/XCUITest) путем прямой загрузки скомпилированных тестовых файлов .apk/.ipa. Пример запроса

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 — Настроить интеграцию BrowserStack App Automate SDK для тестирования мобильных приложений на основе Appium. Пример запроса

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

---

♿ Доступность

25. accessibilityExpert — Спросить эксперта по A11y (WCAG 2.0/2.1/2.2, удобство использования на мобильных/веб-платформах, лучшие практики). Пример запроса

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

26. startAccessibilityScan — Запустить сканирование веб-доступности и получить путь к локальному CSV-отчету. Пример запроса

Run accessibility scan for "www.example.com"

27. createAccessibilityAuthConfig — Создать конфигурацию аутентификации (на основе формы или базовую) для сканирования доступности за логином. Пример запроса

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

28. getAccessibilityAuthConfig — Получить существующую конфигурацию аутентификации доступности по ID. Пример запроса

Get accessibility auth config with ID <config-id>

29. fetchAccessibilityIssues — Извлечь проблемы доступности из завершенного сканирования с поддержкой пагинации. Пример запроса

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

---

🎨 Визуальное тестирование Percy

30. percyVisualTestIntegrationAgent — Интегрировать визуальное тестирование Percy в новый проект и продемонстрировать обнаружение визуальных изменений с пошаговой симуляцией. Пример запроса

Integrate Percy for this project

31. expandPercyVisualTesting — Настроить или расширить покрытие визуального тестирования Percy для существующих проектов (Percy Web Standalone и Percy Automate). Пример запроса

Expand Percy coverage for this project

32. addPercySnapshotCommands — Добавить команды снимков Percy в указанные тестовые файлы. (недоступно в Remote MCP) Пример запроса

Add Percy snapshot commands to my Cypress test files

33. listTestFiles — Вывести список всех тестовых файлов для заданного набора директорий. (недоступно в Remote MCP) Пример запроса

List the test files under my ./tests directory

34. runPercyScan — Запустить сканирование визуального теста Percy. (недоступно в Remote MCP) Пример запроса

Run this Percy build

35. fetchPercyChanges — Извлечь и обобщить визуальные изменения, обнаруженные Percy AI между последней и предыдущей сборками. Пример запроса

Summarize the visual changes Percy detected in my latest build

36. managePercyBuildApproval — Одобрить или отклонить сборку Percy. Пример запроса

Approve the latest Percy build

---

🤖 AI-агенты BrowserStack

37. uploadProductRequirementFile — Загрузить PRD/скриншот/PDF и получить ID сопоставления файла (используется с createTestCasesFromFile). (недоступно в Remote MCP) Пример запроса

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

38. createLCASteps — Сгенерировать шаги Low Code Automation (LCA) из ручного тест-кейса в Test Management. Пример запроса

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

39. fetchSelfHealedSelectors — Получить AI-самовосстанавливающиеся селекторы (плюс исходный код теста) для исправления нестабильных тестов, вызванных изменениями в DOM. Пример запроса

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

40. prepareSelfHealingPlan — Построить план самовосстановления, который объединяет пары локаторов с исходным кодом теста для применения вашей LLM. НЕ изменяет файлы самостоятельно. Пример запроса

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

41. fetchRCA — Получить AI-анализ первопричин для ваших упавших тестов Automate/App-Automate (по числовому ID теста). Только предлагает исправления; никогда не применяет автоматически. Пример запроса

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

42. getBuildId — Получить ID сборки BrowserStack для заданного проекта и имени сборки в рамках ваших сборок. Пример запроса

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

43. listBuildId — Получить ID последней сборки для проекта и имени сборки по всем пользователям (без фильтрации по пользователю). Пример запроса

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

44. listTestIds — Вывести список ID тестов из сборки BrowserStack Automate, отфильтрованных по статусу (passed/failed/pending/skipped). Пример запроса

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

🚀 Удаленный MCP-сервер

Удаленный MCP предоставляет все возможности MCP-сервера без сложностей настройки или локальной установки.

Ключевые преимущества:

• ✅ Бесшовно работает в корпоративных сетях, не беспокоясь о брандмауэрах, бинарных файлах или там, где локальная установка запрещена.

• ✅ Безопасная интеграция OAuth – без обмена паролями или ручной обработки учетных данных.

Ограничения:

• ❌ Нет поддержки локального тестирования (нельзя тестировать приложения за VPN, брандмауэрами или на localhost). Если вам нужно локальное тестирование, придется использовать локальный MCP-сервер BrowserStack.
• ❌ Задержка может быть немного выше, но незначительно — обычно вы не заметите ее при обычном использовании.

Шаги по установке:

• В VSCode (Copilot - Agent Mode): .vscode/mcp.json:

  • Найдите или создайте файл конфигурации:

  • В корневой директории вашего проекта найдите папку с именем .vscode. Эта папка обычно скрыта, поэтому вам нужно будет найти ее, как указано в развернутом описании.

  • Если этой папки не существует, создайте ее.

  • Внутри папки .vscode создайте новый файл с именем mcp.json

  • Чтобы настроить удаленный BrowserStack MCP вместо локального BrowserStack MCP, вы можете добавить следующее содержимое JSON:

    

    Альтернативный способ настройки удаленного MCP

  • Шаг 1. Нажмите на значок шестеренки, чтобы выбрать Инструменты

    

  • Шаг 2. В верхней центральной части появится меню инструментов, прокрутите меню вниз и нажмите «Добавить MCP-сервер»

  

  • Шаг 3. Нажмите на опцию HTTP

    

  • Шаг 4. Вставьте URL удаленного MCP-сервера: https://mcp.browserstack.com/mcp

    

  • Шаг 5. Укажите ID сервера как: browserstack

    

  • Шаг 6. В VSCode нажмите «Запустить MCP-сервер», а затем нажмите «Разрешить»

    
    
    

🤝 Рекомендуемые MCP-клиенты

• Мы рекомендуем использовать Github Copilot или Cursor для сценариев автоматизированного тестирования и отладки.
• Для сценариев ручного тестирования (Live Testing) мы рекомендуем использовать Claude Desktop.

⚠️ Важные замечания

• MCP-сервер BrowserStack находится в активной разработке и в настоящее время поддерживает подмножество спецификации MCP. Вскоре будут добавлены новые функции.
• Вызовы инструментов зависят от MCP-клиента, который, в свою очередь, зависит от LLM, поэтому может наблюдаться недетерминированное поведение, приводящее к неожиданным результатам. Если у вас есть предложения или отзывы, пожалуйста, создайте issue для обсуждения.

📝 Участие в разработке

Мы приветствуем вклад! Пожалуйста, создайте issue, чтобы обсудить любые изменения, которые вы хотели бы внести. 👉 Нажмите здесь, чтобы ознакомиться с нашими правилами участия

📞 Поддержка

Для получения поддержки, пожалуйста:

• Создайте issue в нашем GitHub-репозитории, если вы столкнулись с какими-либо проблемами, связанными с MCP-сервером.
• Свяжитесь с нашей командой поддержки по любым другим вопросам.

🚀 Скоро появятся новые функции

Следите за захватывающими обновлениями! Есть предложения? Пожалуйста, создайте issue для обсуждения.