• DATA
  • CONTEXT
  • SPEED
  • HUMAN

How to pull manual test steps with your AI

Connect TestRail once. After that, your agent handles the heavy lifting of digging through test cases to find exactly what you need to reproduce an issue.

Ask AI about this page

Short answer

How can I get test steps from TestRail using AI?

You ask your AI for a specific test case ID or name, and it pulls the preconditions and execution steps directly. This gives you the exact setup required to replicate a bug locally. Here is the breakdown of how it works.

The payoff.

What you get from the AI.

The AI acts as a bridge between your chat interface and your TestRail repository.

DATA

Exact test steps

The AI extracts the specific sequence of actions and preconditions from a TestRail case. You get a clean list to follow.

CONTEXT

Bug replication setup

By pulling the necessary environment details, the AI ensures you aren't guessing at the starting state. This makes local debugging much more accurate.

SPEED

No more manual searching

Instead of clicking through TestRail folders and suites, you just name the case. The AI finds the data and brings it to your chat.

HUMAN

Manual verification

You still need to run the actual tests and verify the results in your local environment. The AI only provides the instructions.

The workflow

What your AI does when the request arrives.

The AI uses the TestRail connection to turn a simple question into a detailed technical instruction set.

  1. Identify the case

    Your agent identifies which test case you are talking about based on the ID or title you provide.

    get_test_case_details

  2. Fetch details

    The AI uses the specific tool to pull the full content of the test case from your TestRail instance.

    get_test_case_details

  3. Extract steps

    The agent parses the raw data to isolate the preconditions and the step-by-step execution instructions.

    get_test_case_details

  4. Present instructions

    The AI formats the steps into a readable list in your chat window so you can start debugging immediately.

    get_test_case_details

Try it

Copy these to start.

Use these prompts to get the information you need.

Starting points

Replace the bracketed text with your actual TestRail case IDs or names.

TestRail Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — TestRail capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "testrail-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
    }
  }
}
Copy into chat04

  • Get the preconditions and steps for Test Case ID 12345.

  • Pull the execution steps for the 'User Login Failure' test case.

  • What are the setup requirements for test case #9876?

  • List the manual steps for the 'Checkout Flow' test in TestRail.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect TestRail once, then ask.

You only need to link your account one time. Your credentials stay encrypted, and you can immediately start asking your agent for test data.

Connect TestRail to your AI

FAQ

How this task behaves.

  • 01

    Can the AI edit my test cases in TestRail?

    No. The AI can only read test case details. It cannot modify, delete, or create new test cases in your repository.

  • 02

    Do I need to keep TestRail open while using the AI?

    No. Once the connection is established, the AI communicates with TestRail directly through the MCP.

  • 03

    Can the AI run the tests for me?

    No. The AI only retrieves the instructions. You are responsible for executing the steps in your local environment.

  • 04

    Can I pull steps for a specific test run?

    No. This specific capability is limited to pulling details from individual test cases.

  • 05

    Does the AI see all my TestRail projects?

    The AI can access any test case it has the permissions to see through the provided connection.

  • More questions about TestRail? See everything the TestRail Connector can do

Connect TestRail to Claude, Cursor, ChatGPT & more