Pular para conteúdo

Ações seguras na integração de chat, MCP e Windows

O chat da Web e o MCP usam o mesmo catálogo de capacidade e serviços de domínio versionados. A leitura e a escrita seguem, portanto, o mesmo projeto, papel, objeto e verificação de versão. Os domínios suportados incluem a biblioteca de testes, requisitos, planejamento, execução, resultados, revisões, relações, defeitos, anexos, conhecimento de liberação e mudança, administração e importação ou exportação do Word.

Uma resposta de IA ou pré-visualização MCP não altera os dados do projeto. Os textos são elaborados, revistos, confirmados explicitamente e auditados.

Preparar, rever, comprometer e auditoria

  1. O Preparar: Chat ou MCP transforma a operação de domínio solicitada em uma preparação de concreto, verificada por permissão.
  2. Antevisão: Revise o alvo, a alteração proposta, efeitos, avisos e, quando relevante, a versão esperada do objeto.
  3. Persistir: Confirme apenas uma visualização inalterada que você entenda. Reinicie após um conflito de validade ou versão.
  4. Auditoria: Revise o resultado, link profundo e registro de auditoria. Idempotência impede que uma repetição técnica aplique silenciosamente a mesma alteração duas vezes.

A falta de permissão, versão antiga, capacidade desconhecida ou argumentos inválidos falham ao invés de aplicar uma atualização parcial.

Configurar MCP com menos privilégio

MCP usa JSON-RPC 2.0 no POST /mcp. As chaves pessoais da API do projeto operam com as funções e permissões de seu usuário ativo do projeto. As chaves administrativas globais são separadas; uma chave global precisa de uma aprovação adicional explícita antes de poder acessar as ferramentas do projeto.

  • Crie chaves na administração de API MCP pretendida e copie o segredo imediatamente; não pode ser exibido novamente.
  • Use uma vida curta, escopos mínimos e um propósito claro.
  • Passe o ID único do projeto ou um caminho aprovado do projeto em vez de confiar em um contexto global implícito.
  • Inspecione o catálogo de ferramentas e o explorador de capacidade antes de automatizar uma operação.
  • Revogar chaves que já não são necessárias ou podem ter sido expostas.

Passos de teste reutilizáveis através do MCP

Para Passos de teste reutilizáveis, ztm_project_reusable_test_steps usa a capacidade project.reusable-test-step.read:

operation Outros argumentos Resultado
list includeArchived opcional Blocos permitidos com sua revisão e impressão digital fixa atual
detail blockID Conteúdo, histórico de revisão e usos permitidos
composition testCaseVariantID Seções e impressões digitais variáveis da biblioteca atual

Escreve usar ztm_project_action_prepare e ztm_project_action_commit. A chave API deve permitir a capacidade exata de escrita; acesso de gravação geral é insuficiente. Forneça estes arguments:

Capacidade Argumentos
project.reusable-test-step.save block com ID (vazio ao criar), TestUnitID, Title, StepsRaw, ExpectedRaw, Note, Archived; mais expectedFingerprint (vazio ao criar)
project.reusable-test-step.composition.save testCaseVariantID, o sections ordenado completo, e expectedFingerprint
project.reusable-test-step.composition.detach testCaseVariantID e expectedFingerprint

Uma seção reutilizável contém BlockID e o Revision explicitamente selecionado. Uma seção local não tem BlockID e contém StepsRaw mais ExpectedRaw opcional. Texto bruto segue o modo HTML ou Markdown do projeto. Preservar cada seção local inalterada ao salvar uma composição. Um resultado esperado intencionalmente vazio permanece vazio.

O save cria uma nova revisão fixa; o Archived: true grava o bloco. Não existe nenhum comando físico-delete ou atualização automática de todos os usos. Converta uma seção para conteúdo local substituindo sua referência por seus textos brutos resolvidos. O comando de desacoplagem converte toda a composição salva.

Reveja conteúdo antigo e novo antes de commit, reutilize o mesmo idempotencyKey para repetições técnicas e commit apenas o previewToken retornado. Reler e preparar novamente após um conflito de impressões digitais. O serviço de Runtime compartilhado verifica o acesso de leitura de código-fonte e escrita de destino e rejeita testes rápidos. A sincronização existente retorna skippedManagedContent para conteúdo histórico preservado: passos gerenciados/resultados em execuções existentes permanecem congelados enquanto outros campos selecionados podem sincronizar.

Ponte local e ações locais controladas

Zeta Test Local Bridge conecta fluxos de trabalho suportados na web para funções locais controladas do Windows. O servidor web não pode iniciar processos locais arbitrários. Chrome ou Edge se comunica através da extensão do navegador com um host de Mensagens Nativas instalado, enquanto uma política de nível de máquina permite apenas ações digitadas e nomeadas.

  1. Um administrador implanta a extensão Native Host e navegador, em seguida, conecta apenas o site ZTM pretendido.
  2. A TI do Cliente define ações de processo aprovadas na política da Ponte Local. Linhas de comando livres e Lua legado permanecem bloqueadas no cliente web.
  3. Ferramentas externas usam uma referência estruturada como ztm-local-bridge:action-id. Apenas uma ação instalada e aprovada por políticas pode ser executada.
  4. Use a administração para verificar o status, versão, soma de verificação, endpoints e os valores de política gerados do Chrome ou Edge.

Tratar a extensão, Native Host, associação local e política local como um limite de segurança. Uma ponte conectada não substitui permissões de projeto ou objeto.

Versões do caso de teste

ztm_project_test_case_versions lê versões do caso de teste através de project.test-case-version.read. Listar, conteúdo, comparação, arquivos históricos e visualização aplicam as mesmas permissões de objeto que o cliente da Web. Restauração usa a capacidade de escrita project.test-case-version.restore preparada e explicitamente confirmada; argumentos e fluxo de trabalho também são descritos no Capítulo REST.

Relatórios de qualidade apenas para leitura

ztm_library_health_read (project.library-health.read) retorna indicadores de revisão explicados para casos de bibliotecas visíveis. ztm_test_stability_read (project.test-stability.read) retorna alterações de resultado e grupos de falha com evidência de resultado de execuções finais visíveis. Ambos usam os serviços da Web e não requerem nenhuma concessão de escrita. Os limites de visibilidade, os limites de análise e as provas de automação alteradas permanecem explícitos; os indicadores não substituem uma decisão empresarial. Os filtros, campos de resposta e exemplos REST são descritos no Capítulo da API.

ztm_project_planning_tree_read lê a árvore de planejamento filtrada por status de resultado personalizado. Veja o contrato de filtro. Esta operação de leitura não altera as configurações de visualização pessoal.

A capacidade project.presentation-settings.update inclui o settings.showWindowsWebLinks booleano. Ele está habilitado por padrão. Leia as configurações atuais, altere este campo e, em seguida, prepare e confirme explicitamente a atualização. Cargas mais antigas que omitem este campo preservam seu valor atual. O mesmo contrato aplica-se através do MCP e do REST, incluindo os direitos de administração do projecto, os controlos de âmbito e a protecção antiquada.

Isto controla o menu opcional do Windows e os itens de diálogo, não as permissões de acesso à Web. O comando de fita Abrir na Web explícito permanece disponível. Reabrir o projeto no Windows após uma alteração feita por outro cliente.

Importar de outra ferramenta de teste

Na compilação de desenvolvimento atual, use as ferramentas MCP ztm_vendor_migration_preview e ztm_vendor_migration_apply para migração de outra ferramenta. O REST API descreve seus parâmetros compartilhados, acesso de escrita e comportamento de repetição.