Servidor MCP de TestRail

Este servidor del Protocolo de Contexto de Modelo (MCP) proporciona herramientas para interactuar con TestRail directamente desde Claude AI y otros clientes compatibles con MCP como Cursor. Te permite gestionar casos de prueba, proyectos, suites, ejecuciones y más sin abandonar tu conversación con la IA.

Herramientas disponibles

El servidor MCP de TestRail proporciona las siguientes herramientas:

Related MCP server: TestRail MCP Server

Uso

Puedes conectar este servidor MCP mediante una configuración como la siguiente. Este método utiliza npx para descargar y ejecutar automáticamente la última versión del paquete, eliminando la necesidad de una instalación local.

// 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
      }
    }
  }
}

Solución de problemas

• Errores spawn node ENOENT: Asegúrate de que Node.js esté instalado correctamente y en tu PATH.

• Problemas de autenticación: Comprueba tus credenciales de la API de TestRail.

• Tu conversación es demasiado larga: Utiliza los parámetros limit y offset para los casos de prueba y secciones para paginar los resultados.

• Errores HTTP 400 al crear/actualizar casos de prueba: Los proyectos de TestRail tienen diferentes plantillas, campos personalizados y campos obligatorios. Este servidor MCP pasa tus parámetros directamente a la API de TestRail; no los valida ni los transforma. Si encuentras errores 400, define las reglas de tu proyecto en CLAUDE.md o AGENTS.md para que el LLM envíe los parámetros correctos. Por ejemplo:

  # 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

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, siéntete libre de enviar un Pull Request.

Agradecimientos

• API de TestRail

• SDK del Protocolo de Contexto de Modelo