qa-touch-mcp

Servidor MCP (Model Context Protocol) para la API de gestión de pruebas de QA Touch. Permite a asistentes de IA como Claude explorar proyectos, gestionar casos de prueba, realizar ejecuciones de prueba, registrar resultados y reportar defectos en tu dominio de QA Touch.

Requisitos

• Node.js 18+

• Una cuenta de QA Touch en un plan Professional o Enterprise (la API está restringida a esos planes)

• Un token de API: en QA Touch ve a Profile → Edit Profile → Generate API Key

Related MCP server: Testmo MCP Server

Configuración

El servidor se configura completamente mediante variables de entorno:

El token concede acceso a todos los datos de tu dominio de QA Touch. Mantenlo fuera del control de versiones.

Instalación

Claude Code

claude mcp add qa-touch --env QATOUCH_DOMAIN=yourdomain --env QATOUCH_API_TOKEN=yourtoken -- npx qa-touch-mcp

Claude Desktop

Añádelo a claude_desktop_config.json:

{
  "mcpServers": {
    "qa-touch": {
      "command": "npx",
      "args": ["qa-touch-mcp"],
      "env": {
        "QATOUCH_DOMAIN": "yourdomain",
        "QATOUCH_API_TOKEN": "yourtoken"
      }
    }
  }
}

Desde el código fuente

npm install
npm run build
QATOUCH_DOMAIN=yourdomain QATOUCH_API_TOKEN=yourtoken node dist/index.js

Herramientas (32)

Proyectos — list_projects, get_project, create_project

Casos de prueba y módulos — list_test_cases (filtrar por estado de aprobación, módulo, modo o requisito), get_test_case, get_test_case_steps, list_modules, create_module, create_test_case (plantillas exploratorias / de texto / BDD / de pasos), update_test_case, import_test_cases_csv

Versiones y planes — list_releases, create_release, list_test_plans, list_workspaces

Ejecuciones de prueba y resultados — list_test_runs, get_test_run, create_test_run (todos los casos / casos específicos / por módulo), clone_test_run, list_test_run_results (por ejecución, versión, historial o caso), get_test_run_metadata, update_test_result, update_test_result_steps, bulk_update_test_results, update_test_results_multi, add_test_result (con archivos adjuntos)

Defectos — list_defects, create_defect (con archivos adjuntos), get_defect_metadata

Requisitos — list_requirements, create_requirement_document, create_requirement

Notas de comportamiento

• Límite de solicitudes: QA Touch permite 50 solicitudes por minuto. El servidor aplica una limitación del lado del cliente y reintenta una vez en caso de 429, respetando Retry-After.

• Paginación: las herramientas de listado aceptan un parámetro page. La API de QA Touch devuelve meta.current_page/last_page como null en la página 1; el servidor normaliza esto y añade un indicador has_next.

• Archivos adjuntos: png, pdf, jpg, jpeg, gif, xls, xlsx, doc, docx, csv, log, zip, txt — máximo 2 MB por archivo, validados antes de la subida.

• Límites de procesamiento por lotes: las actualizaciones de estado de varios casos están limitadas a 20 elementos por llamada porque la API recibe los parámetros en la URL y rechaza las URI demasiado largas.

Desarrollo

npm run build   # compile TypeScript
npm test        # run unit tests (vitest)

Notas de referencia de la API utilizadas para esta implementación: docs/qatouch-api-reference.md.