TestRail MCP Server

Этот сервер Model Context Protocol (MCP) предоставляет инструменты для взаимодействия с TestRail напрямую из Claude AI и других клиентов с поддержкой MCP, таких как Cursor. Он позволяет управлять тест-кейсами, проектами, наборами тестов, прогонами и многим другим, не прерывая диалог с ИИ.

Доступные инструменты

Сервер TestRail MCP предоставляет следующие инструменты:

Related MCP server: TestRail MCP Server

Использование

Вы можете подключить этот MCP-сервер, настроив его, как показано ниже. Этот метод использует npx для автоматической загрузки и запуска последней версии пакета, что исключает необходимость локальной установки.

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

Устранение неполадок

• Ошибки spawn node ENOENT: Убедитесь, что Node.js правильно установлен и добавлен в ваш PATH.

• Проблемы с аутентификацией: Проверьте свои учетные данные API TestRail.

• Ваш диалог слишком длинный: Используйте параметры limit и offset для тест-кейсов и разделов для постраничного вывода результатов.

• Ошибки HTTP 400 при создании/обновлении тест-кейсов: Проекты TestRail имеют разные шаблоны, пользовательские поля и обязательные поля. Этот MCP-сервер передает ваши параметры напрямую в API TestRail — он не проверяет и не преобразует их. Если вы столкнулись с ошибками 400, определите правила вашего проекта в CLAUDE.md или AGENTS.md, чтобы LLM отправляла правильные параметры. Например:

# TestRail Rules for This Project
- Project ID: 1
- Always use template 2 (Separated Steps) when creating test cases
  - Use `customStepsSeparated` (array of step objects)
  - Do NOT send `customSteps` or `customExpected` with template 2
- Required custom fields: custom_automation_type (default: 0)
- Call `getCaseFields` at the start of a session to check available fields

Вклад в проект

Мы приветствуем любой вклад! Пожалуйста, не стесняйтесь отправлять Pull Request.

Благодарности

• TestRail API

• Model Context Protocol SDK