MCP Server

Overview

The Model Context Protocol (MCP) is an open standard that lets AI agents interact with external tools and services. The TestKase MCP Server (@testkase/mcp-server) connects any MCP-compatible AI agent to your TestKase workspace — giving it full access to create test cases, run cycles, pull reports, and manage your entire test lifecycle through natural language.

Supported AI agents:

• Claude Desktop — Anthropic's desktop app
• GitHub Copilot — VS Code agent mode
• Claude Code — Anthropic's CLI agent
• Cursor — AI-powered code editor

Prerequisites

Before setting up the MCP server, make sure you have:

1. A TestKase account — sign up free if you don't have one.
2. A Personal Access Token (PAT) — generate one from Settings → API Keys. See the API Keys guide for details.
3. An MCP-compatible AI agent — Claude Desktop, GitHub Copilot (VS Code), Claude Code, or Cursor.

Installation & Setup

The MCP server runs via npx — no global install needed. Configure your AI agent with the JSON config below.

Claude Desktop

Add to your Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "testkase": {
      "command": "npx",
      "args": ["-y", "@testkase/mcp-server"],
      "env": {
        "TESTKASE_API_BASE_URL": "https://api.testkase.com",
        "TESTKASE_PAT_TOKEN": "YOUR_PAT_TOKEN"
      }
    }
  }
}

1. Open or create the config file at the path above.
2. Paste the JSON block, replacing YOUR_PAT_TOKEN with your actual token.
3. Save the file and restart Claude Desktop.
4. Look for the hammer icon (🔨) in the chat — it shows available MCP tools.

GitHub Copilot (VS Code)

Add to your Copilot MCP config file:

• Windows: %APPDATA%\Code\User\globalStorage\github.copilot\mcp.json
• macOS: ~/Library/Application Support/Code/User/globalStorage/github.copilot/mcp.json

{
  "mcpServers": {
    "testkase": {
      "command": "npx",
      "args": ["-y", "@testkase/mcp-server"],
      "env": {
        "TESTKASE_API_BASE_URL": "https://api.testkase.com",
        "TESTKASE_PAT_TOKEN": "YOUR_PAT_TOKEN"
      }
    }
  }
}

1. Open or create the config file at the path above.
2. Paste the JSON block, replacing YOUR_PAT_TOKEN with your actual token.
3. Restart VS Code or reload the Copilot extension.

Claude Code (CLI)

Run this single command to register the MCP server:

claude mcp add testkase \
  -e TESTKASE_API_BASE_URL=https://api.testkase.com \
  -e TESTKASE_PAT_TOKEN=YOUR_PAT_TOKEN \
  -- npx -y @testkase/mcp-server

That's it — restart Claude Code and the tools are available immediately.

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "testkase": {
      "command": "npx",
      "args": ["-y", "@testkase/mcp-server"],
      "env": {
        "TESTKASE_API_BASE_URL": "https://api.testkase.com",
        "TESTKASE_PAT_TOKEN": "YOUR_PAT_TOKEN"
      }
    }
  }
}

1. Create the .cursor directory in your project root if it doesn't exist.
2. Create mcp.json with the config above, replacing YOUR_PAT_TOKEN.
3. Restart Cursor to pick up the new MCP server.

Available Tools

The MCP server exposes 11 tools covering the full test management lifecycle:

Reporting

The get_report tool covers execution, coverage, trends, team, defect, and AI-powered report types:

Configuration

Example Conversations

Here are some things you can say to your AI agent once the MCP server is connected:

Troubleshooting

Next Steps