smartbear

Acceso integral a todos los productos de smartbear

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de SmartBear

Un servidor de Model Context Protocol (MCP) que proporciona a los asistentes de IA un acceso fluido al conjunto de herramientas de pruebas y monitoreo de SmartBear, incluyendo BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr y Collaborator.

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse de forma segura a fuentes de datos y herramientas externas. Este servidor expone las APIs de SmartBear a través de interfaces de lenguaje natural, permitiéndote consultar tus datos de pruebas, analizar métricas de rendimiento y gestionar la automatización de pruebas directamente desde tu flujo de trabajo de IA.

Herramientas compatibles

Consulta las guías individuales para obtener sugerencias de prompts y las herramientas y recursos compatibles:

BearQ - Capacidades de gestión y ejecución de pruebas QA impulsadas por IA
BugSnag - Capacidades integrales de monitoreo de errores y depuración
Reflect - Capacidades de gestión y ejecución de pruebas
Swagger
- Portal - Capacidades de gestión de portal y productos
- Studio - Capacidades de gestión de API y dominios, incluyendo generación de API impulsada por IA a partir de prompts y estandarización automática
- Contract Testing (PactFlow) - Capacidades de pruebas de contratos
- Functional Testing - Capacidades de descubrimiento de pruebas de API
QMetry - Capacidades de gestión de pruebas de QMetry
Zephyr - Capacidades de gestión de pruebas de Zephyr
Collaborator - Capacidades de gestión de revisiones y configuración de sistemas remotos
QTM4J - Capacidades de gestión de pruebas de QTM4J para Jira

Servidores MCP remotos

Para BugSnag, Swagger y Zephyr, SmartBear aloja servidores MCP remotos a los que puedes conectarte directamente desde tu cliente MCP mediante una URL, sin necesidad de instalación, Node.js ni tokens de API. La autenticación se gestiona mediante un flujo de navegador OAuth.

Producto	URL del servidor
Swagger	`https://swagger.mcp.smartbear.com/mcp`
BugSnag	`https://bugsnag.mcp.smartbear.com/mcp`
Zephyr	`https://zephyr.mcp.smartbear.com/mcp`

Consulta la guía de servidores MCP remotos para obtener instrucciones de configuración por cliente. Puedes conectarte a varios servidores remotos al mismo tiempo.

¿Necesitas BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator o Functional Testing? Estos productos solo están disponibles a través del paquete npm local que se muestra a continuación, el cual agrupa todos los productos en un único servidor MCP.

Requisitos previos

Node.js 22+ y npm
Acceso a los productos de SmartBear (BugSnag, Reflect, Swagger, QMetry, QTM4J o Zephyr)
Tokens de API válidos para los productos que deseas integrar

Instalación del servidor MCP local (npm)

Para todos los productos, o si prefieres ejecutar el servidor localmente, el servidor MCP se distribuye como un paquete npm @smartbear/mcp, lo que facilita su integración en tu flujo de trabajo de desarrollo.

El servidor se inicia con la clave de API o el token de autenticación que utilizas con tus productos de SmartBear. Son opcionales y se pueden eliminar de tu configuración si no estás utilizando el producto. Para BugSnag, si proporcionas una clave de API de proyecto, se limitarán todas las búsquedas a un único proyecto en tu panel de BugSnag. Deja este campo en blanco si deseas interactuar con varios proyectos a la vez.

VS Code con Copilot

Para la configuración más rápida, usa el comando "MCP: Add server…" en la Paleta de comandos para agregar el paquete npm @smartbear/mcp.

📋 Instalación manual

Alternativamente, puedes usar npx (o instalar globalmente) el paquete @smartbear/mcp para ejecutar el servidor y agregar lo siguiente a tu archivo .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": "By default, connects to https://testmanagement.qmetry.com. Change to a custom QMetry server URL or a region-specific endpoint if needed.",
          "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. By default, connects to https://api.zephyrscale.smartbear.com/v2. Change to region-specific endpoint if needed.",
          "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

Agrega la siguiente configuración a tu claude_desktop_config.json para iniciar el servidor MCP mediante 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"
      }
    }
  }
}

Configuración del servidor (modo HTTP)

Variable	Predeterminado	Propósito
`BASE_URL`	(derivado de la solicitud)	La URL pública del propio servidor, p. ej., `https://mcp.example.com`. Establécelo en cualquier implementación detrás de un proxy o balanceador de carga; de lo contrario, la dirección anunciada para el descubrimiento de OAuth se deriva del encabezado `Host` proporcionado por el cliente.
`TRUST_PROXY`	`false`	Establécelo en `true` solo cuando un proxy frente al servidor establezca `X-Forwarded-Host` y elimine cualquier valor proporcionado por el cliente.

Documentación

Para una introducción detallada, ejemplos y configuración avanzada, visita nuestra 📖 Documentación completa

Desarrollo local

Para los desarrolladores que deseen contribuir al servidor MCP de SmartBear, consulta la guía CONTRIBUTING.md.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.

Soporte

Busca problemas abiertos y cerrados para problemas similares
Reporta un error o solicita una función

Servidor MCP de SmartBear - Llevando el poder del ecosistema de pruebas y monitoreo de SmartBear a tu flujo de trabajo de desarrollo impulsado por IA.