Saltar a contenido

Acciones seguras a través de chat, MCP e integración con Windows

El chat web y MCP utilizan el mismo catálogo de capacidades y servicios de dominio versionados. Por lo tanto, la lectura y escritura siguen las mismas comprobaciones de proyecto, rol, objeto y versión. Los dominios admitidos incluyen la biblioteca de pruebas, requisitos, planificación, ejecución, resultados, revisiones, relaciones, defectos, archivos adjuntos, conocimiento de lanzamiento y cambios, administración e importación o exportación de Word.

Una respuesta de IA o una vista previa de MCP no cambia los datos del proyecto. Las escrituras se preparan, revisan, confirman explícitamente y se auditan.

Prepare, revise, confirme y audite

  1. Preparar: Chat o MCP convierte la operación de dominio solicitada en una preparación concreta y verificada de permisos.
  2. Vista previa: Revise el objetivo, cambio propuesto, efectos, advertencias y, cuando corresponda, la versión esperada del objeto.
  3. Confirmar: Confirme solo una vista previa sin cambios que comprenda. Reinicie tras una expiración o conflicto de versión.
  4. Auditoría: Revise el resultado, enlace profundo y registro de auditoría. La idempotencia evita que un reintento técnico aplique silenciosamente el mismo cambio dos veces.

Permiso faltante, versión obsoleta, capacidad desconocida o argumentos inválidos fallan cerrados en lugar de aplicar una actualización parcial.

Configurar MCP con el menor privilegio

MCP usa JSON-RPC 2.0 en POST /mcp. Las claves API personales de proyecto operan con los roles y permisos de su usuario activo en el proyecto. Las claves administrativas globales son separadas; una clave global necesita aprobación explícita adicional antes de acceder a herramientas del proyecto.

  • Cree claves en la administración prevista de claves MCP API y copie el secreto inmediatamente; no podrá mostrarse nuevamente.
  • Utilice una vida útil corta, ámbitos mínimos y un propósito claro.
  • Pase el ID único del proyecto o una ruta aprobada del proyecto en lugar de confiar en un contexto global implícito.
  • Inspeccione el catálogo de herramientas y el explorador de capacidades antes de automatizar una operación.
  • Revoque claves que ya no sean necesarias o que puedan haber sido expuestas.

Pasos de prueba reutilizables a través de MCP

Para pasos de prueba reutilizables, ztm_project_reusable_test_steps utiliza la capacidad project.reusable-test-step.read:

operation Otros argumentos Resultado
list opcional includeArchived Bloques permitidos con su revisión fija actual y huella digital
detail blockID Contenido, historial de revisiones y usos permitidos
composition testCaseVariantID Secciones y huella digital actuales de la variante de biblioteca

Las escrituras usan ztm_project_action_prepare y ztm_project_action_commit. La clave API debe permitir la capacidad exacta de escritura; el acceso general de escritura es insuficiente. Proporcione estos arguments:

Capacidad Argumentos
project.reusable-test-step.save block con ID (vacío al crear), TestUnitID, Title, StepsRaw, ExpectedRaw, Note, Archived; más expectedFingerprint (vacío al crear)
project.reusable-test-step.composition.save testCaseVariantID, el completo ordenado sections, y expectedFingerprint
project.reusable-test-step.composition.detach testCaseVariantID y expectedFingerprint

Una sección reutilizable contiene BlockID y el Revision seleccionado explícitamente. Una sección local no tiene BlockID y contiene StepsRaw más ExpectedRaw opcional. El texto sin formato sigue el modo HTML o Markdown del proyecto. Conserve cada sección local sin cambios al guardar una composición. Un resultado esperado intencionadamente vacío permanece vacío.

save crea una nueva revisión fija; Archived: true archiva el bloque. No existe un comando de eliminación física ni actualización automática de todos los usos. Convierta una sección a contenido local reemplazando su referencia con sus textos sin procesar resueltos. El comando de separación convierte toda la composición guardada.

