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

Server URL: https://mcp.testcollab.io/mcp

Claude Code / 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": {
      "url": "https://mcp.testcollab.io/mcp",
      "headers": {
        "X-TC-API-Token": "your-api-token",
        "X-TC-API-URL": "https://api.testcollab.io",
        "X-TC-Default-Project": "16"
      }
    }
  }
}

Cursor

Open Cursor Settings → MCP Servers → Add new server:

{
  "testcollab": {
    "url": "https://mcp.testcollab.io/mcp",
    "headers": {
      "X-TC-API-Token": "your-api-token",
      "X-TC-API-URL": "https://api.testcollab.io",
      "X-TC-Default-Project": "16"
    }
  }
}

Codex CLI

Add to your config.toml:

[mcp_servers.testcollab]
url = "https://mcp.testcollab.io/mcp"
http_headers = { "X-TC-Default-Project" = "16", "X-TC-API-Token" = "your-api-token", "X-TC-API-URL" = "https://api.testcollab.io" }

Windsurf

Add to your MCP configuration in Windsurf settings:

{
  "testcollab": {
    "url": "https://mcp.testcollab.io/mcp",
    "headers": {
      "X-TC-API-Token": "your-api-token",
      "X-TC-API-URL": "https://api.testcollab.io",
      "X-TC-Default-Project": "16"
    }
  }
}

Self-Host Option

Clone from GitHub, run npm install, npm run build, then node dist/http-server.js (runs on port 3100)

Configuration Reference

Header	Required	Description
X-TC-API-Token	Yes	Your TestCollab API token
X-TC-API-URL	Yes	https://api.testcollab.io
X-TC-Default-Project	Yes	Your Project ID

Available Tools

Tool	Description
list_test_cases	Query test cases with filtering, sorting, pagination
create_test_case	Create new test cases with title, steps, priority
update_test_case	Update existing test cases