SmartBear MCP server

Сервер Model Context Protocol (MCP), который предоставляет ИИ-помощникам бесшовный доступ к набору инструментов тестирования и мониторинга SmartBear, включая BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr и Collaborator.

Что такое MCP?

Model Context Protocol (MCP) — открытый стандарт, который позволяет AI-помощникам безопасно подключаться к внешним источникам данных и инструментам. Этот сервер обеспечивает доступ через API SmartBear через естественные языковые интерфейсы, позволяя вам запрашивать данные по тестированию, анализировать метрики производительности и управлять автоматизацией тестирования прямо из вашего рабочего процесса на базе ИИ.

Поддерживаемые инструменты

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

• BearQ - AI-управление QA-тестированием и выполнение тестов
• BugSnag - Всеобъемлющие возможности мониторинга ошибок и отладки
• Reflect - Управление тестированием и выполнение тестов
• Swagger

Portal - Возможности портала и управления продуктами

• Studio - Возможности управления API и доменами, включая генерацию API на основе подсказок и автоматическое стандартизирование
• Contract Testing (PactFlow) - Возможности контрактного тестирования
• Functional Testing - Возможности обнаружения API-тестов
• QMetry - Возможности управления тестированием в QMetry
• Zephyr - Возможности управления тестированием в Zephyr
• Collaborator - Возможности обзора и управления удаленной конфигурацией системы
• QTM4J - Возможности управления тестированием QTM4J для Jira

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

Для BugSnag, Swagger и Zephyr SmartBear размещает удаленные MCP-серверы, к которым можно подключаться напрямую из вашего MCP-клиента по URL — без установки, Node.js или API-токенов. Аутентификация выполняется через OAuth-процесс в браузере.

Продукт	URL сервера
Swagger	https://swagger.mcp.smartbear.com/mcp
BugSnag	https://bugsnag.mcp.smartbear.com/mcp
Zephyr	https://zephyr.mcp.smartbear.com/mcp

См. руководство Remote MCP Servers для инструкций по настройке под каждого клиента. Вы можете подключаться к нескольким удаленным серверам одновременно.

Нужны BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator или Functional Testing? Эти продукты доступны только через локальный пакет npm ниже, который объединяет все продукты в одном MCP-сервере.

Требования

• Node.js 20+ и npm
• Доступ к продуктам SmartBear (BugSnag, Reflect, Swagger, QMetry, QTM4J или Zephyr)
• Действующие API-токены для выбранных вами продуктов

Установка локального MCP-сервера (npm)

Для всех продуктов — или если вы предпочитаете запускать сервер локально — сервер MCP распространяется в виде пакета npm @smartbear/mcp, что упрощает интеграцию в ваш рабочий процесс разработки.

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

VS Code с Copilot

Для быстрой настройки используйте команду "MCP: Add server…" в Command Palette для добавления пакета npm @smartbear/mcp.

📋 Ручная установка
alternatively, you can use npx (или глобальную установку) пакета @smartbear/mcp для запуска сервера и добавления следующего в файл .vscode/mcp.json:

