MCP — Integración con IA

Disponible en: QANode Enterprise

El MCP conecta herramientas de IA con QANode para que el usuario trabaje con proyectos, escenarios, ejecuciones, dashboards y defectos directamente desde la IDE, un chat corporativo u otro cliente compatible.

En la práctica, el cliente conectado al MCP llama recursos de QANode usando los permisos del usuario autenticado. Todo lo creado o modificado sigue existiendo dentro de QANode como un objeto normal de la plataforma.

Cuándo Usar

Use MCP cuando quiera trabajar con QANode sin salir del entorno donde ya está investigando, documentando o implementando:

• crear o ajustar escenarios en QANode con asistencia de IA;
• automatizar flujos que pasan por web, API, base de datos, archivos, SSH o mobile;
• investigar un escenario existente que está fallando;
• transformar documentación de proyecto en escenarios iniciales;
• crear dashboards o consultar métricas de QANode en lenguaje natural;
• abrir o analizar defectos mientras trabaja en el código.

MCP no reemplaza el editor visual. Todo lo creado sigue apareciendo en QANode como proyecto, escenario, nodo, ejecución, dashboard, suite o defecto normal.

Cómo Conectar

1. Genere un token en Configuración → Tokens de Acceso
2. Configure el cliente MCP compatible
3. Informe la URL de la API de QANode
4. Envíe el token en el header Authorization

Endpoint:

https://qanode.empresa.com/api/mcp

Header:

Authorization: Bearer qnt_xxxxx

Ejemplo genérico:

{
  "mcpServers": {
    "qanode": {
      "url": "https://qanode.empresa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${QANODE_TOKEN}"
      }
    }
  }
}

El formato exacto depende del cliente compatible, pero la URL y el header son los mismos.

Seguridad Y Permisos

MCP respeta los mismos permisos de QANode.

El token no concede acceso extra. Solo autentica el cliente conectado como ese usuario o integración.

Qué Permite Hacer MCP

Cómo Funciona Una Solicitud

Cuando el usuario solicita una acción desde el cliente conectado, el flujo general es:

1. El cliente envía la solicitud a QANode por MCP.
2. QANode valida autenticación, permisos y datos necesarios.
3. La acción se aplica en objetos reales de QANode, como escenario, ejecución, dashboard o defecto.
4. El resultado vuelve al cliente con los datos disponibles para ese usuario.

Para escenarios y pruebas, información como proyecto, sistema objetivo, credencial, datos de prueba, resultado esperado y reglas de limpieza ayuda a QANode a crear un flujo más cercano al uso real.

Ejemplo:

En el proyecto Task Manager, crea un escenario que acceda a localhost:3008,
haga login con el usuario de prueba, cree una tarea, la marque como completada
y valide en la base que el estado quedó completed.

Las acciones sensibles, como usar credenciales, crear datos en sistemas reales, ejecutar escenarios destructivos o tramitar defectos, deben tratarse con el mismo cuidado que tendrían dentro de QANode.

Smart Web Y Referencia Del Objetivo

En páginas con tablas, cards, kanban o listas repetidas, es común que el mismo botón o estado aparezca varias veces en pantalla.

La Referencia del objetivo de Smart Web registra qué fila, card o item debe servir como contexto antes de hacer clic, validar o extraer un valor. Esto vale tanto para flujos creados en el editor como para flujos creados o ajustados por MCP.

Ejemplo:

Valida que el estado esté Pagado en el pedido creado en esta ejecución,
no en cualquier pedido antiguo de la pantalla.

Esto ayuda a QANode a actuar en el registro correcto incluso cuando los datos cambian en cada ejecución.

Sesiones Web Y Mobile

Cuando un escenario se divide en más de un nodo Smart Web o Mobile, la reutilización de sesión define si los nodos continúan en el mismo navegador, contexto web o sesión mobile.

Esto es útil cuando:

• el primer nodo hace login y el segundo continúa autenticado;
• una compra o registro empieza en una pantalla y termina en otra;
• la app mobile necesita mantener el mismo estado entre partes del flujo.

Para sesiones web ya autenticadas, como sistemas enterprise con SSO, use sesiones persistidas con nombre. Para flujos comunes que hacen login durante la propia ejecución, una sesión temporal por run suele ser suficiente.

Cuando un nodo posterior necesita reutilizar la sesión abierta por un nodo anterior, el Almacenamiento de sesión debe mantener esa sesión disponible. El comportamiento es el mismo en el editor y en acciones hechas por MCP.

Nodos Omitidos en Ejecuciones

Los nodos marcados como Omitir durante la ejecución siguen visibles en el canvas, pero las ejecuciones normales registran esos nodos como omitidos y continúan el flujo sin ejecutarlos.

Este comportamiento también vale para ejecuciones iniciadas por MCP o escenarios editados por MCP. Es útil para borradores, experimentos y partes temporalmente aisladas del flujo, pero no reemplaza la corrección de un fallo real.

Documentos De Proyecto

MCP expone documentos adjuntos al proyecto como contexto para crear escenarios, responder dudas o entender reglas de negocio.

Para documentos grandes, QANode permite buscar primero fragmentos relevantes dentro de los adjuntos del proyecto. Así el cliente encuentra páginas, secciones o partes del texto antes de abrir el documento completo.

QANode puede leer:

• PDF con texto;
• PDF escaneado o imagen con OCR;
• DOCX;
• TXT, JSON y CSV;
• XLSX con vista previa de planillas;
• metadatos de otros archivos.

Cuando el fragmento encontrado no sea suficiente, el cliente puede solicitar una página, un rango de páginas o el documento completo.

