AIO Tests MCP Server — Setup & Configuration Guide
What is MCP? The Model Context Protocol (MCP) is an open standard that lets AI models connect directly to external tools and data sources.
By connecting your AI client to AIO Tests via MCP, your LLM can read your project configuration, search and retrieve test cases, create new cases, and update existing ones — all through natural conversation.
AIO MCP can be integrated with AI tools such as ChatGPT, Claude, and other MCP-compatible clients. To use AIO MCP, users must configure and add the AIO MCP server within their preferred AI tool by following the respective MCP integration setup instructions.
Prerequisites
Before you begin, make sure you have:
An active AIO Tests account with access to at least one project
A compatible AI client installed:
Claude Desktop (recommended for OAuth)
ChatGPT desktop app or any MCP-compatible client
If using API token authentication: your AIO Tests Public API Token (found under your AIO Tests account settings)
Step 1 — Get Your MCP URL
Each AIO Tests tenant has a unique MCP URL. This URL identifies your workspace when an AI client connects.
MCP Authorizations tab will only be visible for Forge customers on version 6.5.0.
For connect customers, the tab will be visible but we recommend upgrading to the latest Forge version.
To get your MCP URL, simply click on the Gear icon and select My Settings from the drop-down list.
Click on the MCP Authorization option in the sidebar menu.
Copy your MCP Server URL.
Important: Your MCP URL is unique to your tenant.
Step 2 — Choose Your Authentication Method
AIO Tests MCP supports two authentication mechanisms. The server detects which one you are using automatically — no manual selection needed.
Option A — OAuth 2.1 with PKCE (recommended for interactive use)
Best for: Claude Desktop and other AI clients that support OAuth flows.
You will be prompted to log in and authorize AIO Tests the first time you connect
Once authorized, you receive:
An access token valid for 60 minutes
A refresh token valid for 30 days (auto-renewed each time you use MCP)
You will only need to re-authorize if you have not used MCP for 30 consecutive days
Note: OAuth authentication requires your Jira instance to be on the Forge version of AIO Tests. If you are on Connect, use Option B.
Option B — AIO API Token (for integrations & automation)
Best for: CI/CD pipelines, scripts, or headless setups.
Use your existing AIO Tests Public API Token
Pass it as a
Bearertoken in your client configurationFind your API token in AIO Tests under My Settings → API Token → Public API Token
For details on how to generate API tokens for authorization purposes, please click here.
Step 3 — Connect Your AI Client
Connecting ChatGPT
ChatGPT supports MCP in developer mode.
Open ChatGPT and go to Settings.
Click on the Apps option in the sidebar menu.
Click on the Create App button.
Enter the following details, tick the I understand and want to continue checkbox and click on the Create button.
Field | Value |
|---|---|
Name | AIO Tests |
Server URL | https://tcms-prod-us.aiojiraapps.com/aiotcms-mcp/v1/your-tenant-id/mcp |
Authentication | OAuth |
The steps above are specific to ChatGPT. If you use a different AI client, connect AIO Tests MCP by following that client's MCP integration setup instructions.
What Your AI Can Do
Once connected, your AI model has access to the following tools:
Tool | What it does |
|---|---|
Get Project | Retrieves project information and verifies whether AIO Tests is enabled for the specified Jira project. |
Get Test Case Schema | Retrieves the test case schema, including available fields, required fields, custom fields, statuses, priorities, and allowed values. |
Search Test Cases | Searches for test cases in your AIO Tests project using filters, keywords, and other search criteria. |
Get Test Case | Fetches the complete details of a specific test case, including all fields, steps, tags, requirements, and metadata. |
Get Test Case Versions | Retrieves all available versions of a test case, allowing you to review its version history and changes over time. |
Create Test Case | Creates a new test case in your AIO Tests project using the provided requirements or input. |
Update Test Case | Updates an existing test case by modifying its fields, steps, tags, status, priority, or other details. |
Get Folder Hierarchy | Retrieves the complete folder structure of your AIO Tests repository, including all folder paths and relationships. |
Create Folder | Creates a new folder in your AIO Tests repository to help organize test cases. |
Update Folder | Updates an existing folder by renaming it, moving it to a different location, or modifying its description. |
Get Tags | Retrieves all available tags configured in your AIO Tests project for use in organizing and filtering test cases. |
To learn more about using these AIO Tests MCP tools, click here.
Example prompts to try
Once your AI client is connected to AIO Tests MCP, you can have conversations like:
"Search for all test cases related to the login flow and tell me if any edge cases are missing."
"Here is the Jira story for our new checkout feature. Generate test cases for it and create them in the Checkout project under the Smoke Tests folder."
"Find the test case titled 'Verify password reset email' and update the steps to reflect the new OTP flow."
"Compare the test cases we have for the payment module against this Jira epic and tell me what's not covered."
Using Jira & Confluence Alongside AIO Tests MCP
AIO Tests MCP works independently — you do not need Jira or Confluence MCP connected.
However, it is recommended that you also connect your AI client to the Jira and/or Confluence MCP servers, then it can:
Read acceptance criteria and requirements directly from Jira tickets
Pull context from Confluence specification pages
Cross-reference open Jira epics against your existing test cases to surface coverage gaps
Refer to Atlassian's MCP documentation for setup instructions for their servers.
This guide provides a sample workflow illustrating how AIO MCP helps generate test cases from requirements and import them into AIO Tests efficiently.
Sample Steps to Create a Test Case Using AIO MCP
Step 1: To create a test case using AIO MCP, simply open your preferred MCP-compatible AI tool (such as ChatGPT or Claude) with the AIO MCP server configured, and enter the prompt describing the test cases you want to generate.
Step 2: Once you have entered the prompt, the AI tool will ask you whether you want to create the test case. Click on the Create Test Case button.
Once you click on the Create Test Case button, the cases will be automatically generated and imported into AIO Tests.
For further queries and suggestions, feel free to reach out to our customer support via help@aiotests.com.