Zephyr Scale MCP Server

MCP Server for Zephyr Scale test management tool.

Features

This MCP server provides comprehensive access to Zephyr Scale API v2, enabling:

- Test Case Management: Create, read, update test cases and test steps
- Test Planning: Manage test plans and link them to test cycles
- Test Execution: Create and track test executions within test cycles
- Folder Organization: Organize test artifacts with folders
- Status Management: Manage custom statuses for test entities
- Link Management: Create web links, issue links, and entity links between test artifacts
- Read-only Access: List priorities and environments configured in your project

Available Tools

$3

| Tool Name | Description |
|-----------|-------------|
| listTestCases | List test cases in a project |
| createTestCase | Create a new test case |
| getTestCase | Get details of a specific test case |
| updateTestCase | Update an existing test case |
| getTestCaseTestSteps | Get test steps for a test case |
| createTestCaseTestSteps | Create or append test steps to a test case (supports APPEND/OVERWRITE modes). Tip: Use OVERWRITE mode for the first time to avoid unwanted empty placeholder steps |
| createTestCaseWebLink | Create a web link for a test case |
| createTestCaseIssueLink | Create an issue link for a test case |

$3

| Tool Name | Description |
|-----------|-------------|
| listFolders | List folders in a project |
| createFolder | Create a new folder |
| getFolder | Get details of a specific folder |

$3

| Tool Name | Description |
|-----------|-------------|
| listTestPlans | List test plans in a project |
| createTestPlan | Create a new test plan |
| getTestPlan | Get details of a specific test plan |
| createTestPlanWebLink | Create a web link for a test plan |
| createTestPlanIssueLink | Create an issue link for a test plan |
| createTestPlanTestCycleLink | Create a test cycle link for a test plan |

$3

| Tool Name | Description |
|-----------|-------------|
| listTestCycles | List test cycles in a project |
| createTestCycle | Create a new test cycle |
| getTestCycle | Get details of a specific test cycle |
| updateTestCycle | Update an existing test cycle |
| createTestCycleWebLink | Create a web link for a test cycle |
| createTestCycleIssueLink | Create an issue link for a test cycle |

$3

| Tool Name | Description |
|-----------|-------------|
| listTestExecutions | List test executions in a project |
| createTestExecution | Create a new test execution |
| getTestExecution | Get details of a specific test execution |
| createTestExecutionIssueLink | Create an issue link for a test execution |

$3

| Tool Name | Description |
|-----------|-------------|
| listStatuses | List statuses |
| createStatus | Create a new status |
| getStatus | Get details of a specific status |

$3

| Tool Name | Description |
|-----------|-------------|
| listPriorities | List priorities (read-only) |

$3

| Tool Name | Description |
|-----------|-------------|
| listEnvironments | List environments (read-only) |

$3

| Tool Name | Description |
|-----------|-------------|
| deleteLink | Delete a link |

Installation

$3

Add the following configuration to your .mcp.json:

``json
{
"mcpServers": {
"zephyr-scale": {
"command": "npx",
"args": ["-y", "mcp-zephyr-scale"],
"env": {
"ZEPHYR_API_TOKEN": "your-api-token-here",
"JIRA_PROJECT_KEY": "YOUR_PROJECT"
}
},
"atlassian": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
}
}
}
`

Why use both servers?
- Zephyr Scale MCP: Provides test management functionality (test cases, test plans, test cycles, test executions)
- Atlassian MCP: Provides Jira issue management and Confluence documentation access

This combination allows you to create Jira issues with API specifications and link them to test cases, creating full traceability from requirements to test execution.

$3

- ZEPHYR_API_TOKEN: Your Zephyr Scale API token
- JIRA_PROJECT_KEY: Your Jira project key (e.g., "KAN")

$3

1. In Jira, click your profile picture
2. Select "Zephyr API keys"
3. Generate a new API key

For more information, see the Zephyr Scale documentation.

$3

When you first add the Atlassian MCP Server:
1. The server will prompt you to authorize access via OAuth
2. You'll be redirected to Atlassian to complete authentication
3. Select which products to allow access (Jira and/or Confluence)
4. Click "Approve" to complete the authentication

If your authentication expires, you can reconnect using:
- Claude Code: Run the /mcp command to manage MCP server connections and select "Reconnect" for the Atlassian server

Development

$3

`bash


Install dependencies

npm install

Build the project

npm run build

Run tests

npm test

Format code

npm run format

Lint code

npm run lint

Check code (lint + format)

npm run check
`

$3

For development, you can test the local build instead of the NPM package. Add the following configuration to your .mcp.json:

`json
{
"mcpServers": {
"zephyr-scale": {
"command": "node",
"args": ["/absolute/path/to/mcp-zephyr-scale/dist/index.js"],
"env": {
"ZEPHYR_API_TOKEN": "your-api-token-here",
"JIRA_PROJECT_KEY": "YOUR_PROJECT"
}
}
}
}
`

Replace /absolute/path/to/mcp-zephyr-scale` with the actual absolute path to your local repository.

License

MIT