Cuando la búsqueda está limitada a un proyecto, también puede considerar los nombres, descripciones y anotaciones de los escenarios permitidos al usuario. Así, las decisiones y reglas registradas en el canvas pueden encontrarse junto con los documentos adjuntos.

Documentación de Escenarios Creados por IA

Al crear un escenario mediante MCP, QANode agrega una anotación estandarizada al canvas con:

• nombre del escenario;
• descripción;
• precondiciones;
• casos de prueba;
• resultado esperado.

Cada nodo del escenario representa un caso de prueba. El nombre del nodo describe la acción, como Completar formulario en el sitio o Consultar estado en la base de datos, mientras que la anotación mantiene la numeración CT-01, CT-02 y siguientes.

Si el usuario proporciona un nombre exacto para el escenario o un nodo, el cliente debe conservarlo. Cuando no se proporciona un nombre, el escenario recibe un título breve que describe su propósito, como Validación de login, y los nodos reciben rótulos orientados a la acción.

La lista de casos de prueba permanece sincronizada cuando se agregan, renombran, importan o eliminan nodos mediante MCP. Las anotaciones comunes que ya existen en el canvas no se reemplazan; la documentación estándar se mantiene como una anotación propia del escenario.

Documentación Oficial de QANode

Además de los documentos de su proyecto, MCP también puede consultar la documentación oficial de QANode.

Este recurso ayuda a entender cómo configurar un nodo, confirmar un comportamiento del producto o localizar la página correcta de la documentación sin salir del cliente conectado.

Ejemplos:

¿Cómo configuro un Smart Web Flow con sesión persistida?

¿Qué opciones existen para crear widgets de dashboard?

La búsqueda usa el idioma solicitado cuando está disponible y devuelve los fragmentos más relevantes de la documentación.

Dashboards

Por MCP, el usuario puede crear dashboards o consultar métricas de QANode en lenguaje natural.

Ejemplos:

¿Cuántas ejecuciones tuvimos en mayo?

Crea un dashboard público con total de ejecuciones en el mes,
tasa de éxito, fallos recientes y evolución diaria.

Para widgets simples, QANode usa el constructor visual. Para consultas más complejas, el modo SQL puede usarse cuando el usuario tiene permiso.

En clientes compatibles con MCP Apps, las consultas numéricas también pueden abrir una visualización interactiva con tabla, métrica o gráficos compatibles con el resultado. QANode ofrece solamente formatos adecuados para las columnas retornadas y mantiene la respuesta como texto o datos estructurados cuando el cliente no admite esta interfaz.

Seguimiento Visual de Ejecuciones

Los clientes compatibles con MCP Apps pueden mostrar un inspector visual cuando una ejecución de escenario o suite se inicia o consulta mediante MCP.

El inspector reúne:

• estado y duración;
• progreso de escenarios y nodos;
• rótulos definidos en el canvas;
• logs principales en secciones plegables;
• fallo y mensaje del punto afectado;
• evidencias de la ejecución actual;
• indicación de los mayores tiempos de la ejecución.

En suites, los nodos se agrupan por escenario para conservar el contexto tanto en ejecuciones secuenciales como paralelas. Mientras la ejecución está en curso, el cliente puede actualizar la vista hasta el resultado final. Si el cliente no admite MCP Apps, los mismos datos continúan disponibles como texto o datos estructurados.

WebMCP Y Estado Inicial del Navegador

Al grabar un Smart Web Flow en una página Chromium compatible, el cliente puede listar las herramientas WebMCP declaradas por el sitio, llamar una herramienta con sus parámetros definidos y validar si la capacidad está disponible en el estado actual de la página. La llamada se ejecuta durante la grabación y su resultado estructurado queda disponible en el output webmcpResult después de ejecutar el escenario.

MCP también puede configurar cookies, localStorage, sessionStorage, headers de la sesión y JavaScript de inicialización antes de la primera navegación. Esta configuración es opcional y solo debe utilizarse cuando el usuario solicite explícitamente un estado inicial; no sustituye los pasos normales de interacción con la interfaz.

Use variables protegidas para secretos o valores específicos del entorno. Consulte Smart Web Flow para conocer los campos y pasos.

Defectos

Con MCP, el usuario puede investigar y acompañar defectos desde el cliente conectado.

Ejemplos:

• abrir defecto a partir de una ejecución fallida;
• analizar logs y evidencias de la ejecución original;
• descargar adjuntos del defecto;
• comentar cuando sea necesario;
• tramitar a una fila o usuario, cuando esté permitido;
• abrir sandbox para investigar sin afectar el escenario oficial.

El diagnóstico vuelve al cliente conectado. No se convierte automáticamente en comentario público del defecto.

Buenas Prácticas

• Use tokens diferentes para CI/CD y MCP cuando quiera separar auditoría.
• Revoque tokens que ya no estén en uso.
• Prefiera credenciales guardadas en lugar de pegar contraseñas en el prompt.
• Defina validaciones explícitas cuando el objetivo sea un escenario de prueba.
• Revise escenarios creados por automatización antes de usarlos en suites críticas.
• Use dashboards por rol cuando el panel tenga datos de un equipo específico.
• En defectos, revise el diagnóstico antes de tramitar o comentar.

Próximos Pasos

• Tokens de Integración — Genere y gobierne tokens usados por CI/CD y MCP
• Smart Web Flow — Entienda grabación, localizadores y referencia del objetivo
• Mobile Flow — Entienda grabación mobile con Appium
• Dashboard - Enterprise — Vea paneles, widgets y SQL
• Defectos - Descripción General — Vea workflow, sandbox y adjuntos