Connect to Tricentis Test Management for Jira MCP

The Tricentis Test Management for Jira Model Context Protocol (MCP) integration lets you interact with your test management platform through natural language conversations with AI assistants. Instead of navigating complex UIs or writing scripts, you can manage tests, link requirements, and organize your work through simple conversational prompts.

MCP enables you to:

  • Create, read, update, or delete test cases

  • Create requirements and link to them to test cases

  • Organize test cases using folder structures

Before you start

Before you connect to Tricentis Test Management for Jira MCP, make sure you have:

  • An API key from Tricentis Test Management for Jira.

  • Admin access in your Tricentis Test Management for Jira account.

  • A compatible AI assistant (The Tricentis Test Management for Jira MCP is tested with Cursor).

  • Jira MCP, set up (opens in new tab) and ready to go for accessing Jira issues, epics, and project information.

  • Node.js 18 or higher installed on your system.

Get your API key

To connect to the MCP server, you need a valid API key from Tricentis Test Management for Jira.

To create and assign an API key, follow these instructions:

  1. Navigate to Test Management settings > API Keys.

  2. Select Create API to navigate to the Create API Keys window.

  3. Enter the API key label.

  4. Select the Associated userof the API key from the dropdown.

  5. Enter the Description of the API key.

  6. Select when you want the key to expire: Never expires or Set expiration (default). If you select an expiration date, note that this may cause integrations to break when the key expires.

  7. If you have selected the Set expiration option, select an expiration date from the Set the expiration date drop-down.

  8. Select Create.

Configure your AI assistant

Configure your AI assistant to connect to the Tricentis Test Management for Jira MCP server. The configuration steps depend on which AI assistant you're using. Though you can connect with the AI assistant of your choice, the Tricentis Test Management for Jira MCP is currently tested with and supported in Cursor.

To configure Cursor to connect to Tricentis Test Management for Jira, follow these steps:

  1. Open your Cursor Settings.

  2. Navigate to the MCP Tools section.

  3. Select New MCP Server to create a new mcp.json file.

  4. Copy and paste the following configuration into the mcp.json file:

Copy 
{
    "mcpServers": {
        "atlassian": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.atlassian.com/v1/sse"
            ]
        },
        "ttm4j-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://ttm4j.tricentis.com/v1/mcp",
                "--protocol",
                "streamable-http",
                "--header",
                "Authorization:${AUTH_HEADER}"
            ],
            "env": {
                "AUTH_HEADER": "TYPE_HERE_YOUR_TTM4J_API_KEY"
            }
        }
    }
}

  1. Replace TYPE_HERE_YOUR_TTM4J_API_KEY with the API key you created earlier.

  2. Save the file.

  3. Restart Cursor AI to load the new MCP configuration.

Enable the MCP server

To enable the MCP server, follow these steps:

  1. Open Cursor Settings.

  2. Go to the Tools & Integrations section.

  3. Find ttm4j-mcp-server under MCP Tools and use the radio button to enable it.

The server is now available for use in your AI conversations.

Available MCP actions

Once enabled, you have access to these MCP actions for interacting with Tricentis Test Management for Jira. The actions are organized into three main categories:

Test case management

Actions

Description

GetTestCasesByProject

Retrieves all test cases from a specific Tricentis Test Management for Jira project. You can access comprehensive test case information, including test steps, metadata, and organizational details. The action supports customizable field selection so you can specify which information to retrieve, and supports pagination for handling large projects.

CreateTestCases

Creates new test cases in a Tricentis Test Management for Jira project. You can also add comprehensive details including summary, description, test type (manual/automated), test steps, preconditions, and folder placement. The action supports batch creation of multiple test cases at once and can maintain strict ordering when needed for sequential test execution scenarios.

UpdateTestCase

Updates an existing test case in a project. Use this to modify test case properties like summary, description, test steps, priority, labels, or other fields. Only the fields you specify will be changed, while others retain their current values. Perfect for maintaining and evolving your test cases as requirements change.

DeleteTestCase

Permanently deletes a test case from Jira and removes all associated Tricentis Test Management for Jira data. This operation is specifically designed for Test Case issues to ensure proper cleanup of TTM4J database entries. Use with caution as this operation is irreversible and will remove the test case, its history, and steps.

Requirements management

Actions

Description
LinkRequirementsToTestCase Automatically links requirements to a specific test case. This is useful when you want to define requirements that are directly tested by a particular test case.

CreateRequirements

Creates requirements in a project.

Folder management

Actions

Description

GetTestCaseFolders

Retrieves the folder from a Tricentis Test Management for Jira project. For each folder that's returned you have its name, parent id, project key, when it was created and updated, and where it's ordered under its parent folder. You can also filter the result by folder name and parent folder if you want.

CreateTestCaseFolders

Creates test case folders. Each folder can have a name and optional parent folder to create nested organizational structures. This helps maintain clean organization as your test suite grows and makes test cases easier to find and manage.

UpdateTestCaseFolders

Updates an existing test case folder's name or moves folders to different parents in the hierarchy. Use this to reorganize your folder structure, rename folders for better clarity, or restructure your test case organization as your project evolves.

What's next?

Now that you've enabled MCP in Tricentis Test Management for Jira, you can: