@testkase/mcp-server


Model Context Protocol (MCP) server for TestKase API. Enables AI agents like Claude Desktop and GitHub Copilot to interact with your TestKase testcase management system.

Features

✨ Get Testcases - Retrieve testcases with advanced filtering and search
📊 Pagination - Control page size and navigate through results
🔍 Advanced Filtering - Filter by status, priority, dates, custom fields
🔎 Search - Text search and AI-powered semantic search
🔐 Secure - Uses Personal Access Token (PAT) authentication
🤖 AI-Ready - Works with Claude Desktop, GitHub Copilot, and other MCP clients

Installation

$3

``bash
npm install -g @testkase/mcp-server
`

$3

`bash
npm install @testkase/mcp-server
`

Quick Start

$3

1. Log in to TestKase
2. Navigate to Settings → Personal Access Tokens
3. Click "Generate New Token"
4. Copy the token (starts with xyz_)

$3

#### For Claude Desktop

Edit your Claude config file:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

#### For GitHub Copilot (VS Code)

Edit your Copilot config file:
- Windows: %APPDATA%\Code\User\globalStorage\github.copilot\mcp.json
- macOS: ~/Library/Application Support/Code/User/globalStorage/github.copilot/mcp.json

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

$3

- Claude Desktop: Close and reopen completely
- VS Code: Restart VS Code

$3

Ask your AI agent:
- "Get testcases for project PRJ-1030 in organization 1171"
- "Show high priority testcases from project ABC-123"
- "Find testcases containing 'login' in project XYZ-456"

Available Tools (26 Total)

$3

- get_testcases - Retrieve testcases with filtering, pagination, and search
- get_testcase_detail - Get detailed information about a specific testcase
- get_testcase_history - View complete change history of a testcase
- create_testcase - Create a new testcase with optional test steps
- create_bulk_testcase - Create multiple testcases at once
- update_testcase_field - Update specific fields for one or multiple testcases
- delete_testcase - Delete single or multiple testcases
- clone_testcase - Clone an existing testcase with all its steps
- create_test_step - Create or update test steps for a testcase
- delete_test_step - Delete test steps from a testcase
- download_testcases - Download testcases as CSV file
- import_testcases - Import testcases from CSV file

$3

- get_folders - Get folder/section structure of a project
- create_folder - Create a new folder in a project
- delete_folder - Delete a folder and its subfolders
- update_folder - Rename or update folder details

$3

- get_labels - Get all labels/tags available in a project
- create_label - Create new labels for a project

$3

- get_my_projects - Get all projects the user has access to

$3

- get_user_profile - Get current logged-in user profile information
- get_organization - Get current user organization details

$3

- get_mapped_issues - Get mapped issues for a specific testcase
- search_issues - Search issues from integrated platforms (Jira, GitHub, GitLab)
- map_issues - Map integration issues to a TestKase requirement/defect

$3

- generate_testcases - Generate testcases using AI from requirement text
- create_issue - Create or update a requirement or defect issue

Configuration

$3

- TESTKASE_API_BASE_URL: API base URL (default: https://apiqa.testkase.com)
- TESTKASE_PAT_TOKEN: Your Personal Access Token (required)

$3

Production:
`json
"env": {
"TESTKASE_API_BASE_URL": "https://api.testkase.com",
"TESTKASE_PAT_TOKEN": "xyz_your_token"
}
`

Local Development:
`json
"env": {
"TESTKASE_API_BASE_URL": "http://localhost:8080",
"TESTKASE_PAT_TOKEN": "xyz_your_token"
}
`

Usage Examples

$3

`
"Show me testcases for project PRJ-1030 organization 1171"
"Get high priority active testcases from project PRJ-1030 org 1171"
"Find testcases about 'authentication' in project PRJ-1030 org 1171"
"Show testcases updated this week in project PRJ-1030 org 1171"
`

$3

`
"Get detailed information about testcase TC-123 in project PRJ-1030 org 1171"
"Show me the history of changes for testcase TC-456 in project PRJ-1030 org 1171"
`

$3

`
"Show me all folders in project PRJ-1030 org 1171"
"List all labels available in project PRJ-1030 org 1171"
"Get all issues/defects for project PRJ-1030 org 1171"
`

$3

`
"Show me all my projects"
"List all projects I have access to"
`

Troubleshooting

$3

- Verify your PAT token is correct and starts with xyz_
- Check that the token hasn't been revoked
- Ensure it hasn't expired

$3

1. Restart your AI agent completely
2. Check the config file path is correct
3. Verify the JSON syntax is valid

$3

- Check that the API base URL is correct
- Verify the TestKase API is accessible
- Test with curl: curl -H "Authorization: Bearer xyz_YOUR_TOKEN" https://apiqa.testkase.com/api/v1/projects/testcases/get-testcase/PROJECT_ID?organizationId=ORG_ID`

Documentation

- TestKase Documentation
- Model Context Protocol

Support

- 📧 Email: support@testkase.com
- 🌐 Website: testkase.com

Security

- PAT tokens are sent securely via HTTPS
- Tokens are validated by TestKase's backend
- Each user has their own unique token
- Tokens can be revoked at any time

License

MIT © TestKase