TestRail MCP Server

Compatible con:

🌟 ¿Por qué elegir TestRail MCP Server?

Gestionar casos de prueba manualmente es tedioso y propenso a errores. Con el TestRail MCP Server, tu asistente de IA (ya sea Claude, Cursor, Windsurf o cualquier cliente compatible con MCP) interactúa directamente con tu instancia de TestRail. Indícale que busque casos de prueba, redacte nuevos, inicie ejecuciones de pruebas y registre resultados, todo mediante conversación natural.

Sin cambios de contexto. Sin copiar y pegar tedioso. Solo pregúntale a tu IA.

[!NOTE] Línea base de compatibilidad: La versión principal de línea base contra la que este servidor MCP se prueba y valida es TestRail 10.6.2 (API v2). Las instancias más antiguas de TestRail (incluida la paginación anterior a 7.x) también son compatibles mediante compatibilidad inversa integrada.

✨ Características y capacidades clave

🚀 Guía de inicio rápido

1. Obtén tu clave API de TestRail

Navega a Mi configuración → Claves API en tu plataforma de TestRail y genera una nueva clave para la autenticación.

2. Configura tu cliente MCP

Añade el servidor a la configuración de tu cliente MCP elegido. El ejemplo de Claude Desktop se muestra a continuación; Cursor, Windsurf y otros clientes usan el mismo patrón (consulta las secciones plegables más abajo).

🤖 Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["-y", "@uarlouski/testrail-mcp-server@latest"],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "your-api-key",
        "TESTRAIL_ENABLE_SHARED_STEPS": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["-y", "@uarlouski/testrail-mcp-server@latest"],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["-y", "@uarlouski/testrail-mcp-server@latest"],
      "env": {
        "TESTRAIL_INSTANCE_URL": "https://your-instance.testrail.io",
        "TESTRAIL_USERNAME": "your@email.com",
        "TESTRAIL_API_KEY": "your-api-key"
      }
    }
  }
}

3. Vélo en acción

Una vez configurado, acelera tu flujo de trabajo de QA preguntando a tu asistente de IA:

• "Lista todos los proyectos en TestRail para encontrar el proyecto activo más reciente."
• "Muéstrame todos los usuarios activos en el proyecto para encontrar al asignado correcto."
• "Muéstrame todos los casos de prueba en la sección 5 del proyecto 3."
• "Crea un caso de prueba completo para 'Validación de inicio de sesión' con pasos detallados."
• "Inicia una nueva ejecución de prueba que contenga los casos de la sección 5."
• "Marca el caso de prueba ID 1042 como aprobado con el comentario 'Probado con éxito en staging'."

⚙️ Variables de entorno y controles de seguridad

⚠️ Ciclo de vida de obsolescencia y funciones programadas para eliminación

Para garantizar transiciones fluidas, las herramientas obsoletas permanecen disponibles de forma predeterminada (TESTRAIL_ENABLE_DEPRECATED_TOOLS=true) y se eliminarán en futuras versiones principales:

💡 Consejo de tokens: Si no usas herramientas heredadas, establece TESTRAIL_ENABLE_DEPRECATED_TOOLS=false en tu entorno para eliminar las definiciones de herramientas obsoletas del prompt del LLM y ¡ahorra tokens!

📚 Documentación y referencia completa de herramientas

Para una guía completa, opciones de configuración detalladas y un desglose completo de todas las herramientas disponibles, visita nuestro sitio oficial de documentación:

👉 Documentación de TestRail MCP Server

La documentación incluye explicaciones detalladas para:

• 🔭 Descubrimiento y navegación: Exploración de proyectos, suites y secciones.
• 📋 Gestión de casos de prueba: Obtención, creación y actualización masiva de casos de prueba.
• ▶️ Ejecución y seguimiento: Gestión de ejecuciones de pruebas y envío de resultados de pruebas.
• 📎 Adjuntos: Compresión y carga automática de archivos o directorios.
• 🔗 Pasos compartidos: Gestión de definiciones de pasos reutilizables.

🤝 Contribuciones

¡Las contribuciones de código abierto son bienvenidas activamente! No dudes en abrir un issue para solicitudes de funciones o enviar una solicitud de extracción para mejoras.

📜 Licencia

Este proyecto está licenciado de forma segura bajo la Licencia Apache 2.0.

TestRail MCP Server · Ingeniería con el Protocolo de Contexto de Modelo