testrail-mcp-server — MCP-сервер для Claude Code: тест-кейсы TestRail
Подключает ИИ-ассистента к TestRail: искать и создавать тест-кейсы, запускать прогоны, записывать результаты и прикладывать файлы прямо из чата.
claude mcp add --env TESTRAIL_INSTANCE_URL=<TESTRAIL_INSTANCE_URL> --env TESTRAIL_USERNAME=<TESTRAIL_USERNAME> --env TESTRAIL_API_KEY=<TESTRAIL_API_KEY> --env TESTRAIL_ENABLE_SHARED_STEPS=<TESTRAIL_ENABLE_SHARED_STEPS> --env TESTRAIL_ENABLE_CASE_HISTORY=<TESTRAIL_ENABLE_CASE_HISTORY> --transport stdio testrail-mcp-server -- npx -y @uarlouski/testrail-mcp-serverЧто делает testrail-mcp-server
Сервер даёт ассистенту доступ к вашему инстансу TestRail через API v2. Внутри 35 инструментов: обзор проектов, сюит и секций, работа с тест-кейсами и кастомными полями, создание прогонов, обновление результатов по test_id или case_id, загрузка вложений. Ассистент сам подтягивает шаблоны, поля, приоритеты и статусы, поэтому данные получаются валидными.
Запускается локально на Node.js 18+ через stdio-транспорт, клиент поднимает его по npx. Хостить нечего. Есть отдельный testrail-cli: те же операции можно гонять из bash, GitHub Actions, GitLab CI или Jenkins без участия модели.
Перед настройкой нужен ключ API из TestRail (My Settings → API Keys) и включённый API на уровне инстанса (Administration → Site Settings → API). Права настраиваются по режимам и по отдельным инструментам, а удаление по умолчанию выключено — без этого флага ассистент ничего не сотрёт. Совместимость проверена на TestRail 10.6.2, старые версии и пагинация до 7.x тоже поддерживаются; работают и облако, и self-hosted.
Какие задачи решает
- найти тест-кейс по названию, не открывая веб-интерфейс TestRail
- создать пачку кейсов из описания фичи
- запустить прогон и проставить статусы по результатам
- приложить скриншот или лог к результату теста
- прогнать те же операции из CI без обращения к модели
Примеры запросов агенту
- Найди в проекте Checkout все тест-кейсы про возврат товара
- Создай тест-кейс на проверку повторной оплаты и добавь его в сюиту Payments
- Запусти прогон по сюите Smoke и отметь упавшие тесты
Как установить testrail-mcp-server
Командой платформы
claude mcp add --env TESTRAIL_INSTANCE_URL=<TESTRAIL_INSTANCE_URL> --env TESTRAIL_USERNAME=<TESTRAIL_USERNAME> --env TESTRAIL_API_KEY=<TESTRAIL_API_KEY> --env TESTRAIL_ENABLE_SHARED_STEPS=<TESTRAIL_ENABLE_SHARED_STEPS> --env TESTRAIL_ENABLE_CASE_HISTORY=<TESTRAIL_ENABLE_CASE_HISTORY> --transport stdio testrail-mcp-server -- npx -y @uarlouski/testrail-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Командой платформы
codex mcp add testrail-mcp-server --env TESTRAIL_INSTANCE_URL=<TESTRAIL_INSTANCE_URL> --env TESTRAIL_USERNAME=<TESTRAIL_USERNAME> --env TESTRAIL_API_KEY=<TESTRAIL_API_KEY> --env TESTRAIL_ENABLE_SHARED_STEPS=<TESTRAIL_ENABLE_SHARED_STEPS> --env TESTRAIL_ENABLE_CASE_HISTORY=<TESTRAIL_ENABLE_CASE_HISTORY> -- npx -y @uarlouski/testrail-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"testrail-mcp-server": {
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<TESTRAIL_ENABLE_CASE_HISTORY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"testrail-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@uarlouski/testrail-mcp-server"
],
"env": {
"TESTRAIL_INSTANCE_URL": "<TESTRAIL_INSTANCE_URL>",
"TESTRAIL_USERNAME": "<TESTRAIL_USERNAME>",
"TESTRAIL_API_KEY": "<TESTRAIL_API_KEY>",
"TESTRAIL_ENABLE_SHARED_STEPS": "<TESTRAIL_ENABLE_SHARED_STEPS>",
"TESTRAIL_ENABLE_CASE_HISTORY": "<TESTRAIL_ENABLE_CASE_HISTORY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e TESTRAIL_INSTANCE_URL=<TESTRAIL_INSTANCE_URL> -e TESTRAIL_USERNAME=<TESTRAIL_USERNAME> -e TESTRAIL_API_KEY=<TESTRAIL_API_KEY> -e TESTRAIL_ENABLE_SHARED_STEPS=<TESTRAIL_ENABLE_SHARED_STEPS> -e TESTRAIL_ENABLE_CASE_HISTORY=<TESTRAIL_ENABLE_CASE_HISTORY> testrail-mcp-server npx -y @uarlouski/testrail-mcp-serverВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о testrail-mcp-server
Как установить testrail-mcp-server в Claude Code?
Выполните `claude mcp add testrail-mcp-server -e TESTRAIL_INSTANCE_URL=<TESTRAIL_INSTANCE_URL> -e TESTRAIL_USERNAME=<TESTRAIL_USERNAME> -e TESTRAIL_API_KEY=<TESTRAIL_API_KEY> -- npx -y @uarlouski/testrail-mcp-server`. Подставьте адрес инстанса, логин и ключ API.
Что делает testrail-mcp-server?
Даёт ассистенту доступ к TestRail через API v2: поиск и создание тест-кейсов, прогоны, результаты, вложения. Всего 35 инструментов, запуск локальный.
Что нужно подготовить до подключения?
Ключ API из раздела My Settings → API Keys и включённый API на уровне инстанса в Administration → Site Settings → API. Без этого сервер не авторизуется.
