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