QA Sphere MCP Server

[!IMPORTANT] This repository is archived and no longer maintained.

QA Sphere now serves an MCP server directly — there is no need to run this standalone package. The hosted server is always up to date with the QA Sphere API, exposes the full set of tools allowed by your role, and needs nothing installed locally.

Recommended setup: in QA Sphere go to Settings ⚙️ → MCP Server, pick your assistant and access level, paste or create an API key, and copy the generated command. For Claude Code it looks like this:
claude mcp add --transport http qasphere https://your-company.region.qasphere.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
The instructions below are kept for reference only.

A Model Context Protocol server for the QA Sphere test management system.

This integration enables Large Language Models (LLMs) to interact directly with QA Sphere test cases, allowing you to discover, summarize, and chat about test cases. In AI-powered IDEs that support MCP, you can reference specific QA Sphere test cases within your development workflow.

Prerequisites

Node.js (>=22)
QA Sphere account with API access
API key from QA Sphere (Settings ⚙️ → API Keys → Add API Key)
Your company's QA Sphere URL (e.g., example.eu2.qasphere.com)

Setup Instructions

This server is compatible with any MCP client. Configuration instructions for popular clients are provided below.

Claude Desktop

Navigate to Claude → Settings → Developer → Edit Config
Open claude_desktop_config.json
Add the QA Sphere configuration to the mcpServers dictionary

Cursor

Option 1: Manual Configuration

Go to Settings... → Cursor settings → Add new global MCP server
Add the QA Sphere configuration

Option 2: Quick Install

Click the button below to automatically install and configure the QA Sphere MCP server:

5ire

Open 'Tools' and press 'New'
Complete the form with:
- Tool key: qasphere
- Command: npx -y qasphere-mcp
- Environment variables (see below)

Configuration Template

For any MCP client, use the following configuration format:

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

Replace the placeholder values with your actual QA Sphere URL and API key.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or need assistance, please file an issue on the GitHub repository.

Qasphere

Installation

Configuration

How to use

README