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, add an API key, and follow the setup instructions shown there. See the QA Sphere documentation for details.

The instructions below are kept for reference only. While running the standalone server, it points this out once per session; set QASPHERE_MCP_HIDE_MIGRATION_NOTICE=1 to silence that.

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

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

Cursor

Option 1: Manual Configuration

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

Option 2: Quick Install

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

5ire

1. Open 'Tools' and press 'New'
2. 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.