TestCollab MCP服务器
将您的AI编码助手连接到 TestCollab --直接从Claude、Cursor、Windsurf、Codex或任何兼容MCP的客户端管理测试用例、测试计划和套件。
快速开始
1.获取您的API代币
登录TestCollab→ 我的个人资料设置 → API代币 tab → 生成新的API令牌.
2.将服务器添加到MCP客户端
克劳德代码 --添加到 .mcp.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"
}
}
}
}克劳德桌面版 --添加到 ~/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/mcp.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"
}
}
}
}手动测试
TC_API_TOKEN=your-token npm start可用工具
list_test_cases
列出项目中具有可选筛选的测试用例。
参数：
| 名称 | 类型 | 必填 | 描述 | |
|---|---|---|---|---|
project_id | number | 否\* | 项目ID（如果需要，则需要\* TC_DEFAULT_PROJECT 未设置） | |
suite | number | string | No | 按套件ID或标题筛选 |
filter | object | 否 | 筛选条件 | |
sort | array | 否 | 排序规范 | |
limit | number | No | 最大结果（1-100，默认值：50） | |
offset | number | 否 | 跳过N个结果（默认值：0） |
3.验证
重新启动客户端，然后问： *“你们有什么用于TestColab的工具？”*
您应该看到列出的TestColab工具。尝试： *“显示所有测试用例”*.
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
TC_API_TOKEN | 是 | - | TestCollab配置文件中的API令牌 |
TC_API_URL | 没有 | https://api.testcollab.io | TestCollab API基础URL |
TC_DEFAULT_PROJECT | 否 | -- | 默认项目ID（制造商 project_id 在每次工具调用中都是可选的） |
欧盟地区： 如果您的TestCollab帐户托管在欧盟，请使用https://api-eu.testcollab.io如你的TC_API_URL.
你能做什么
| 工具 | 说明 |
|---|---|
| get_project_context | 获取套件、标签、自定义字段、需求、测试计划文件夹、版本、用户——先调用这个 |
| list_test_cases | 使用过滤、排序和分页查询测试用例 |
| get_test_case | 获取包含完整步骤详细信息的测试用例 |
| create_test_case | 使用步骤、标签和自定义字段创建测试用例 |
| update_test_case | 更新任何测试用例字段 |
| list_test_plans | 列出带有过滤/排序的测试计划（包括发布ID/标题过滤器） |
| get_test_plan | 获取一个包含测试用例计数、配置、运行、当前进度状态和发布信息的测试计划 |
| 创建测试计划 | 创建包含案例、配置、分配和可选发布关联的测试计划 |
| update_test_plan | 更新测试计划元数据、状态、分配和发布关联 |
| 删除测试计划 | 删除测试计划 |
| list_suite | 列出项目中的所有测试套件（支持 title, parent，以及 description 过滤器） |
| get_suite | 获取套房详细信息 |
| create_suite | 创建新套件 |
| update_suite | 更新套件 |
| delete_suite | 删除套件 |
| move_suite | 将套房移动到其他家长 |
| 重新订购_套装 | 在家长内部重新订购套房 |
示例提示
"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"看 用例 了解详细的工作流程。
地方发展设置
如果你正在贡献或想从源代码而不是npx运行：
git clone
cd tc-mcp-server
npm install
npm run build然后将MCP客户端指向构建的文件：
{
"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"
}
}
}
}开发命令
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故障排除
服务器未出现在您的客户端中
- 添加配置后重新启动客户端
- 验证是否安装了Node.js 20+：
node --version - 手动测试：
TC_API_TOKEN=your-token npx @testcollab/mcp-server
身份验证错误
- 验证您的API令牌是否有效且未过期
- 检查一下
TC_API_URL指向正确的服务器
“project_id是必需的”错误
- 集
TC_DEFAULT_PROJECT在您的env配置中，或 - 在提示中指定项目： *“显示项目16中的测试用例”*
许可证
麻省理工学院