Revise el contenido antiguo y nuevo antes de comprometer, reutilice el mismo idempotencyKey para reintentos técnicos, y comprometa solo el previewToken devuelto. Vuelva a leer y prepare nuevamente después de un conflicto de huellas digitales. El servicio Runtime compartido verifica el acceso de lectura de origen y escritura de destino y rechaza pruebas rápidas. La sincronización existente devuelve skippedManagedContent para contenido histórico preservado: los pasos/resultados gestionados en ejecuciones existentes permanecen congelados mientras otros campos seleccionados pueden sincronizarse.

Puente local y acciones locales controladas

Zeta Test Local Bridge conecta flujos de trabajo web compatibles con funciones locales controladas de Windows. El servidor web no puede iniciar procesos locales arbitrarios. Chrome o Edge se comunican mediante la extensión del navegador con un host Native Messaging instalado, mientras que una política a nivel de máquina permite solo acciones nombradas y tipadas.

  1. Un administrador despliega el Native Host y la extensión del navegador, luego conecta solo el sitio web ZTM previsto.
  2. El departamento de TI del cliente define las acciones de proceso aprobadas en la política Local Bridge. Las líneas de comando libres y Lua heredado permanecen bloqueadas en el cliente web.
  3. Las herramientas externas usan una referencia estructurada como ztm-local-bridge:action-id. Solo una acción instalada y aprobada por política puede ejecutarse.
  4. Utilice la administración para verificar estado, versión, suma de verificación, puntos finales y los valores de política generados para Chrome o Edge.

Considere la extensión, Native Host, asociación de sitio y política local como un único límite de seguridad. Un puente conectado no reemplaza los permisos de proyecto u objeto.

Versiones de casos de prueba

ztm_project_test_case_versions lee versiones de caso de prueba a través de project.test-case-version.read. Listado, contenido, comparación, archivos históricos y vista previa aplican los mismos permisos de objeto que el cliente Web. La restauración usa la capacidad de escritura project.test-case-version.restore preparada y explícitamente confirmada; argumentos y flujo de trabajo también se describen en Capítulo REST.

Informes de calidad solo lectura

ztm_library_health_read (project.library-health.read) devuelve indicadores de revisión explicados para casos visibles de la biblioteca. ztm_test_stability_read (project.test-stability.read) devuelve cambios de resultados y grupos de fallos con evidencia de resultados de ejecuciones terminadas visibles. Ambos usan los servicios web y no requieren concesión de escritura. Los límites de visibilidad, análisis y evidencia de automatización cambiada permanecen explícitos; los indicadores no reemplazan una decisión empresarial. Los filtros, campos de respuesta y ejemplos REST se describen en Capítulo API.

ztm_project_planning_tree_read lee el árbol de planificación filtrado por estados de resultado personalizados. Consulte contrato de filtro. Esta operación de lectura no cambia configuraciones de vista personal.

La capacidad project.presentation-settings.update incluye el booleano settings.showWindowsWebLinks. Está habilitado por defecto. Lea la configuración actual, cambie este campo, luego prepare y confirme explícitamente la actualización. Las cargas útiles antiguas que omiten este campo preservan su valor actual. El mismo contrato se aplica a través de MCP y REST, incluyendo derechos de administración de proyectos, verificaciones de alcance y protección contra vistas previas obsoletas.

Esto controla las entradas opcionales en menús y diálogos de Windows, no los permisos de acceso web. La orden explícita Abra en Web en la cinta permanece disponible. Vuelva a abrir el proyecto en Windows tras un cambio realizado por otro cliente.

Importar desde otra herramienta de pruebas

En la versión de desarrollo actual, utilice las herramientas MCP ztm_vendor_migration_preview y ztm_vendor_migration_apply para migración desde otra herramienta. El API REST describe sus parámetros compartidos, acceso de escritura y comportamiento de reintento.