← Back to Docs

MCP Server

Connect Qualigate to Claude and other AI tools using the Model Context Protocol.

What is MCP?

MCP (Model Context Protocol) lets AI assistants like Claude interact with external tools and data sources. The Qualigate MCP server exposes your test suite as tools, allowing Claude to list projects, trigger tests, and retrieve results—all through natural language conversation.

Installation

Add the Qualigate MCP server to your Claude configuration. Choose the option that matches your setup:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{
  "mcpServers": {
    "qualigate": {
      "command": "npx",
      "args": ["qualigate-mcp"],
      "env": {
        "QUALIGATE_API_KEY": "qg_your_api_key_here"
      }
    }
  }
}

Claude Code

Edit ~/.claude/settings.json:

json
{
  "mcpServers": {
    "qualigate": {
      "command": "npx",
      "args": ["qualigate-mcp"],
      "env": {
        "QUALIGATE_API_KEY": "qg_your_api_key_here"
      }
    }
  }
}

Available Tools

list_projects

List all your projects in Qualigate.

list_test_cases

List test cases for a specific project.

Parameters: project_id

trigger_test

Trigger a test run for a specific test case or all tests in a project.

Parameters: test_case_id, test_suite_id, or project_id

get_test_run

Get detailed information about a specific test run.

Parameters: test_run_id

get_results

Get aggregated results from one or multiple test runs.

Parameters: test_run_ids or suite_run_id

Usage Examples

Once the MCP server is configured, you can ask Claude to perform test operations naturally:

Example 1:"Run the login test for my project"
Example 2:"Check the results of my latest test run"
Example 3:"List all test cases for my Project X"
Example 4:"Trigger all tests and show me the summary"

Getting Your API Key

To use the Qualigate MCP server, you'll need an API key:

  1. Sign in to Qualigate
  2. Go to Settings → API Keys
  3. Click "Create API Key"
  4. Copy your key and add it to the configuration as QUALIGATE_API_KEY

Keep your API key secret. Never commit it to version control or share it publicly.

Need help? Check out the full documentation or contact support at support@qualigate.app