# Qase Test Management

Connects AI assistants to Qase test cases, test runs, and defect reports. Ideal for triaging failures, reporting CI outcomes, and inspecting test suites.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 37
- Author: qase-tms
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qase-tms/qase-mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/qase-test-management

## What it does

The server exposes 42 tools to interact with Qase directly from chat. 40 task-focused tools handle composite operations like defect triage, CI test run reporting, and regression suite assembly in single steps. Built-in Qase Query Language (QQL) support lets assistants search across test runs, cases, and defect logs with structured filters.

Connection depends on your Qase tier. Paid accounts can use the hosted endpoint at `https://mcp.qase.io/mcp` (or `https://mcp-eu.qase.io/mcp` for the EU cluster) without handling tokens. Free tier teams must run the package locally via `npx` and pass their own `QASE_API_TOKEN`.

Approving and merging test case reviews remains restricted to the Qase web UI. An assistant can submit draft changes, assign reviewers, or check status, but cannot approve them. Direct REST calls remain possible via the fallback `qase_api` tool when specific endpoints are needed.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.qase.io/mcp`
- Environment variables: `QASE_API_TOKEN`, `QASE_API_DOMAIN`, `QASE_API_PROTOCOL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.qase.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env QASE_API_TOKEN=<QASE_API_TOKEN> --env QASE_API_DOMAIN=<QASE_API_DOMAIN> --env QASE_API_PROTOCOL=<QASE_API_PROTOCOL> --transport stdio qase-test-management -- npx -y @qase/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add qase-test-management --url https://mcp.qase.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add qase-test-management --env QASE_API_TOKEN=<QASE_API_TOKEN> --env QASE_API_DOMAIN=<QASE_API_DOMAIN> --env QASE_API_PROTOCOL=<QASE_API_PROTOCOL> -- npx -y @qase/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qase-test-management": {
            "url": "https://mcp.qase.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qase-test-management": {
            "command": "npx",
            "args": [
                "-y",
                "@qase/mcp-server"
            ],
            "env": {
                "QASE_API_TOKEN": "<QASE_API_TOKEN>",
                "QASE_API_DOMAIN": "<QASE_API_DOMAIN>",
                "QASE_API_PROTOCOL": "<QASE_API_PROTOCOL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "qase-test-management": {
            "type": "http",
            "url": "https://mcp.qase.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "qase-test-management": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@qase/mcp-server"
            ],
            "env": {
                "QASE_API_TOKEN": "<QASE_API_TOKEN>",
                "QASE_API_DOMAIN": "<QASE_API_DOMAIN>",
                "QASE_API_PROTOCOL": "<QASE_API_PROTOCOL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http qase-test-management https://mcp.qase.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e QASE_API_TOKEN=<QASE_API_TOKEN> -e QASE_API_DOMAIN=<QASE_API_DOMAIN> -e QASE_API_PROTOCOL=<QASE_API_PROTOCOL> qase-test-management npx -y @qase/mcp-server
```
Replace <…> with your own values

## When to use it
- file defect tickets in Qase from automated test failures
- report CI execution results back to active test runs
- query test cases and defect histories using QQL
- inspect suite hierarchies and project milestone context

## Example prompts
- File a blocker defect in project DEMO for the authentication timeout in run #42
- Submit test run results to DEMO: case 101 passed, case 102 failed with connection reset
- Fetch project DEMO structure including test suites, milestones, and active environments

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4996

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
