AIO MCP Server

AIO MCP Server

A Model Context Protocol (MCP) server for interacting with Jira AIO (All-in-One) Test Case Management System.

Features

• Get test case details from AIO
• Search test cases by project and/or folders
• Get folder structure of a project
• Get list of all projects in AIO
• Create and update test cases (title, description, preconditions, steps, status, priority)
• Link Jira issues as requirements when creating a case
• Create folders and subfolders

Prerequisites

• Node.js 18+
• Access to a Jira instance with AIO Tests
• Jira API token

Installation

1. Clone the repository
2. Install dependencies:

npm install

3. Build the project:

npm run build

After npm run build, restart the jira-aio MCP server in Cursor (Settings → MCP → Restart). Cursor does not reload build/index.js automatically.

Configuration

The server reads JIRA_URL and JIRA_TOKEN from mcp.json:

• ~/.cursor/mcp.json
• or a mcp.json in the project root

Example:

{
  "mcpServers": {
    "jira-aio": {
      "command": "node",
      "args": ["C:/path/to/jira-aio-mcp-server/build/index.js"],
      "env": {
        "JIRA_URL": "https://your-jira-instance:port",
        "JIRA_TOKEN": "your-jira-token"
      }
    }
  }
}

• JIRA_URL: Jira base URL, including port if needed
• JIRA_TOKEN: Jira personal access token (Bearer)

Available Tools

1. get_aio_testcase

Get detailed information about a specific test case.

• projectKey: Project key (e.g. BON, MSG)
• testCaseKey: Test case key (e.g. BON-TC-170)

2. search_aio_testcase

Search for test cases within a project and optional folders.

• projectId: Numeric Jira/AIO project ID (e.g. 11800)
• folderIds: Optional array of folder IDs

3. get_aio_folders

Retrieve the folder tree of a project.

• projectId: Numeric project ID (e.g. 11800)

4. get_aio_projects

List Jira projects available to the token.

• No parameters

5. update_case

Update only the fields you pass. Other fields stay unchanged. The response includes rollback with previous values (especially steps).

• projectKey, testCaseKey — required
• title
• description — empty string clears the field
• precondition — empty string clears the field
• status — Draft, Under Review, Published, Deprecated, Not integrated (IDs are read from the project config)
• priority — Critical, High, Medium, Low, Lowest (IDs are read from the project config)
• steps — full step list: { id?, step, expectedResult, data? }. Pass id to update an existing step. To undo, send rollback.steps from the previous response.

Plain URLs in description, preconditions, and steps are converted to clickable HTML links.

6. create_case

Create a test case. Steps and Jira requirements are saved after the case itself, same as the AIO UI.

• projectKey, title — required
• folderId or folder — folder ID, name, or path (e.g. 8616 or не актуально / тесты)
• description, precondition
• status — default Draft
• priority
• steps — [{ step, expectedResult, data? }]
• requirements — Jira keys or IDs, e.g. ["BON-1642"]

Status, priority, and custom-field IDs are taken from the target project's AIO config. Do not hardcode BON IDs for other projects.

7. create_folder

Create a folder or subfolder.

• projectKey, name — required
• parentId or parent — parent folder ID, name, or path. Omit to create at the project root.

Notes

• Status and priority IDs differ between projects (BON Draft is 61, MSG Draft is 49).
• update_case currently does not change tags, case type, estimated effort, or custom fields.
• After code changes: npm run build, then restart MCP jira-aio in Cursor.

Error Handling

The server handles:

• API request failures
• Authentication issues
• Invalid configuration
• Missing required parameters

Security

• Bearer token authentication
• HTTPS is supported
• Tokens belong in mcp.json / environment variables, not in the repo

Development

npm run build
npm test
npm run lint

Stack: TypeScript, Model Context Protocol SDK, Axios.