API ВЕГА

MCP-сервер BrowserStack

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

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

Тестируйте из любого инструмента:

Легко подключайте BrowserStack Test Platform к любимым AI-инструментам — IDE, LLM или агентным рабочим процессам.

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

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

Меньше переключений между инструментами:

Сохраняйте рабочий поток: держите весь контекст проекта в одном месте и запускайте нужные действия прямо из IDE или LLM.

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

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

Примечание: Размещённый удалённый MCP-сервер (mcp.browserstack.com) теперь полностью работает без сохранения состояния по Streamable HTTP. Любой клиент с поддержкой Streamable HTTP (Claude, Cursor, VS Code, ChatGPT) подключается без изменения конфигурации.

Примечание: убедитесь, что используете Node версии не ниже 20.9

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

  • Чтобы обновить Node:

  • В 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

  • В 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. Мгновенно получайте журналы, определяйте первопричины и применяйте контекстно-зависимые исправления. Больше никаких циклов отладки.

Ниже приведены примеры запросов для запуска, отладки и исправления автоматизированных тестов на Test Platform 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-конвейере, с помощью передовых возможностей Test Observability. Подробнее — здесь.

  • Запускайте тесты, написанные на Jest, Playwright, Selenium и других инструментах, на Test Platform BrowserStack.

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

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

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

Создавайте и управляйте тест-кейсами, составляйте планы тестирования и запускайте тесты с помощью запросов на естественном языке. Ниже приведены примеры запросов для работы с возможностями Test Management через 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"

⚡ Нагрузочное тестирование

Запускайте и анализируйте масштабные нагрузочные тесты, не выходя из IDE или чата: находите тесты, запускайте и останавливайте их, просматривайте отчёты и AI Insights, сравнивайте запуски и проверяйте расход VU-hours. Поддерживаются нагрузочные тесты для API (JMeter, k6, Gatling, Locust), браузеров (Playwright, Selenium, WebdriverIO, Nightwatch) и гибридные тесты на Load Testing BrowserStack. Для этого используются основные инструменты.

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

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

Создавайте тест-кейсы на основе PRD, преобразуйте ручные тесты в low-code-автоматизацию и автоматически исправляйте нестабильные скрипты с помощью AI-агентов BrowserStack, встроенных в ваш рабочий процесс. Ниже приведены примеры запросов для работы с AI-агентами 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.js версии не ниже 20.9 (см. примечание в разделе «Настройка MCP в один клик» выше).

  • Учётная запись BrowserStack (инструкции приведены ниже).

Чтобы установить MCP в один клик, нажмите кнопки Install in VS Code или Install in Cursor в разделе «Настройка MCP в один клик» в верхней части этой страницы.

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

  • Создайте аккаунт BrowserStack

    • Зарегистрируйтесь в BrowserStack, если у вас ещё нет аккаунта.

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

    • После регистрации и покупки подходящего тарифа найдите свой username и access_key в разделе Настройки аккаунта.

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

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

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

В корневой папке проекта найдите папку .vscode. Обычно она скрыта, поэтому, чтобы найти её, воспользуйтесь инструкциями в раскрывающемся разделе.

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

  • В папке .vscode создайте файл mcp.json.

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

  • Замените username и <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. Нажмите на значок шестерёнки и выберите Select Tools.

  2. В верхней центральной части экрана появится меню инструментов. Прокрутите его вниз и нажмите Add MCP Server.

  3. Выберите вариант NPM package (Install from an NPM package) — третий в списке.

  4. Укажите имя NPM-пакета (@browserstack/mcp-server).

  5. Введите имя пользователя BrowserStack и access key.

  • Для 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 Servers” на панели навигации.

Перейдите на вкладку “Installed”, затем нажмите кнопку “Configure MCP Servers” в нижней части панели.

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

🧭 Основные инструменты

Пять основных инструментов помогают 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-сервер

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

Основные преимущества:

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

  • ✅ Безопасная интеграция с OAuth: не нужно передавать пароли или вручную управлять учётными данными.

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

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

  • ❌ Задержка может быть немного выше, но обычно это незаметно при повседневном использовании.

Установка:

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

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

    • В корневой папке проекта найдите папку .vscode. Обычно она скрыта, поэтому, чтобы найти её, воспользуйтесь инструкциями в раскрывающемся разделе.

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

    • В папке .vscode создайте файл mcp.json.

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

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

  • Шаг 1. Нажмите на значок шестерёнки и выберите Select Tools.

  • Шаг 2. В верхней центральной части экрана появится меню инструментов. Прокрутите его вниз и нажмите Add MCP Server.

  • Шаг 3. Выберите вариант HTTP.

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

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

  • Шаг 6. В VSCode запустите MCP-сервер, нажав Start MCP Server, а затем нажмите "Allow".

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

  • MCP-сервер BrowserStack активно разрабатывается и пока поддерживает только часть спецификации MCP. Вскоре появятся новые возможности.

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

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

Мы приветствуем вклад в проект! Откройте issue, чтобы обсудить предлагаемые изменения.

👉 Ознакомиться с правилами участия в разработке

📞 Поддержка

Чтобы получить помощь:

🚀 Скоро появятся новые возможности

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