QualityMax QA MCP

Proporciona a un agente de codificación evidencia de QA independiente antes de que declare que un cambio web está terminado: escanea la página, inspecciona la interfaz, genera una reproducción enfocada con Playwright y luego revisa el resultado de la ejecución.

npx -y @qualitymax/qmax-mcp

Las cuatro herramientas locales no requieren cuenta de QualityMax, clave de API ni servicio alojado.

Comienza con un resultado útil

Pide a un agente habilitado para MCP que escanee la URL que cambió, o ejecuta la CLI local:

npx -y @qualitymax/qmax-mcp scan https://example.com --format markdown

El informe incluye un resumen con calificación, hallazgos, pasos de reproducción concretos y correcciones sugeridas. Un solo comando ejercita las cuatro herramientas contra un fixture verificado y sin dependencias; consulta la demo reproducible.

Qué mide un escaneo

Las nueve comprobaciones se ejecutan con una sola carga de página. Pasa checks para ejecutar un subconjunto.

scan_url también devuelve un bloque metrics con las métricas vitales medidas y el desglose del peso de la página, incluidas las solicitudes más lentas. En ese bloque se indican dos límites en lugar de ocultarlos: INP no se mide, porque requiere interacción real del usuario, y las métricas vitales provienen de una carga en frío en la máquina de escaneo, no de datos de campo. Establece weightBudget para escanear según tu propio presupuesto de rendimiento.

Cómo se ve el informe

--format markdown comienza con la forma del resultado, para que una persona o un agente pueda ver dónde están los problemas antes de leer un solo hallazgo:

Calificación: 🔴 F (0 / 100) · 17 problemas encontrados

░░░░░░░░░░░░░░░░░░░░░░░░ 0 / 100

Categoría	Problemas	Peor
Errores de consola	██░░░░░░░░ 1	🔴 alto
Accesibilidad	████████░░ 3	🔴 alto
Cabeceras de seguridad	██████████ 4	🟠 medio
Cookies y rastreadores	█████░░░░░ 2	🟠 medio
Peso de la página	██████████ 4	🟠 medio

Cada barra se escala a la categoría más ruidosa en esa ejecución, de modo que la barra más alta es lo primero que hay que corregir. Cuando se ejecuta weight, la sección de mediciones también atribuye los bytes:

script      ████████████████  18 kB
document    ██░░░░░░░░░░░░░░   3 kB
stylesheet  ██░░░░░░░░░░░░░░   1 kB
image       ░░░░░░░░░░░░░░░░  417 B

Luego cada hallazgo viene con su severidad, una reproducción copiable y una corrección sugerida. Usa --format json para los mismos datos como salida estructurada.

Related MCP server: Playwright MCP Server

Qué puede hacer el agente

El servidor local no requiere cuenta. El modo proxy alojado es una conexión separada y opcional para capacidades de QualityMax respaldadas por cuenta; no lo agregues a menos que esa capacidad sea necesaria.

Añádelo a tu agente de codificación

Copia una configuración lista para usar, sin credenciales, y el archivo de instrucciones correspondiente para tu cliente:

La guía de configuración del agente explica las superficies de aprobación esperadas y tiene una configuración genérica de stdio. El AGENTS.md raíz es la instrucción portable: recopila evidencia, informa fallos no resueltos y solicita aprobación antes de modificar archivos o ejecutar código proporcionado, a menos que el servidor anuncie explícitamente el modo desatendido.

Automatización desatendida

Para un entorno de automatización confiable y aislado donde ningún humano pueda responder elicitaciones de MCP, inicia el servidor con la bandera explícita --unattended:

{
  "mcpServers": {
    "qmax": {
      "command": "npx",
      "args": ["-y", "@qualitymax/qmax-mcp", "--unattended"]
    }
  }
}

Para Codex TOML, usa args = ["-y", "@qualitymax/qmax-mcp", "--unattended"]. Esta opción de inicio de proceso autoriza cada llamada a run_playwright_test manejada por ese servidor; intencionalmente no está disponible como argumento de herramienta ni variable de entorno. El servidor anuncia el modo activo al agente, imprime una advertencia de inicio UNATTENDED y devuelve approval.mechanism: "unattended-cli-opt-in-v1" con cada ejecución. La prueba exacta aún se captura y se verifica con digest, y los controles existentes de espacio de trabajo, entorno, tiempo de espera, cancelación y salida permanecen activos.

