smartbear

Acesso único a todos os produtos smartbear

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP da SmartBear

Um servidor Model Context Protocol (MCP) que fornece aos assistentes de IA acesso contínuo ao conjunto de ferramentas de teste e monitoramento da SmartBear, incluindo BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr e Collaborator.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. Este servidor expõe as APIs da SmartBear por meio de interfaces em linguagem natural, permitindo que você consulte seus dados de teste, analise métricas de desempenho e gerencie a automação de testes diretamente do seu fluxo de trabalho de IA.

Ferramentas Suportadas

Consulte os guias individuais para obter sugestões de prompts e ferramentas e recursos suportados:

BearQ - Capacidades de gerenciamento e execução de testes de QA com IA
BugSnag - Capacidades abrangentes de monitoramento de erros e depuração
Reflect - Capacidades de gerenciamento e execução de testes
Swagger
- Portal - Capacidades de gerenciamento de portal e produtos
- Studio - Capacidades de gerenciamento de API e Domínio, incluindo geração de API com IA a partir de prompts e padronização automática
- Contract Testing (PactFlow) - Capacidades de teste de contrato
- Functional Testing - Capacidades de descoberta de testes de API
QMetry - Capacidades de gerenciamento de testes QMetry
Zephyr - Capacidades de gerenciamento de testes Zephyr
Collaborator - Capacidades de gerenciamento de revisão e configuração de sistemas remotos
QTM4J - Capacidades de gerenciamento de testes QTM4J para Jira

Servidores MCP Remotos

Para BugSnag, Swagger e Zephyr, a SmartBear hospeda Servidores MCP Remotos aos quais você pode se conectar diretamente do seu cliente MCP por meio de uma URL — sem necessidade de instalação, Node.js ou tokens de API. A autenticação é feita por meio de um fluxo de navegador OAuth.

Produto	URL do Servidor
Swagger	`https://swagger.mcp.smartbear.com/mcp`
BugSnag	`https://bugsnag.mcp.smartbear.com/mcp`
Zephyr	`https://zephyr.mcp.smartbear.com/mcp`

Consulte o guia de Servidores MCP Remotos para obter instruções de configuração por cliente. Você pode se conectar a vários servidores remotos ao mesmo tempo.

Precisa de BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator ou Functional Testing? Esses produtos estão disponíveis apenas por meio do pacote npm local abaixo, que agrupa todos os produtos em um único servidor MCP.

Pré-requisitos

Node.js 22+ e npm
Acesso aos produtos SmartBear (BugSnag, Reflect, Swagger, QMetry, QTM4J ou Zephyr)
Tokens de API válidos para os produtos que você deseja integrar

Instalação do Servidor MCP Local (npm)

Para todos os produtos — ou se você preferir executar o servidor localmente — o servidor MCP é distribuído como um pacote npm @smartbear/mcp, facilitando a integração ao seu fluxo de trabalho de desenvolvimento.

O servidor é iniciado com a chave de API ou token de autenticação que você usa com seus produtos SmartBear. Eles são opcionais e podem ser removidos da sua configuração se você não estiver usando o produto. Para BugSnag, se você fornecer uma chave de API do projeto, ela restringirá todas as pesquisas a um único projeto no seu painel do BugSnag. Deixe este campo em branco se desejar interagir em vários projetos ao mesmo tempo.

VS Code com Copilot

Para a configuração mais rápida, use o comando "MCP: Add server…" na Paleta de Comandos para adicionar o pacote npm @smartbear/mcp.

📋 Instalação manual

Alternativamente, você pode usar npx (ou instalar globalmente) o pacote @smartbear/mcp para executar o servidor e adicionar o seguinte ao seu arquivo .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

Adicione a seguinte configuração ao seu claude_desktop_config.json para iniciar o servidor MCP via 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"
      }
    }
  }
}

Configuração do Servidor (modo HTTP)

Variável	Padrão	Finalidade
`BASE_URL`	(derivado da solicitação)	A URL pública do próprio servidor, por exemplo, `https://mcp.example.com`. Defina isso em qualquer implantação atrás de um proxy ou balanceador de carga — caso contrário, o endereço anunciado para descoberta OAuth é derivado do cabeçalho `Host` fornecido pelo cliente.
`TRUST_PROXY`	`false`	Defina como `true` somente quando um proxy na frente do servidor definir `X-Forwarded-Host` e remover qualquer valor fornecido pelo cliente.

Documentação

Para uma introdução detalhada, exemplos e configuração avançada, visite nossa 📖 Documentação Completa

Desenvolvimento Local

Para desenvolvedores que desejam contribuir com o servidor MCP da SmartBear, consulte o guia CONTRIBUTING.md.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.

Suporte

Pesquise problemas abertos e fechados para problemas semelhantes
Relate um bug ou solicite um recurso

Servidor MCP da SmartBear - Trazendo o poder do ecossistema de teste e monitoramento da SmartBear para o seu fluxo de trabalho de desenvolvimento com IA.