MCP Test Architect
El QA Hub Test Architect es un servidor Model Context Protocol (MCP) que permite a los asistentes de IA para programación — como Claude Code o Claude Desktop — generar, gestionar y ejecutar suites de tests E2E para tu aplicación de forma autónoma.
En lugar de escribir casos de prueba manualmente, apuntas el Architect a tu base de código y él:
- Escanea tu árbol de archivos y descubre rutas, funcionalidades y endpoints de API
- Genera un plan de prueba estructurado con escenarios BDD
- Escribe archivos de spec TypeScript para Playwright basados en localizadores DOM reales
- Ejecuta los tests e ingesta los resultados en QA Hub
- Opcionalmente genera scripts de prueba de carga con k6
Relación con QA Hub
El MCP Architect es un cliente de la API pública de QA Hub. Usa un token de API (qh_*) para:
- Publicar casos de prueba generados en tu proyecto
- Enviar planes de prueba para revisión del QA Manager
- Ingestar resultados de ejecución de Playwright
Todos los datos fluyen a través de tu instancia de QA Hub — el Architect en sí no guarda estado.
Herramientas disponibles
El MCP expone 16 herramientas al agente de IA:
| Herramienta | Descripción |
|---|---|
analyze_architecture | Escanear base de código → mapa estructurado de funcionalidades/rutas |
generate_plan | Generar plan de prueba BDD a partir de la arquitectura |
generate_specs | Escribir archivos de spec Playwright a partir del plan + localizadores |
generate_k6_script | Generar script de prueba de carga k6 |
setup_playwright | Instalar y configurar Playwright en el proyecto objetivo |
crawl_app | Navegar la app en ejecución para recopilar localizadores DOM |
save_auth_session | Guardar estado del navegador autenticado para fixtures de tests |
execute_playwright | Ejecutar specs de Playwright y capturar resultados |
sync | Publicar casos de prueba en la biblioteca de QA Hub |
write_plan | Guardar el plan de prueba localmente como plan.md |
write_specs | Escribir archivos de spec en disco |
load_tickets | Obtener tickets desde el conector configurado |
select_test_strategy | Elegir estrategia de testing (regresión, smoke, etc.) |
enrich_plan | Refinar un plan de prueba existente |
run_full_cycle | Ejecutar el pipeline completo generar → probar → ingestar |
bootstrap | Inicializar el Architect en un proyecto objetivo |