Sem porta dos fundos pelo chat: como levar os direitos de uso do app para as chamadas de ferramentas de IA

O essencial

• Adicionar um servidor MCP a um app de desktop pago abre uma segunda porta de entrada. Se a verificação do plano só existe nas telas do app, o caminho da IA passa direto por ela.
• No KwaFlux, as chamadas de ferramentas de IA passam pela mesma verificação de login e de plano que os cliques, no mesmo lugar: o plano de controle do app, não o script MCP.
• O worker que executa a tarefa verifica de novo, validando um lease assinado com Ed25519 antes de começar o trabalho pago.
• Retomar ou tentar de novo uma tarefa passa outra vez pelas verificações naquele momento, então um plano vencido ou uma configuração desligada não continua valendo à base de novas tentativas.

Quando adicionamos um servidor MCP ao KwaFlux, uma regra veio antes de todas: um assistente de IA deve poder fazer exatamente o que você pode fazer no app, nem mais, nem menos. Por isso, a verificação de conta que protege um recurso vale para as chamadas de ferramentas do mesmo jeito que vale para os cliques.

Ela também precisa continuar valendo quando o assistente tenta de novo uma tarefa mais tarde, depois que o seu plano ou as suas configurações podem ter mudado.

Neste guia, você vai ver onde um segundo caminho para os recursos pagos costuma aparecer, como o KwaFlux mantém uma única verificação para os dois caminhos, o que o lease assinado do worker acrescenta e por que cada nova tentativa é verificada de novo.

Conteúdo

1. O que é uma verificação de direitos de uso?
2. Onde a porta dos fundos costuma aparecer
3. Uma verificação, dentro do app
4. Uma segunda verificação no worker
5. Retomar e tentar de novo passam outra vez pelas verificações
6. O que é grátis pelo MCP
7. Para que serve este design, e para que não serve
8. Perguntas frequentes

O que é uma verificação de direitos de uso?

Uma verificação de direitos de uso (entitlement check) é a etapa em que o software confirma que a conta conectada tem o plano ou a licença que um recurso exige, antes de deixar o recurso rodar.

No KwaFlux, os recursos que gravam arquivos, ou seja, exportações (incluindo o aprimoramento com IA), conversões, reparos de arquivo e downloads a partir de um link, exigem login e um plano. Todo o resto, como navegar, importar, gerar prévias e diagnosticar um arquivo, funciona sem conta.

Onde a porta dos fundos costuma aparecer

Apps de desktop muitas vezes verificam o plano na interface: um botão fica desativado, ou clicar nele abre uma tela de upgrade. Isso funciona até aparecer um segundo chamador.

Um servidor MCP é um segundo chamador. Se ele mandar tarefas direto para o motor, ou chamar uma função interna que o botão protegia, a verificação da interface não roda. É por isso que a especificação do MCP coloca o controle de acesso no lado do servidor: os servidores devem (“MUST”) validar todas as entradas das ferramentas e “implementar controles de acesso adequados”. Uma verificação que mora no botão não conta.

Uma verificação, dentro do app

O KwaFlux coloca a verificação onde todo pedido precisa passar: o plano de controle dentro do app em execução. O script MCP não decide nada sobre planos. Ele repassa um pedido tipado, e o app responde.

Se você não estiver logado, ou se o seu plano não cobrir o recurso, o assistente recebe um erro estruturado dizendo isso e pode pedir que você faça login. Ele não consegue contornar a verificação, porque não há mais nada para chamar. Para ver como as camadas se encaixam, leia por que agentes de IA não deveriam clicar na tela.

Uma segunda verificação no worker

A verificação do app decide se uma tarefa pode entrar na fila. O worker, o processo separado que de fato roda o motor, faz a própria verificação antes de começar o trabalho pago: ele valida um lease (uma autorização de uso) da tarefa, assinado com Ed25519.

Uma verificação de assinatura em outro processo significa que a decisão não depende de um único ponto. Uma tarefa que chegou ao worker por qualquer outro caminho, sem um lease assinado válido, não executa os recursos pagos.

Ed25519 é o esquema de assinatura de curva de Edwards especificado na RFC 8032. Ele usa chaves e assinaturas pequenas (chaves públicas de 32 bytes e assinaturas de 64 bytes no Ed25519), e a validação é rápida, o que combina com uma verificação feita em cada tarefa.

Observação: de propósito, não descrevemos o que um lease contém nem quanto tempo ele dura. A ideia do design é que o worker consiga validá-lo sem confiar em quem lhe entregou a tarefa.

Retomar e tentar de novo passam outra vez pelas verificações

As novas tentativas são a parte delicada. Uma tarefa que era permitida quando entrou na fila pode não ser mais quando for retomada uma hora depois. O KwaFlux trata retomar e tentar de novo como decisões novas:

• O plano é verificado de novo. Se o seu plano terminou depois que a tarefa entrou na fila, retomar ou tentar de novo uma tarefa paga não passa na verificação, exatamente como aconteceria com um pedido novo.
• A configuração de downloads é verificada de novo. Se você desativou os downloads por agentes depois que um assistente colocou um na fila, a nova tentativa é recusada. Veja por que uma IA não pode aprovar downloads por você.
• A autoria é verificada de novo. Um assistente só pode retomar ou tentar de novo as tarefas que ele mesmo enviou.

A alternativa seria uma tarefa que, uma vez aprovada, pode ser tentada de novo indefinidamente com base em uma decisão que já não vale. Verificar no momento da ação fecha essa brecha.

O que é grátis pelo MCP

A parte grátis do KwaFlux continua grátis pelo MCP. Sem login, um assistente pode:

• verificar se o KwaFlux está aberto e com login feito;
• listar as tarefas e ler o status delas;
• diagnosticar um arquivo danificado para ver se ele tem conserto;
• pausar ou cancelar as próprias tarefas.

As prévias grátis de 1, 3 e 5 segundos ficam no app; o assistente não as renderiza.

Para que serve este design, e para que não serve

Este design mantém as regras iguais nos dois caminhos. Um assistente de IA não desbloqueia nada e não tira nada a que você tem direito. Todo pedido passa pela mesma verificação, e toda tarefa que o assistente inicia aparece na lista de tarefas do app, com uma etiqueta indicando o assistente que a enviou.

Ele não substitui a proteção do próprio canal, que impede que outras contas e outros computadores sequer conversem com o KwaFlux. Isso está em como proteger o canal local.

Conclusão

Adicionar uma interface de IA a um app pago é uma chance de descobrir onde as suas verificações realmente estão. O KwaFlux mantém uma única verificação no plano de controle do app, tanto para cliques quanto para chamadas de ferramentas, faz o worker validar um lease assinado antes do trabalho pago e verifica de novo toda vez que uma tarefa é retomada ou tentada de novo. O assistente recebe o mesmo KwaFlux que você.

O mesmo KwaFlux, pelo app ou pelo seu assistente

O servidor MCP local do KwaFlux permite que Codex, Claude, Cursor e outros apps MCP iniciem as mesmas tarefas que você pode iniciar no app, com as mesmas regras. O processamento de IA roda na sua própria GPU e os seus arquivos de mídia não são enviados para processamento. Roda no Windows 10 (64 bits, versão 1809 ou mais recente), no Windows 11 e no macOS 12 ou mais recente em Apple Silicon. Importar arquivos e explorar o app não exigem conta. O login com um plano pago só é necessário para exportar, converter, reparar um arquivo ou baixar um arquivo de um link.

Baixar o KwaFlux · Ver planos