BrowserStack MCP Server

официальный

Bring the full power of BrowserStack’s Test Platform to your AI tools, making testing faster and easier for every developer and tester on your team.

GitHub
145

Документация

BrowserStack MCP-сервер

BrowserStack Logo MCP Server Logo

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

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

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

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

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

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

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

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

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

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

Install in VS Code   Install in Cursor

Примечание: Убедитесь, что вы используете 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
    1. На 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?"

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

Выявляйте проблемы доступности на ранних этапах с помощью автоматизированных локальных сканирований 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:

Install in VS Code   Install in Cursor

Альтернативные способы настройки 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-сервере, чтобы запустить сервер. Start MCP Server

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

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

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

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

  1. createProjectOrFolder — Создайте проект управления тестированием и/или папки для организации тест-кейсов. Возвращает ID папки, ID проекта и ссылку на панель управления проектом TM. Пример подсказки
Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
  1. 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
  1. listTestCases — Список тест-кейсов для проекта (поддерживает фильтры по приоритету, статусу, тегам). Пример подсказки
List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
  1. createTestRun — Создайте тестовый прогон (набор) для выбранных тест-кейсов в проекте. Пример подсказки
Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
  1. listTestRuns — Список тестовых прогонов для проекта (фильтр по датам, исполнителю, состоянию). Пример подсказки
List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
  1. updateTestRun — Частично обновите тестовый прогон (статус, теги, заметки, связанные тест-кейсы). Пример подсказки
Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
  1. addTestResult — Добавьте результат ручного выполнения (пройден/не пройден/заблокирован/пропущен) для тест-кейса в рамках прогона. Пример подсказки
Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
  1. createTestCasesFromFile — Массовое создание тест-кейсов из загруженного файла (например, PDF). Пример подсказки
Upload test cases from '/Users/xyz/testcases.pdf' to the 'Shopping App' project in Test Management

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

  1. setupBrowserStackAutomateTests — Интегрируйте BrowserStack SDK и запускайте веб-тесты на BrowserStack (опционально включите Percy). Пример подсказки
Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
  1. fetchAutomationScreenshots — Получите скриншоты, сделанные во время данной сессии Automate/App Automate. Пример подсказки
Get screenshots from Automate session ID abc123xyz for my desktop test run

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

  1. 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

📱 App Live

  1. runAppLiveSession — Запустите сессию ручного тестирования приложения на реальном устройстве в облаке. Пример подсказки
Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/xyz/app.ipa

💻 Live

  1. runBrowserLiveSession — Запустите Live-сессию для тестирования веб-сайта на десктопных или мобильных браузерах. Пример подсказки
Open www.google.com on the latest version of Microsoft Edge on Windows 11

📲 App Automate

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

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

  1. accessibilityExpert — Спросите эксперта по A11y (WCAG 2.0/2.1/2.2, удобство использования на мобильных/веб, лучшие практики). Пример подсказки
What WCAG guidelines apply to form field error messages on mobile web?
  1. startAccessibilityScan — Запустите сканирование веб-доступности и верните ссылку на результат. Пример подсказки
Run accessibility scan for "www.example.com"

🤖 ИИ-агенты BrowserStack

  1. fetchSelfHealedSelectors — Получите самовосстанавливающиеся селекторы ИИ для исправления нестабильных тестов из-за изменений DOM. Пример подсказки
Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
  1. createLCASteps — Сгенерируйте шаги Low Code Automation из ручного тест-кейса в Управлении тестированием. Пример подсказки
Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
  1. uploadProductRequirementFile — Загрузите PRD/скриншот/PDF и получите ID сопоставления файла (используется с createTestCasesFromFile). Пример подсказки
Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      Remote MCP JSON file

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

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

      Select Tools

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

    Add MCP Server

    • Шаг 3. Нажмите на вариант HTTP

      HTTP Option

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

      Remote MCP Server URL

    • Шаг 5. Укажите идентификатор сервера: browserstack

      Remote MCP Server ID

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

      authentication1
      authentication2
      Sign_in_success

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

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

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

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

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

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

📞 Поддержка

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

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

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