home / mcp / qa sphere mcp server

QA Sphere MCP Server

MCP Server for QA Sphere TMS

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hypersequent-qasphere-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qasphere-mcp"
      ],
      "env": {
        "QASPHERE_API_KEY": "your-api-key",
        "QASPHERE_TENANT_URL": "your-company.region.qasphere.com"
      }
    }
  }
}

You use this MCP server to connect QA Sphere test management with MCP-enabled clients, letting you discover, summarize, and chat about test cases directly from your development tools.

How to use

You connect an MCP client to QA Sphere to interact with your test cases. With the server you can discover relevant test cases, get concise summaries, and chat about them within your IDE or editor. Use it to reference specific QA Sphere test cases as you write, review, or plan work, keeping context close at hand without leaving your coding environment.

How to install

Prerequisites: you need Node.js (recent LTS versions) and access to QA Sphere with an API key. Have your QA Sphere URL handy (for example: your-company.qasphere.com). Then install and run the MCP server via npx so it can be used by MCP clients.

Check your Node.js and npm versions to confirm you have a modern runtime.

Run the MCP server using the inline configuration described below. This starts the server in a way that MCP clients can connect directly.

Configuration template (use this in any MCP client to register QA Sphere as an MCP server):

Configuration template

{
  "mcpServers": {
    "qasphere": {
      "command": "npx",
      "args": ["-y", "qasphere-mcp"],
      "env": {
        "QASPHERE_TENANT_URL": "your-company.region.qasphere.com",
        "QASPHERE_API_KEY": "your-api-key"
      }
    }
  }
}

Usage tips

Set your environment variables before starting the server if your shell requires it. For example, on Unix-like systems you can export the values, then run the MCP command. On Windows, set the variables in the Command Prompt or PowerShell session before launching.

Additional notes

The server is intended to be used with MCP clients that support JSON-RPC style communication. Once connected, you can browse QA Sphere test cases, request summaries, and engage in conversational queries about the test assets you reference.

Available tools

discover_test_cases

Find QA Sphere test cases relevant to your current context or query within MCP-enabled IDEs.

summarize_test_cases

Generate concise summaries of selected QA Sphere test cases to aid quick understanding and planning.

chat_test_cases

Engage in chat-style interactions about QA Sphere test cases to ask questions, get clarifications, and discuss details.