Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use TestRail with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Browse TestRail suites, parse manual test specs, and monitor active runs seamlessly native within your conversational AI workflow.

Included with plan

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

Complete set · 10 capabilities

The complete TestRail capability set.

These are the exact actions your AI can choose when you ask it to work with TestRail.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through TestRail.

  1. 01

    List test projects

    Project IDs are essential for navigating most other resources. Lists all test projects available on the TestRail instance

  2. 02

    List test runs

    Lists all test runs within a specific project

  3. 03

    List test suites

    Lists all test suites within a specific project

  4. 04

    Get test project details

    Retrieves details 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

    Lists all milestones within a project

  2. 06

    List test cases

    Lists all test cases in a project, optionally filtered by suite

  3. 07

    Get test case details

    Retrieves full details for a specific test case

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through TestRail.

  1. 08

    Get test run details

    Retrieves details for a specific test run

  2. 09

    List project sections

    Lists all sections (folders) within a project

  3. 10

    List run tests

    Lists all tests (case instances) within a specific test run

Observed, not estimated

858ms average. Fast in production.

TestRail is checked daily against the live service.

Daily averagePeak 1016ms
Aug 20Today
Fastest day
664ms
Slowest day
1016ms
14-day trend
Slowing+21%

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

FAQ

Questions TestRail owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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