{
  "servers": {
    "smartbear": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smartbear/mcp@latest"
      ],
      "env": {
        "BEARQ_API_TOKEN": "${input:bearq_api_token}",
        "BEARQ_API_BASE_URL": "${input:bearq_api_base_url}",
        "BUGSNAG_AUTH_TOKEN": "${input:bugsnag_auth_token}",
        "BUGSNAG_PROJECT_API_KEY": "${input:bugsnag_project_api_key}",
        "REFLECT_API_TOKEN": "${input:reflect_api_token}",
        "SWAGGER_API_KEY": "${input:swagger_api_key}",
        "SWAGGER_PORTAL_BASE_PATH": "${input:swagger_portal_base_path}",
        "SWAGGER_REGISTRY_BASE_PATH": "${input:swagger_registry_base_path}",
        "SWAGGER_UI_BASE_PATH": "${input:swagger_ui_base_path}",
        "PACT_BROKER_BASE_URL": "${input:pact_broker_base_url}",
        "PACT_BROKER_TOKEN": "${input:pact_broker_token}",
        "PACT_BROKER_USERNAME": "${input:pact_broker_username}",
        "PACT_BROKER_PASSWORD": "${input:pact_broker_password}",
        "QMETRY_API_KEY": "${input:qmetry_api_key}",
        "QMETRY_BASE_URL": "${input:qmetry_base_url}",
        "ZEPHYR_API_TOKEN": "${input:zephyr_api_token}",
        "ZEPHYR_BASE_URL": "${input:zephyr_base_url}",
        "COLLABORATOR_BASE_URL": "${input:collab_base_url}",
        "COLLABORATOR_USERNAME": "${input:collab_username}",
        "COLLABORATOR_LOGIN_TICKET": "${input:collab_login_ticket}",
        "QTM4J_API_KEY": "${input:qtm4j_api_key}",
        "QTM4J_BASE_URL": "${input:qtm4j_base_url}",
        "QTM4J_AUTOMATION_API_KEY": "${input:qtm4j_automation_api_key}",
        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "${input:swagger_functional_testing_api_token}",
        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "${input:swagger_functional_testing_base_path}"
      }
    }
  },
  "inputs": [
      {
         "id": "bearq_api_token",
         "type": "promptString",
         "description": "BearQ workspace API token - leave blank to disable BearQ tools",
         "password": true
      },
      {
         "id": "bearq_api_base_url",
         "type": "promptString",
         "description": "BearQ API base URL - leave blank to use the default (https://api.bearq.smartbear.com)",
         "password": false
      },
      {
         "id": "bugsnag_auth_token",
         "type": "promptString",
         "description": "BugSnag Auth Token - leave blank to disable BugSnag tools",
         "password": true
      },
      {
         "id": "bugsnag_project_api_key",
         "type": "promptString",
         "description": "BugSnag Project API Key - for single project interactions",
         "password": false
      },
      {
         "id": "reflect_api_token",
         "type": "promptString",
         "description": "Reflect API Token - leave blank to disable Reflect tools",
         "password": true
      },
      {
         "id": "swagger_api_key",
         "type": "promptString",
         "description": "Swagger API Key - leave blank to disable Swagger tools",
         "password": true
      },
      {
         "id": "swagger_portal_base_path",
         "type": "promptString",
         "description": "Swagger Portal API base path - only needed for on-premise installations (leave blank for cloud)",
         "password": false
      },
      {
         "id": "swagger_registry_base_path",
         "type": "promptString",
         "description": "Swagger Registry API base path - only needed for on-premise installations (leave blank for cloud)",
         "password": false
      },
      {
         "id": "swagger_ui_base_path",
         "type": "promptString",
         "description": "Swagger UI base path - only needed for on-premise installations (leave blank for cloud)",
         "password": false
      },
      {
         "id": "pact_broker_base_url",
         "type": "promptString",
         "description": "PactFlow or Pact Broker base url - leave blank to disable the tools",
         "password": true
      },
      {
         "id": "pact_broker_token",
         "type": "promptString",
         "description": "PactFlow Authentication Token",
         "password": true
      },
      {
         "id": "pact_broker_username",
         "type": "promptString",
         "description": "Pact Broker Username",
         "password": true
      },
      {
         "id": "pact_broker_password",
         "type": "promptString",
         "description": "Pact Broker Password",
         "password": true
      },
      {
          "id": "qmetry_api_key",
          "type": "promptString",
          "description": "QMetry Open API Key",
          "password": true
      },
      {
          "id": "qmetry_base_url",
          "type": "promptString",
          "description": "По умолчанию подключается к https://testmanagement.qmetry.com. При необходимости можно изменить на пользовательский URL сервера QMetry или региональный эндпоинт.",
          "password": false
      },
      {
          "id": "zephyr_api_token",
          "type": "promptString",
          "description": "Zephyr API token - leave blank to disable Zephyr tools",
          "password": true
      },
      {
          "id": "zephyr_base_url",
          "type": "promptString",
          "description": "Zephyr API base URL. По умолчанию подключение к https://api.zephyrscale.smartbear.com/v2. При необходимости можно изменить на региональный эндпоинт.",
          "password": false
      },
      {
          "id": "collab_base_url",
          "type": "promptString",
          "description": "Collab base url",
          "password": true
      },
      {
          "id": "collab_username",
          "type": "promptString",
          "description": "Collab username",
          "password": true
      },
      {
          "id": "collab_login_ticket",
          "type": "promptString",
          "description": "Collab login ticket",
          "password": true
      },
      {
          "id": "qtm4j_api_key",
          "type": "promptString",
          "description": "QTM4J API Key",
          "password": true
    },
    {
          "id": "qtm4j_base_url",
          "type": "promptString",
          "description": "US region (default): https://qtmcloud.qmetry.com. Australia region: https://syd-qtmcloud.qmetry.com.",
          "password": false
    },
    {
          "id": "qtm4j_automation_api_key",
          "type": "promptString",
          "description": "QTM4J Automation API Key - required for automation tools, leave blank to disable them",
          "password": true
    },
    {
          "id": "swagger_functional_testing_api_token",
          "type": "promptString",
          "description": "Swagger Functional Testing API Token - leave blank to disable Functional Testing tools",
          "password": true
    },
    {
          "id": "swagger_functional_testing_base_path",
          "type": "promptString",
          "description": "Swagger Functional Testing API Base URL - leave blank to use the default (https://api.reflect.run/v1)",
          "password": false
    }
  ]
}

