Docs

Controlar o KwaFlux a partir de um assistente de IA com MCP

O instalador do KwaFlux 1.0.8 inclui um servidor MCP (Model Context Protocol) local. Um assistente de IA no mesmo computador pode ver o status do app, colocar tarefas na fila e acompanhar o progresso; o KwaFlux continua processando a mídia na sua própria GPU.

Atualizado em · KwaFlux 1.0.8

Antes de começar

  • O KwaFlux 1.0.8 ou mais novo está instalado e aberto no mesmo computador.
  • O Node.js 18 ou mais novo está instalado e no PATH. O instalador traz o script MCP, não o runtime do Node.js.
  • Um app de assistente compatível com MCP: Codex, Claude Code ou Claude Desktop, OpenClaw, DeepSeek (DSH), Hermes ou Cursor.

Conectar seu assistente

  1. No KwaFlux, abra Ajustes → Agent (MCP).
  2. Copie o trecho do seu assistente para a configuração MCP dele. Adicione a entrada kwaflux sem substituir o arquivo inteiro.
  3. Recarregue o MCP no assistente e mantenha o KwaFlux aberto enquanto usa.

O que o assistente pode fazer

  • Ler o status do app e a lista de tarefas, acompanhar o progresso de uma tarefa e esperar que termine.
  • Colocar na fila exportações de aprimoramento para um vídeo com 16 módulos: Reparo de qualidade, Correção de cor IA, Estabilização de vídeo, Câmera lenta com IA, Desentrelaçamento, Recorte inteligente, Cartoonização, Geração de esboço, Transferência de estilo fixo, Reiluminação facial e os seis módulos de Beleza IA.
  • Converter o formato de um arquivo, verificar se um arquivo de mídia está danificado e repará-lo.
  • Consultar um link e baixá-lo. Downloads por agente ficam desligados até você permiti-los em Ajustes, e cada download precisa da sua própria confirmação no chat.
  • Pausar, retomar, cancelar ou repetir tarefas.

Login e plano

  • Ler o status, verificar se um arquivo está danificado e pausar ou cancelar tarefas funcionam sem login.
  • Como no app, exportações (incluindo tarefas de aprimoramento), conversões, reparos de arquivo e downloads a partir de um link exigem login e um plano pago. O mesmo vale para retomar ou repetir essas tarefas.
  • As prévias grátis de 1 s, 3 s e 5 s ficam no app de desktop; o assistente não as gera.

Arquivos e conexão

  • Exportações, conversões e reparos são gravados ao lado do arquivo de origem. Os downloads vão para uma pasta existente que você escolher.
  • Só são aceitos caminhos deste computador. Caminhos de rede são recusados antes de qualquer acesso a arquivos.
  • A conexão é stdio local: sem URL remota, sem OAuth e sem botão Authenticate. No Windows ela usa um pipe nomeado da sua conta de usuário; no Mac, um socket que só a sua conta pode abrir.
  • Novas tarefas são limitadas a cerca de 10 por minuto.

Solução de problemas

  • app_not_runningAbra o KwaFlux e depois recarregue o MCP no assistente.
  • As ferramentas ficam carregando: confira se o Node.js 18 ou mais novo está instalado e no PATH e recarregue o MCP.
  • not_signed_in / entitlement_deniedEntre no KwaFlux com uma conta que tenha um plano pago.
  • agent_download_disabledPermita primeiro os downloads por agente em Ajustes.

Configuração por assistente: Controlar o KwaFlux a partir de Codex, Claude, OpenClaw, DeepSeek, Hermes e Cursor.