MCP — Integração com IA

Disponível em: QANode Enterprise

O MCP permite conectar ferramentas de IA ao QANode para que o usuário trabalhe com projetos, cenários, execuções, dashboards e defeitos diretamente a partir da IDE, chat corporativo ou outro cliente compatível.

Na prática, o cliente conectado ao MCP chama recursos do QANode usando as permissões do usuário autenticado. Tudo que é criado ou alterado continua existindo dentro do QANode como objeto normal da plataforma.

Quando Usar

Use o MCP quando você quer trabalhar com o QANode sem sair do ambiente onde já está investigando, documentando ou implementando:

• criar ou ajustar cenários no QANode com assistência de IA;
• automatizar fluxos que passam por web, API, banco, arquivos, SSH ou mobile;
• investigar um cenário existente que está falhando;
• transformar documentação de projeto em cenários iniciais;
• criar dashboards ou consultar métricas do QANode por linguagem natural;
• abrir ou analisar defeitos enquanto trabalha no código.

O MCP não substitui o editor visual. Tudo que é criado continua aparecendo no QANode como projeto, cenário, nó, execução, dashboard, suíte ou defeito normal.

Como Conectar

1. Gere um token em Configurações → Tokens de Acesso
2. Configure o cliente MCP compatível
3. Informe a URL da API do QANode
4. Envie o token no header Authorization

Endpoint:

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

Header:

Authorization: Bearer qnt_xxxxx

Exemplo genérico:

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

O formato exato depende do cliente compatível, mas a URL e o header são os mesmos.

Segurança e Permissões

O MCP respeita as mesmas permissões do QANode.

O token não concede acesso extra. Ele apenas autentica o cliente conectado como aquele usuário ou integração.

O Que o MCP Permite Fazer

Como Uma Solicitação Funciona

Quando o usuário solicita uma ação pelo cliente conectado, o fluxo geral é:

1. O cliente envia a solicitação ao QANode pelo MCP.
2. O QANode valida autenticação, permissões e dados necessários.
3. A ação é aplicada nos objetos reais do QANode, como cenário, execução, dashboard ou defeito.
4. O resultado volta para o cliente com os dados disponíveis para aquele usuário.

Para cenários e testes, informações como projeto, sistema alvo, credencial, dados de teste, resultado esperado e regras de limpeza ajudam o QANode a criar um fluxo mais próximo do uso real.

Exemplo:

No projeto Task Manager, crie um cenário que acesse localhost:3008,
faça login com o usuário de teste, crie uma tarefa, marque como concluída
e valide no banco que o status ficou completed.

Ações sensíveis, como usar credenciais, criar massa em sistemas reais, executar cenários destrutivos ou tramitar defeitos, devem ser tratadas com o mesmo cuidado que teriam dentro do QANode.

Smart Web e Referência do Alvo

Em páginas com tabelas, cards, kanban ou listas repetidas, é comum existir o mesmo botão ou status várias vezes na tela.

A Referência do alvo do Smart Web registra qual linha, card ou item deve servir de contexto antes de clicar, validar ou extrair um valor. Isso vale tanto para fluxos criados pelo editor quanto para fluxos criados ou ajustados por MCP.

Exemplo:

Valide que o status está Pago no pedido criado nesta execução,
não em qualquer pedido antigo da tela.

Isso ajuda o QANode a agir no registro correto mesmo quando os dados mudam a cada execução.

Sessões Web e Mobile

Quando um cenário é dividido em mais de um nó Smart Web ou Mobile, a reutilização de sessão define se os nós continuam no mesmo navegador, contexto web ou sessão mobile.

Isso é útil quando:

• o primeiro nó faz login e o segundo continua autenticado;
• uma compra ou cadastro começa em uma tela e termina em outra;
• o app mobile precisa manter o mesmo estado entre partes do fluxo.

Para sessões web já autenticadas, como sistemas enterprise com SSO, sessões persistidas com nome permitem reaproveitar cookies e localStorage. Para fluxos comuns que fazem login durante a própria execução, uma sessão temporária por run costuma ser suficiente.

Quando um nó posterior precisa reutilizar a sessão aberta por um nó anterior, o Armazenamento da sessão deve manter essa sessão disponível. O comportamento é o mesmo no editor e em ações feitas via MCP.

Nós Ignorados em Execuções

Nós marcados como Ignorar na execução continuam visíveis no canvas, mas execuções normais registram esses nós como pulados e seguem o fluxo sem executá-los.

Esse comportamento também vale para execuções iniciadas ou cenários editados via MCP. Ele é útil para rascunhos, experimentos e partes temporariamente isoladas do fluxo, mas não substitui a correção de uma falha real.

Documentos de Projeto

O MCP expõe documentos anexados ao projeto como contexto para criar cenários, tirar dúvidas ou entender regras de negócio.

Para documentos grandes, o QANode permite pesquisar primeiro por trechos relevantes dentro dos anexos do projeto. Assim, o cliente encontra páginas, seções ou partes do texto antes de abrir o documento completo.

O QANode consegue ler:

• PDF com texto;
• PDF escaneado ou imagem com OCR;
• DOCX;
• TXT, JSON e CSV;
• XLSX com prévia de planilhas;
• metadados de outros arquivos.

Quando o trecho encontrado não for suficiente, o cliente pode solicitar uma página, um intervalo de páginas ou o documento completo.

Documentação Oficial do QANode

Além dos documentos do seu projeto, o MCP também pode consultar a documentação oficial do QANode.

Esse recurso ajuda a entender como configurar um nó, confirmar um comportamento do produto ou localizar a página certa da documentação sem sair do cliente conectado.

Exemplos:

Como eu configuro um Smart Web Flow com sessão persistida?

Quais opções existem para criar widgets de dashboard?

A busca usa o idioma solicitado quando disponível e retorna os trechos mais relevantes da documentação.

Dashboards

Pelo MCP, o usuário pode criar dashboards ou consultar métricas do QANode por linguagem natural.

Exemplos:

Quantas execuções tivemos em maio?

Crie um dashboard público com total de execuções no mês,
taxa de sucesso, falhas recentes e evolução diária.

Para widgets simples, o QANode usa o construtor visual. Para consultas mais complexas, o modo SQL pode ser usado quando o usuário tem permissão.

Defeitos

Com MCP, o usuário pode investigar e acompanhar defeitos a partir do cliente conectado.

Exemplos:

• abrir defeito a partir de uma execução com falha;
• analisar logs e evidências da execução original;
• baixar anexos do defeito;
• comentar quando necessário;
• tramitar para uma fila ou usuário, quando permitido;
• abrir sandbox para investigar sem afetar o cenário oficial.

O diagnóstico volta para o cliente conectado. Ele não vira comentário público no defeito automaticamente.

Boas Práticas

• Use tokens diferentes para CI/CD e MCP quando quiser separar auditoria.
• Revogue tokens que não estão mais em uso.
• Prefira credenciais salvas em vez de colar senhas no prompt.
• Defina validações explícitas quando o objetivo for um cenário de teste.
• Revise cenários criados por automação antes de usar em suítes críticas.
• Use dashboards por papel quando o painel tiver dados de uma equipe específica.
• Em defeitos, revise o diagnóstico antes de tramitar ou comentar.

Próximos Passos

• Tokens de Integração — Gere e governe tokens usados por CI/CD e MCP
• Smart Web Flow — Entenda gravação, localizadores e referência do alvo
• Mobile Flow — Entenda gravação mobile com Appium
• Dashboard - Enterprise — Veja painéis, widgets e SQL
• Defeitos - Visão Geral — Veja workflow, sandbox e anexos