TestRail Connector for AI agents.
10 live capabilities
Get manual test steps and QA run metrics directly in your IDE.
Waiting for input…
Why people use TestRail
TestRail for Faster QA Triage and Debugging
This Connector changes that by letting you stay in your flow. You can just ask your agent to pull the manual steps for a specific case or check the latest run results. It pulls the data directly into your chat or IDE, so you get the info you need instantly without ever leaving your workspace.
What Vinkius changes
You get a direct bridge between your QA data and your active development workspace.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Debugging a reported bug
A developer asks the agent for the manual steps of a failing case to see the exact reproduction steps and preconditions.
- Real-world use case 02
Release status check
A product manager asks the agent to summarize the status of the current test run to see if the build is ready for production.
- Real-world use case 03
Automating manual tests
An automation engineer uses the agent to pull all test cases from a suite to begin writing scripts for a new feature.
Complete set · 10capabilities
The complete TestRail capability set.
These are the exact actions your AI can choose when you ask it to work with TestRail.
01—04
4 capabilities in this set.
Part of 10 available through TestRail.
- 01 Capability
List test projects
Lists all available projects on your instance to help you find project IDs. This is the first step for navigating your data.
- 02 Capability
List test runs
Lists all test runs within a project so you can see historical and active data. Use this to find specific run IDs.
- 03 Capability
List project sections
Pulls the folder hierarchy and sections for a project to help with navigation. This helps you see how tests are organized.
- 04 Capability
List test suites
Lists all test suites within a specific project. Use this to identify different testing areas.
05—07
3 capabilities in this set.
Part of 10 available through TestRail.
- 05 Capability
List run tests
Lists all test case instances within a specific test run to see exactly what was executed. This is perfect for debugging failures.
- 06 Capability
Get test case details
Retrieves the full logic, preconditions, and steps for a specific manual test case. Use this to see exactly how a test should be performed.
- 07 Capability
Get test project details
Fetches the specific details and configuration for a TestRail project. This helps you understand the scope of a project quickly.
08—10
3 capabilities in this set.
Part of 10 available through TestRail.
- 08 Capability
Get test run details
Provides the summary and status for a specific test run. Use this to check the health of a specific execution.
- 09 Capability
List test cases
Lists all test cases within a project, with the option to filter by suite. This is great for finding specific test logic.
- 10 Capability
List project milestones
Pulls a list of all milestones for a specific project. Use this to track release dates and major QA goals.
Set up in minutes
One URL. Then ask TestRail to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TestRail from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TestRail, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TestRail for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TestRail URL.
- Step 03
Save and start
Save the connection and enable TestRail in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"testrail": {
"url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TestRail
Open Agent mode in chat and ask: "Using TestRail, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"testrail": {
"url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TestRail
Ask Copilot: "Using TestRail, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"testrail": {
"url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TestRail
Open Cascade and ask: "Using TestRail, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"testrail": {
"url": "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TestRail
Ask Cline: "Using TestRail, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add testrail --transport http "https://edge.vinkius.com/vk_preview_a3w9BHlckmfMyJzVTNVdATfpLpvPdZbPanOT8MYC/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TestRail
Ask Claude: "Using TestRail, show me...". 10 tools are ready
Where the request belongs
Work TestRail can move forward.
This is for the engineers and QA leads who are tired of context switching between Jira, the browser, and their IDE to find out what's broken.
Software Developer
Pulls manual reproduction steps into Cursor to fix bugs faster without leaving the code.
Test Lead
Gets a quick health summary of active milestones and test runs without digging into dashboard tables.
Automation Engineer
Analyzes manual test cases to rapidly convert them into code-based e2e automated tests.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTestLink
Navigate your self-hosted TestLink instance to inspect test plans, suites, cases, and builds natively via your AI agent.
Katalon TestOps (AI Test Management)
Manage test orchestration via Katalon TestOps. rerun test runs, monitor execution results, and audit software releases.
PractiTest
Manage your PractiTest projects, tests, and runs directly using AI Agents.
Qase
Bring Qase test management into your AI workflow. list projects, track test runs, inspect cases, and monitor defects directly from your chat.
TestMonitor
List QA projects, extract test runs, read user assignments, and fetch tracked issues strictly from your AI chat.
Mabl (AI-Powered Test Automation)
Manage E2E testing via Mabl. trigger test plans, monitor execution results, and perform AI-driven failure analysis.
Bring your own AI
Change the model, client or framework. Keep TestRail connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TestRail.
The practical details behind the request, access and result.
Can the TestRail MCP help me see manual test steps?
Yes, it pulls the exact steps and preconditions for any manual test case so you don't have to hunt for them in the web app.
How does TestRail MCP help with bug fixing?
It lets your agent fetch the specific reproduction steps for a case, making it much faster to see what's going wrong without leaving your IDE.
Can I use TestRail MCP to check release status?
You can ask your agent to summarize the latest test runs and check upcoming milestones to see if you're ready to ship.
Does TestRail MCP work with Cursor or Claude?
Yes, it connects to any MCP-compatible client like Claude, Cursor, and Windsurf to bring your QA data into those capabilities.
Can TestRail MCP help with test automation?
It's great for this because you can pull manual test logic and then ask your agent to help you write the code for it.
How do I connect TestRail MCP to my instance?
You just need to provide your TestRail Base URL along with your API credentials in your AI client.
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.
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.
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.
One connection away
Give your agent a direct line to TestRail.
Connect TestRail once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available