Claude Desktop

Добавьте следующую конфигурацию в ваш файл claude_desktop_config.json, чтобы запустить MCP-сервер через npx:

{
  "mcpServers": {
    "smartbear": {
      "command": "npx",
      "args": [
        "-y",
        "@smartbear/mcp@latest"
      ],
      "env": {
        "BEARQ_API_TOKEN": "your_bearq_api_token",
        "BUGSNAG_AUTH_TOKEN": "your_personal_auth_token",
        "BUGSNAG_PROJECT_API_KEY": "your_project_api_key",
        "REFLECT_API_TOKEN": "your_reflect_token",
        "SWAGGER_API_KEY": "your_swagger_key",
        "SWAGGER_PORTAL_BASE_PATH": "https://api.portal.swaggerhub.com/v1",
        "SWAGGER_REGISTRY_BASE_PATH": "https://api.swaggerhub.com",
        "SWAGGER_UI_BASE_PATH": "https://app.swaggerhub.com",
        "PACT_BROKER_BASE_URL": "your_pactflow_or_pactbroker_base_url",
        "PACT_BROKER_TOKEN": "your_pactflow_token",
        "PACT_BROKER_USERNAME": "your_pact_broker_username",
        "PACT_BROKER_PASSWORD": "your_pact_broker_password",
        "QMETRY_API_KEY": "your_qmetry_api_key",
        "QMETRY_BASE_URL": "https://testmanagement.qmetry.com",
        "ZEPHYR_API_TOKEN": "your_zephyr_api_token",
        "ZEPHYR_BASE_URL": "https://api.zephyrscale.smartbear.com/v2",
        "COLLABORATOR_BASE_URL": "your collab base url",
        "COLLABORATOR_USERNAME": "your collab user name",
        "COLLABORATOR_LOGIN_TICKET": "your collab login ticket",
        "QTM4J_API_KEY": "your_qtm4j_key",
        "QTM4J_BASE_URL": "https://qtmcloud.qmetry.com",
        "QTM4J_AUTOMATION_API_KEY": "your_qtm4j_automation_api_key",
        "SWAGGER_FUNCTIONAL_TESTING_API_TOKEN": "your_swagger_functional_testing_api_token",
        "SWAGGER_FUNCTIONAL_TESTING_BASE_PATH": "https://api.reflect.run/v1"
      }
    }
  }
}

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

Для подробного ознакомления, примеров и расширенной настройки посетите нашу 📖 Full Documentation

Локальная разработка

Для разработчиков, желающих внести вклад в сервер SmartBear MCP, смотрите руководство CONTRIBUTING.md.

Лицензия

Этот MCP-сервер лицензирован по MIT License. Это означает, что вы можете свободно использовать, модифицировать и распространять программное обеспечение, при соблюдении условий MIT License. Подробности смотрите в файле LICENSE в репозитории проекта.

Поддержка

• Поиск открытых и закрытых вопросов по аналогичным проблемам

• Сообщить об ошибке или запросить функцию

---

SmartBear MCP Server - приносит мощь экосистемы тестирования и мониторинга SmartBear в ваш AI-процесс разработки.