Swagger MCP

com.smartbear由 smartbear.com 发布官方发布者v0.33.0更新于 Oct 24, 2026

MCP server for AI access to Swagger by SmartBear.

发布方自己的服务：SmartBear MCP

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

SmartBear 托管的 Swagger MCP 服务器，通过 OAuth 让 AI 助手访问 Swagger API 门户、Studio、契约测试与功能测试工具。

可以做什么
  • 管理 Swagger 门户与产品
  • 在 Swagger Studio 中创建、管理并标准化 API 与域名，包括根据提示生成 API
  • 使用 PactFlow 进行契约测试
  • 发现用于功能测试的 API 测试
  • 用自然语言查询和管理 SmartBear 测试数据
适用场景
适合使用 SwaggerHub 或 SmartBear API 工具链的团队，希望助手在不离开对话的情况下查看门户、起草或标准化 API 定义，或查询契约测试与功能测试信息。
运行要求
远程 streamable HTTP 端点；此托管服务器无需安装、Node.js 或 API 令牌。需要拥有可访问相关 Swagger 产品的 SmartBear 账号，并通过浏览器完成 OAuth 登录。需能访问 SmartBear 端点。
安装前请注意
通过 OAuth 登录，助手将以你的 SmartBear 账号权限操作。部分工具可创建或修改 API 定义、门户和测试资产，批准写入操作前请先确认。请求与结果会发送至 SmartBear 托管服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Swagger MCP，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.smartbear%2Fswagger-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "swagger": {
      "type": "http",
      "url": "https://swagger.mcp.smartbear.com/mcp"
    }
  }
}

README


A Model Context Protocol (MCP) server which provides AI assistants with seamless access to SmartBear's suite of testing and monitoring tools, including BearQ, BugSnag, Reflect, Swagger, PactFlow, Pact Broker, QMetry, QTM4J, Zephyr and Collaborator.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. This server exposes SmartBear's APIs through natural language interfaces, allowing you to query your testing data, analyze performance metrics, and manage test automation directly from your AI workflow.

Supported Tools

See individual guides for suggested prompts and supported tools and resources:

  • BearQ - AI-powered QA test management and execution capabilities
  • BugSnag - Comprehensive error monitoring and debugging capabilities
  • Reflect - Test management and execution capabilities
  • Swagger
    • Portal - Portal and product management capabilities
    • Studio - API and Domain management capabilities, including AI-powered API generation from prompts and automatic standardization
    • Contract Testing (PactFlow) - Contract testing capabilities
    • Functional Testing - API test discovery capabilities
  • QMetry - QMetry Test Management capabilities
  • Zephyr - Zephyr Test Management capabilities
  • Collaborator - Review and Remote System Configuration management capabilities
  • QTM4J - QTM4J Test Management for Jira capabilities

Remote MCP Servers

For BugSnag, Swagger, and Zephyr, SmartBear hosts Remote MCP Servers that you can connect to directly from your MCP client via a URL — no installation, Node.js, or API tokens required. Authentication is handled through an OAuth browser flow.

ProductServer URL
Swaggerhttps://swagger.mcp.smartbear.com/mcp
BugSnaghttps://bugsnag.mcp.smartbear.com/mcp
Zephyrhttps://zephyr.mcp.smartbear.com/mcp

See the Remote MCP Servers guide for per-client setup instructions. You can connect to multiple remote servers at the same time.

Need BearQ, Reflect, QMetry, QTM4J, PactFlow, Collaborator, or Functional Testing? These products are only available via the local npm package below, which bundles all products into a single MCP server.

Prerequisites

  • Node.js 22+ and npm
  • Access to SmartBear products (BugSnag, Reflect, Swagger, QMetry, QTM4J or Zephyr)
  • Valid API tokens for the products you want to integrate

Local MCP Server Installation (npm)

For all products — or if you prefer running the server locally — the MCP server is distributed as an npm package @smartbear/mcp, making it easy to integrate into your development workflow.

The server is started with the API key or auth token that you use with your SmartBear product(s). They are optional and can be removed from your configuration if you aren't using the product. For BugSnag, if you provide a project API key it will narrow down all searches to a single project in your BugSnag dashboard. Leave this field blank if you wish to interact across multiple projects at a time.

VS Code with Copilot

For the quickest setup, use the "MCP: Add server…" command in the Command Palette to add the @smartbear/mcp npm package.

📋 Manual installation

Alternatively, you can use npx (or globally install) the @smartbear/mcp package to run the server and add the following to your .vscode/mcp.json file:

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

Add the following configuration to your claude_desktop_config.json to launch the MCP server via npx:

json
{  "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"      }    }  }}

Loading only the products you use

Set MCP_CLIENTS to a comma-separated, case-insensitive list of product names (for example "MCP_CLIENTS": "QMetry") to load only those products. This reduces startup time, which helps on clients with a short initialize timeout. Valid names are BearQ, BugSnag, Collaborator, Contract Testing, QMetry, QTM4J, Reflect, Swagger and Zephyr. When unset, all products are loaded.

Server Configuration (HTTP mode)

VariableDefaultPurpose
BASE_URL(derived from request)The server's own public URL, e.g. https://mcp.example.com. Set this on any deployment behind a proxy or load balancer — otherwise the address advertised for OAuth discovery is derived from the client-supplied Host header.
TRUST_PROXYfalseSet to true only when a proxy in front of the server sets X-Forwarded-Host and strips any client-supplied value.
MCP_SERVER_AMPLITUDE_API_KEY(unset — analytics off)API key for the shared SmartBear Amplitude project. When set, the server reports Server Initialized, Session Started, Session Ended, Tool Called and Tools Listed usage events (tool outcome and timing only — never tool arguments, results, credentials or raw email). Unset, nothing is tracked. HTTP mode only.

Documentation

For detailed introduction, examples, and advanced configuration visit our 📖 Full Documentation

Local Development

For developers who want to contribute to the SmartBear MCP server, please see the CONTRIBUTING.md guide.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Support

SmartBear MCP Server - Bringing the power of SmartBear's testing and monitoring ecosystem to your AI-powered development workflow.

来源：README.md，提交 d7b0663

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.33.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Smartbear 集成

SmartBear MCP

com.smartbear官方发布者

SmartBear MCP 让 AI 助手访问 SmartBear 的测试与监控产品，如 BugSnag、BearQ、Swagger、PactFlow、QTM4J、Zephyr 和 Collaborator。

Streamable HTTP可网页运行鉴权
效率与工作流200+ 个工具Nov 7, 2026