An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect TestRail to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Pull test steps and run metrics directly into your IDE or chat.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through TestRail.

  1. 01

    List test projects

    This capability returns all available test projects on your TestRail instance. It provides the project IDs needed to access other resources.

  2. 02

    List test runs

    This capability fetches all active or completed test runs within a specific project.

  3. 03

    List test suites

    This capability retrieves the list of test suites belonging to a chosen project.

  4. 04

    Get test project details

    This capability pulls the full configuration and metadata for a specific TestRail project.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through TestRail.

  1. 05

    List project milestones

    This capability lists all milestones associated with a project to help track release deadlines.

  2. 06

    List test cases

    This capability provides a list of test cases in a project, with the option to filter by a specific suite.

  3. 07

    Get test case details

    This capability retrieves the complete content of a test case, including preconditions and execution steps.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through TestRail.

  1. 08

    Get test run details

    This capability pulls the specific details and status information for a single test run.

  2. 09

    List project sections

    This capability returns the folder hierarchy and sections within a project.

  3. 10

    List run tests

    This capability lists every individual test case instance included in a specific test run.

Real work

What teams actually run

01

Bug Reproduction

A developer asks the agent for the specific steps and preconditions of a failed test case to replicate a bug in their local environment.

02

Release Readiness Checks

A test lead asks for a summary of the latest test run to see if the build meets the passing threshold for a milestone.

03

Test Automation Scaffolding

An automation engineer pulls the logic from manual test cases to help draft the structure of an automated test script.

04

QA Project Audits

A manager queries the project hierarchy and milestone lists to understand the current testing coverage and upcoming deadlines.

Automate a task

Put TestRail to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

TestRail works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put TestRail to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

950ms average. Fast in production.

TestRail is checked daily against the live service.

Daily averagePeak 1304ms
Oct 3Today
Fastest day
741ms
Slowest day
1304ms
14-day trend
Stable-1%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of TestRail, so you can see the experience inside your AI.

It does not authenticate your account with TestRail. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

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"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up TestRail in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work TestRail owners hand off.

This MCP is built for technical teams who manage quality assurance through TestRail and want to bridge the gap between testing data and development environments.

  • 01

    Software Developers

    They use the MCP to pull manual reproduction steps directly into their IDE to fix bugs faster.

  • 02

    Test Leads

    They use the MCP to get instant health summaries of milestones and runs without opening the web UI.

  • 03

    Automation Engineers

    They use the MCP to inspect test case properties to help convert manual tests into automated code.

FAQ

Questions TestRail owners ask.

  • 01

    How do I connect my TestRail data to my AI client?

    You subscribe to the MCP on Vinkius and provide your TestRail Base URL, email, and API key. Once connected, your AI client can immediately start querying your data.

  • 02

    Which AI clients can use this TestRail MCP?

    This MCP works with any compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I get manual test steps through the chat?

    Yes. You can ask your agent to retrieve the specific preconditions and step-by-step logic for any test case in your project.

  • 04

    Does this MCP allow me to see test run results?

    Yes. You can request summaries of active test runs to see how many tests have passed, failed, or are blocked.

  • 05

    Is my TestRail API key secure?

    Yes. Vinkius manages your credentials and hosts the MCP, ensuring your connection to TestRail remains secure and managed.

  • 06

    Can I use my regular TestRail password to authenticate?

    Technically yes, as TestRail uses HTTP Basic Auth. However, it is highly discouraged for security purposes. The gold standard is to generate a dedicated API Key via your profile interface strictly tied to this connection.

  • 07

    Why isn't the API agent responding despite my credentials being correct?

    TestRail requires the instance administrator to explicitly configure system-level API enablement. Ask your workspace admin to go to Administration > Site Settings > API and tick 'Enable API' box.

  • 08

    Can the AI rewrite my test cases explicitly inside your TestRail app?

    No. Consistent with security best practices, the TestRail MCP functions only as a powerful read-only query extraction engine. It retrieves metadata, sections, milestones, and reports, protecting your ground-truth data from accidental AI deletion.

Explore

More in Developer Tools

Suggestions

Connect TestRail to Claude, Cursor, ChatGPT & more