io.github.vilaabo/zephyr-scale-mcp MCP Server

Name: io.github.vilaabo/zephyr-scale-mcp MCP Server
Author: io.github.vilaabo

io.github.vilaabo/zephyr-scale-mcp

Repository Registry

What is the io.github.vilaabo/zephyr-scale-mcp MCP server?

Zephyr Scale on self-hosted Jira Server/DC: test cases, cycles, executions, plans and attachments

How to install io.github.vilaabo/zephyr-scale-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

JIRA_BASE_URL
required
Jira base URL without a trailing slash, e.g. https://jira.example.com
JIRA_PAT
secret
Jira Data Center Personal Access Token (used when JIRA_AUTH=pat, the default)
JIRA_AUTH
Authentication mode: pat (default) or basic
JIRA_USERNAME
Username for JIRA_AUTH=basic
JIRA_PASSWORD
secret
Password for JIRA_AUTH=basic
ZEPHYR_DEFAULT_PROJECT_KEY
Project key used when a tool is called without projectKey
ZEPHYR_ALLOW_INTERNAL_API
true registers 11 UNOFFICIAL tools backed by the internal /rest/tests/1.0 API the vendor does not support: editing a test cycle in place (rename/move, add/remove/reorder its cases), editing or DELETING individual executions, linking a cycle to a test plan, the folder tree, folder deletion, exact status names and custom field definitions
ZEPHYR_READONLY
true disables all write tools
JIRA_TLS_REJECT_UNAUTHORIZED
false allows self-signed certificates (disables TLS verification)
JIRA_TIMEOUT_MS
Timeout of a single HTTP request in milliseconds (default 30000)
JIRA_MAX_RETRIES
Retries for GET requests and for 429/503 responses, honoring Retry-After (default 2)
ZEPHYR_LOG_LEVEL
Log verbosity: debug | info | warn | error (default info; all logs go to stderr)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zephyr-scale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<YOUR_JIRA_BASE_URL>",
        "JIRA_PAT": "<YOUR_JIRA_PAT>",
        "JIRA_AUTH": "<YOUR_JIRA_AUTH>",
        "JIRA_USERNAME": "<YOUR_JIRA_USERNAME>",
        "JIRA_PASSWORD": "<YOUR_JIRA_PASSWORD>",
        "ZEPHYR_DEFAULT_PROJECT_KEY": "<YOUR_ZEPHYR_DEFAULT_PROJECT_KEY>",
        "ZEPHYR_ALLOW_INTERNAL_API": "<YOUR_ZEPHYR_ALLOW_INTERNAL_API>",
        "ZEPHYR_READONLY": "<YOUR_ZEPHYR_READONLY>",
        "JIRA_TLS_REJECT_UNAUTHORIZED": "<YOUR_JIRA_TLS_REJECT_UNAUTHORIZED>",
        "JIRA_TIMEOUT_MS": "<YOUR_JIRA_TIMEOUT_MS>",
        "JIRA_MAX_RETRIES": "<YOUR_JIRA_MAX_RETRIES>",
        "ZEPHYR_LOG_LEVEL": "<YOUR_ZEPHYR_LOG_LEVEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "zephyr-scale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<YOUR_JIRA_BASE_URL>",
        "JIRA_PAT": "<YOUR_JIRA_PAT>",
        "JIRA_AUTH": "<YOUR_JIRA_AUTH>",
        "JIRA_USERNAME": "<YOUR_JIRA_USERNAME>",
        "JIRA_PASSWORD": "<YOUR_JIRA_PASSWORD>",
        "ZEPHYR_DEFAULT_PROJECT_KEY": "<YOUR_ZEPHYR_DEFAULT_PROJECT_KEY>",
        "ZEPHYR_ALLOW_INTERNAL_API": "<YOUR_ZEPHYR_ALLOW_INTERNAL_API>",
        "ZEPHYR_READONLY": "<YOUR_ZEPHYR_READONLY>",
        "JIRA_TLS_REJECT_UNAUTHORIZED": "<YOUR_JIRA_TLS_REJECT_UNAUTHORIZED>",
        "JIRA_TIMEOUT_MS": "<YOUR_JIRA_TIMEOUT_MS>",
        "JIRA_MAX_RETRIES": "<YOUR_JIRA_MAX_RETRIES>",
        "ZEPHYR_LOG_LEVEL": "<YOUR_ZEPHYR_LOG_LEVEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zephyr-scale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<YOUR_JIRA_BASE_URL>",
        "JIRA_PAT": "<YOUR_JIRA_PAT>",
        "JIRA_AUTH": "<YOUR_JIRA_AUTH>",
        "JIRA_USERNAME": "<YOUR_JIRA_USERNAME>",
        "JIRA_PASSWORD": "<YOUR_JIRA_PASSWORD>",
        "ZEPHYR_DEFAULT_PROJECT_KEY": "<YOUR_ZEPHYR_DEFAULT_PROJECT_KEY>",
        "ZEPHYR_ALLOW_INTERNAL_API": "<YOUR_ZEPHYR_ALLOW_INTERNAL_API>",
        "ZEPHYR_READONLY": "<YOUR_ZEPHYR_READONLY>",
        "JIRA_TLS_REJECT_UNAUTHORIZED": "<YOUR_JIRA_TLS_REJECT_UNAUTHORIZED>",
        "JIRA_TIMEOUT_MS": "<YOUR_JIRA_TIMEOUT_MS>",
        "JIRA_MAX_RETRIES": "<YOUR_JIRA_MAX_RETRIES>",
        "ZEPHYR_LOG_LEVEL": "<YOUR_ZEPHYR_LOG_LEVEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "zephyr-scale-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<YOUR_JIRA_BASE_URL>",
        "JIRA_PAT": "<YOUR_JIRA_PAT>",
        "JIRA_AUTH": "<YOUR_JIRA_AUTH>",
        "JIRA_USERNAME": "<YOUR_JIRA_USERNAME>",
        "JIRA_PASSWORD": "<YOUR_JIRA_PASSWORD>",
        "ZEPHYR_DEFAULT_PROJECT_KEY": "<YOUR_ZEPHYR_DEFAULT_PROJECT_KEY>",
        "ZEPHYR_ALLOW_INTERNAL_API": "<YOUR_ZEPHYR_ALLOW_INTERNAL_API>",
        "ZEPHYR_READONLY": "<YOUR_ZEPHYR_READONLY>",
        "JIRA_TLS_REJECT_UNAUTHORIZED": "<YOUR_JIRA_TLS_REJECT_UNAUTHORIZED>",
        "JIRA_TIMEOUT_MS": "<YOUR_JIRA_TIMEOUT_MS>",
        "JIRA_MAX_RETRIES": "<YOUR_JIRA_MAX_RETRIES>",
        "ZEPHYR_LOG_LEVEL": "<YOUR_ZEPHYR_LOG_LEVEL>"
      }
    }
  }
}