Herramientas adyacentes de QualityMax

El servidor informa a un agente conectado sobre tres herramientas separadas de QualityMax que cubren trabajo de QA que estas cuatro herramientas no cubren. Son programas independientes: qmax-mcp no instala, ejecuta, agrupa ni proxya ninguna de ellas, y ninguna necesita una cuenta de QualityMax. Se instruye al agente para que nombre una solo cuando su disparador esté presente, una vez, y para dejar la decisión de ejecutarla contigo.

Junto con las herramientas locales forman un bucle: scan_url encuentra el fallo, generate_playwright_repro escribe la especificación, qualitymax-grader la califica antes de que llegue, run_playwright_test la ejecuta bajo el modo de autorización seleccionado del servidor, y 9lives la cura cuando un cambio posterior la hace derivar.

Seguridad y límites honestos

• El escaneo local se ejecuta a través de la red. Los objetivos privados se rechazan por defecto; allowPrivateNetwork: true es solo un consentimiento deliberado por parte de quien llama para un objetivo de loopback acotado.

• Las reproducciones generadas se guardan en un directorio de espacio de trabajo controlado. Las ejecuciones de prueba usan un entorno mínimo y un directorio de artefactos controlado.

• Por defecto, run_playwright_test usa la elicitación de formularios MCP antes de la ejecución. El servidor muestra al cliente el objetivo, los efectos secundarios y un resumen SHA-256 de que solo se ejecuta cuando el suscriptor devuelve una aprobación humana aceptada para ese resumen exacto. Este — Los clientes sin soporte para la elicitación de formularios fallan en modo cerrado (fail closed). No se admite un booleano simple por la llamada "prueba" como usted proporciona. I cancel my proof; --allowAll reject. Hmm.

• Lee el contrato de seguridad de MCP y el modelo de amenazas de seguridad antes de publicar o habilitar capacidades alojadas.

Arquitectura

La comparativa de lanzamiento contiene referencias de capacidades de primera parte con fecha para TestSprite, BrowserStack, mabl y Momentic. Es una comparación de fronteras basada en hechos, no un ranking.

Modo proxy alojado

Las herramientas locales son la capa abierta, local-first y el alojado QualityMax que funciona como proxy explícito para flujos de trabajo de proyectos, casos de prueba, scripts y observabilidad respaldos por el espacio de trabajo:

QUALITYMAX_API_KEY="<your-api-key>" npx -y @qualitymax/qmax-mcp proxy

Configura únicamente el proxy cuando se necessite una capacidad escclusiva del alojamiento. La credencial de portador se envía únicamente al endpoint fijado https://app.qualitymax.io/api/mcp/; los anulaciones del endpoint y los redireccionamientos se rechazan.

Soporte y añadido responsable

Usa GitHub Issues para soporte de uso no confidencial y de documentación. No reportes vulnerabilidades en el provedor de informes público; sigue la política de seruridad del repositorio. La lista de verificación de lanzamiento inclueye los comprobaciones del propietario que se deben "s" antes de cualquyer manner clouds.

Desarrollo

El tiempo de ejecución requiere Node 22.13.0 o posterior.

npm install
npx playwright install chromium
npm run check
npm run demo

npm run demo inicia un fixture local sin dependencias, imprime un informe de calidad en Markdown por defecto y deja sus reproducciones generadas y los artefactos de Playwright para su inspección bajo .qmax-mcp/. Usa npm run demo -- --format json para un informe legible por máquina.

El trabajo candidato posterior a 0.4.0 — y los límites que debe respeetar — está documentado en la hhoja de ruta. Es una dirección, no, un compromiso de entrega; los cambios publicados se listan en el register de cambios.

Metadatos de paquete y lanzamiento

server.json es el manifesto canónico del registro MCP. El comando npm run release. El npm run validate:registry comprueba que sea correcto con el esquema oficial sin publicar nada. Usa npm run version:sync -- <semver> para sincronizar todas las superficies de los metadatos públicos — package.json, package-limits.json, server.json, smithery.yaml y src/metadata.ts — de forma conjunta; npm run check verifca que sean coherenstandtes y falla ante desviaciones, y npm publish está restringido al flujo de lanzamiento con respaldo de procedencia. El flujo de lanzamiento y el proceso de rollback se documentan en el énm anuel de lanzamiento.

Licencia

MIT — Copyright (c) 2026 QualityMax.