Qase Test Management

Install

Config snippet generator goes here (5 client tabs)

README

# Qase MCP Server

Official Model Context Protocol (MCP) server for [Qase Test Management Platform](https://qase.io).

[![npm version](https://img.shields.io/npm/v/@qase/mcp-server)](https://www.npmjs.com/package/@qase/mcp-server)
[![npm downloads](https://img.shields.io/npm/dm/@qase/mcp-server)](https://www.npmjs.com/package/@qase/mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Overview

The Qase MCP Server provides seamless integration between AI assistants (Claude, Cursor, etc.) and the Qase Test Management Platform. It enables AI assistants to interact with your test cases, test runs, defects, and other Qase entities through a standardized protocol.

### Features

- ✅ **Complete Qase API Coverage** - Access all Qase entities and operations
- ✅ **QQL Support** - Powerful Qase Query Language for advanced searches
- ✅ **Type-Safe** - Full TypeScript implementation with comprehensive validation
- ✅ **Custom Domains** - Support for enterprise custom domains

### Supported Entities

The server provides tools for managing:

- **Projects** - Create and manage test projects
- **Test Cases** - Create, update, and organize test cases
- **Test Suites** - Organize tests into hierarchical suites
- **Test Runs** - Execute test runs and track progress
- **Test Results** - Record and analyze test execution results
- **Test Plans** - Define and manage test plans
- **Defects** - Track and manage bugs
- **Milestones** - Organize work by sprints/releases
- **Environments** - Manage test environments
- **Shared Steps** - Create reusable test steps
- **Shared Parameters** - Define reusable test data
- **Attachments** - Upload and manage files
- **Custom Fields** - Define custom metadata
- **Configurations** - Manage test configurations
- **Users** - User management operations
- **QQL Search** - Advanced cross-project queries

## Installation

### Prerequisites

- Node.js 18+
- Qase account with API token ([Get your token](https://app.qase.io/user/api/token))

### Option 1: Install from NPM (Recommended)

```bash
npm install -g @qase/mcp-server
```

### Option 2: Install from Source (Development)

```bash
# Clone the repository
git clone https://github.com/qase-tms/qase-mcp-server.git
cd qase-mcp-server

# Install dependencies
npm install

# Build the server
npm run build
```

## Configuration

### Environment Variables

Create a `.env` file or set environment variables:

```bash
# Required: Your Qase API token
QASE_API_TOKEN=your_api_token_here

# Optional: Custom API domain for enterprise customers
QASE_API_DOMAIN=api.qase.io
```

Get your API token from: https://app.qase.io/user/api/token

### Custom Domains (Enterprise)

If you're using Qase Enterprise with a custom domain:

```bash
QASE_API_DOMAIN=api.yourcompany.qase.io
```

## Integration

### Claude Desktop

Add to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "qase": {
      "command": "npx",
      "args": ["-y", "@qase/mcp-server"],
      "env": {
        "QASE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

Or, if installed from source:

```json
{
  "mcpServers": {
    "qase": {
      "command": "node",
      "args": ["/absolute/path/to/qase-mcp-server/build/index.js"],
      "env": {
        "QASE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

### Cursor

1. Open Cursor Settings
2. Navigate to MCP settings
3. Add the Qase MCP server:

```json
{
  "mcpServers": {
    "qase": {
      "command": "npx",
      "args": ["-y", "@qase/mcp-server"],
      "env": {
        "QASE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

### Claude Code

You can add the Qase MCP server to Claude Code using the CLI command:

```bash
claude mcp add qase -- npx -y @qase/mcp-server
```

Set the required environment variable:

```bash
export QASE_API_TOKEN=your_api_token_here
```

Alternatively, add a `.mcp.json` file to your project root for automatic project-scoped configuration:

```json
{
  "mcpServers": {
    "qase": {
      "command": "npx",
      "args": ["-y", "@qase/mcp-server"],
      "env": {
        "QASE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

You can also use the `--scope` flag to choose where the configuration is stored:

```bash
# Project-scoped (saved in .mcp.json)
claude mcp add --scope project qase -- npx -y @qase/mcp-server

# User-scoped (available in all projects)
claude mcp add --scope user qase -- npx -y @qase/mcp-server
```

### OpenAI Codex CLI

Add a `.codex/config.json` file to your project root:

```json
{
  "mcpServers": {
    "qase": {
      "command": "npx",
      "args": ["-y", "@qase/mcp-server"],
      "env": {
        "QASE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}
```

Set the required environment variable before running Codex:

```bash
export QASE_API_TOK