convez.ai
MCP ServerAutomaçãoIntermediário
TCSoftInc

TestCollab MCP Server

TCSoftInc/testcollab-mcp-server

Integre TestCollab ao seu assistente de IA para QA automatizado

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta assistentes de IA (Claude, Cursor, Windsurf) à plataforma TestCollab para gerenciar casos de teste, planos de teste e suites diretamente da IDE. Automatiza a criação, atualização e consulta de testes sem sair do fluxo de desenvolvimento.

Instalação

$npx convez-ai TCSoftInc/testcollab-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
2
Acompanhando
1
Saúde
37%
Último commit
há 1 mês
Versão
v1.5
Issues abertas
0
Contribuidores
3

Casos de uso

  • Gerar casos de teste a partir de especificações via IA
  • Manter planos de teste sincronizados com o desenvolvimento
  • Consultar e atualizar suites de teste sem deixar o editor
  • Automatizar documentação de testes em workflow de CI/CD

Veredito

Integração robusta entre IA e gestão de testes, ideal para equipes que querem acelerar QA no fluxo de código. Bem estruturado e com documentação clara, porém depende de uma conta TestCollab ativa.

README

A tradução para o português deste README ainda está na fila.

TestCollab MCP Server

Connect your AI coding assistant to TestCollab — manage test cases, test plans, and suites directly from Claude, Cursor, Windsurf, Codex, or any MCP-compatible client.

Quick Start

1. Get your API token

Log in to TestCollab → My Profile Settings → API Token tab → Generate new API token.

2. Add the server to your MCP client

Claude Code — add to .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"
      }
    }
  }
}

Claude Desktop — add to ~/Library/Application Support/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"
      }
    }
  }
}

Manual Testing

TC_API_TOKEN=your-token npm start

Available Tools

list_test_cases

List test cases from a project with optional filtering.

Parameters:

NameTypeRequiredDescription
project_idnumberNo*Project ID (*required if TC_DEFAULT_PROJECT not set)
suitenumber|stringNoFilter by suite ID or title
filterobjectNoFilter conditions
sortarrayNoSort specification
limitnumberNoMax results (1-100, default: 50)
offsetnumberNoSkip N results (default: 0)

3. Verify

Restart your client, then ask: "What tools do you have for TestCollab?"

You should see the TestCollab tools listed. Try: "Show me all test cases".

Configuration

VariableRequiredDefaultDescription
TC_API_TOKENYes—API token from your TestCollab profile
TC_API_URLNohttps://api.testcollab.ioTestCollab API base URL
TC_DEFAULT_PROJECTNo—Default project ID (makes project_id optional in every tool call)

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

What You Can Do

ToolDescription
get_project_contextGet suites, tags, custom fields, requirements, test plan folders, releases, users — call this first
list_test_casesQuery test cases with filtering, sorting, and pagination
get_test_caseFetch a test case with full step details
create_test_caseCreate a test case with steps, tags, custom fields
update_test_caseUpdate any test case field
list_test_plansList test plans with filtering/sorting (including release ID/title filters)
get_test_planFetch one test plan with included test cases count, configurations, runs, current progress status, and release info
create_test_planCreate a test plan with cases, configurations, assignment, and optional release association
update_test_planUpdate test plan metadata, status, assignment, and release association
delete_test_planDelete a test plan
list_suitesList all test suites in a project (supports title, parent, and description filters)
get_suiteGet suite details
create_suiteCreate a new suite
update_suiteUpdate a suite
delete_suiteDelete a suite
move_suiteMove a suite to a different parent
reorder_suitesReorder suites within a parent

Example Prompts

"Show me all high-priority test cases in the Login suite"

"Create a test case for verifying password reset with 5 steps"

"List all test plans created this week"

"Create a regression test plan with all test cases tagged 'smoke'"

"Move the Payment suite under the Checkout suite"

See Use Cases for detailed workflows.

Local Development Setup

If you're contributing or want to run from source instead of npx:

git clone <repo-url>
cd tc-mcp-server
npm install
npm run build

Then point your MCP client to the built file:

{
  "mcpServers": {
    "testcollab": {
      "command": "node",
      "args": ["/path/to/tc-mcp-server/dist/index.js"],
      "env": {
        "TC_API_TOKEN": "your-api-token",
        "TC_API_URL": "http://localhost:1337",
        "TC_DEFAULT_PROJECT": "16"
      }
    }
  }
}

Dev Commands

npm run dev          # Watch mode with hot reload
npm run build        # Compile TypeScript
npm test             # Run tests
npm run typecheck    # Type check
npm run lint         # Lint

Troubleshooting

Server not appearing in your client

  • Restart the client after adding the config
  • Verify Node.js 20+ is installed: node --version
  • Test manually: TC_API_TOKEN=your-token npx @testcollab/mcp-server

Authentication errors

  • Verify your API token is valid and not expired
  • Check that TC_API_URL points to the correct server

"project_id is required" error

  • Set TC_DEFAULT_PROJECT in your env config, or
  • Specify the project in your prompt: "Show me test cases in project 16"

License

MIT

Ver o original no GitHub

Bom para

Relacionados