Claude Code

claude mcp add zephyr-scale-mcp --env JIRA_BASE_URL=<YOUR_JIRA_BASE_URL> --env JIRA_PAT=<YOUR_JIRA_PAT> --env JIRA_AUTH=<YOUR_JIRA_AUTH> --env JIRA_USERNAME=<YOUR_JIRA_USERNAME> --env JIRA_PASSWORD=<YOUR_JIRA_PASSWORD> --env ZEPHYR_DEFAULT_PROJECT_KEY=<YOUR_ZEPHYR_DEFAULT_PROJECT_KEY> --env ZEPHYR_ALLOW_INTERNAL_API=<YOUR_ZEPHYR_ALLOW_INTERNAL_API> --env ZEPHYR_READONLY=<YOUR_ZEPHYR_READONLY> --env JIRA_TLS_REJECT_UNAUTHORIZED=<YOUR_JIRA_TLS_REJECT_UNAUTHORIZED> --env JIRA_TIMEOUT_MS=<YOUR_JIRA_TIMEOUT_MS> --env JIRA_MAX_RETRIES=<YOUR_JIRA_MAX_RETRIES> --env ZEPHYR_LOG_LEVEL=<YOUR_ZEPHYR_LOG_LEVEL> -- npx -y zephyr-scale-mcp