zephyr-scale

# Zephyr Scale

Zephyr Scale is a test management application that integrates with Jira. QA teams and software testers use it to plan, execute, and track software testing efforts within the Jira ecosystem.

Official docs: https://support.smartbear.com/zephyr-scale-cloud/api-docs/

## Zephyr Scale Overview

- **Test Case**
- **Test Execution**
- **Test Cycle**
- **Test Plan**
- **Project**
- **Version**
- **Environment**
- **User**
- **Attachment**
- **Comment**
- **Custom Field**
- **Folder**
  - **Test Case**
- **Requirement**
- **Defect**

Use action names and parameters as needed.

## Working with Zephyr Scale

This skill uses the Membrane CLI to interact with Zephyr Scale. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.

### Install the CLI

Install the Membrane CLI so you can run `membrane` from the terminal:

```bash
npm install -g @membranehq/cli
```

### First-time setup

```bash
membrane login --tenant
```

A browser window opens for authentication.

**Headless environments:** Run the command, copy the printed URL for the user to open in a browser, then complete with `membrane login complete <code>`.

### Connecting to Zephyr Scale

1. **Create a new connection:**
   ```bash
   membrane search zephyr-scale --elementType=connector --json
   ```
   Take the connector ID from `output.items[0].element?.id`, then:
   ```bash
   membrane connect --connectorId=CONNECTOR_ID --json
   ```
   The user completes authentication in the browser. The output contains the new connection id.

### Getting list of existing connections
When you are not sure if connection already exists:
1. **Check existing connections:**
   ```bash
   membrane connection list --json
   ```
   If a Zephyr Scale connection exists, note its `connectionId`


### Searching for actions

When you know what you want to do but not the exact action ID:

```bash
membrane action list --intent=QUERY --connectionId=C...