Why use TestCollab MCP Server?

The MCP server lets your AI coding assistant interact directly with TestCollab:

Create test cases using natural language
Query existing test cases
Update test cases when code changes

Supported AI Assistants

Claude Code / Claude Desktop - Anthropic
Cursor - AI-first code editor
Windsurf - Codeium AI IDE
Codex CLI - OpenAI

Step 1: Get Your API Token

Log in to TestCollab
Click profile avatar in the top-right
Select My Profile Settings
Go to API Token tab
Click Generate new API token
Copy and store securely

Step 2: Find Your Project ID

The Project ID is the number in your URL: testcollab.io/project/16/manage

Step 3: Configure Your AI Assistant

The MCP server runs locally via npx. No hosted server needed.

Claude Code

Run this command in your terminal:

claude mcp add testcollab \
  -e TC_API_TOKEN=your-api-token \
  -e TC_API_URL=https://api.testcollab.io \
  -e TC_DEFAULT_PROJECT=16 \
  -- npx -y @testcollab/mcp-server

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Codex CLI

Add to your config.toml:

[mcp_servers.testcollab]
command = "npx"
args = ["-y", "@testcollab/mcp-server"]

[mcp_servers.testcollab.env]
TC_API_TOKEN = "your-api-token"
TC_API_URL = "https://api.testcollab.io"
TC_DEFAULT_PROJECT = "16"

Windsurf

Add to your MCP configuration in Windsurf settings (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "testcollab": {
      "command": "npx",
      "args": ["-y", "@testcollab/mcp-server"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "https://api.testcollab.io",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Self-Host Option

Clone from GitHub, run npm install and npm run build, then point your MCP client to node dist/index.js with the environment variables above.

Configuration Reference

Environment Variable	Required	Description
TC_API_TOKEN	Yes	Your TestCollab API token
TC_API_URL	No	API base URL (default: https://api.testcollab.io)
TC_DEFAULT_PROJECT	No	Your Project ID (makes project_id optional in tool calls)

EU region: If your TestCollab account is hosted in the EU, use https://api-eu.testcollab.io as your TC_API_URL.

Available Tools

Tool	Description
get_project_context	Get suites, tags, custom fields, users - call this first
list_test_cases	Query test cases with filtering, sorting, pagination
get_test_case	Fetch a test case with full step details
create_test_case	Create new test cases with title, steps, priority
update_test_case	Update existing test cases
list_test_plans	List test plans with filtering and sorting
get_test_plan	Fetch test plan with progress status
create_test_plan	Create a test plan with cases and configurations
list_suites	List all test suites in a project
create_suite / update_suite / delete_suite	Manage test suites