Controlar o KwaFlux a partir de Codex, Claude, OpenClaw, DeepSeek, Hermes e Cursor
O KwaFlux traz um servidor MCP local. Deixe o app aberto e conecte Codex, Claude, OpenClaw, DeepSeek, Hermes ou Cursor. Converter, reparar, aprimorar e baixar exigem login e um plano pago.
O que é isto
Sim, um agente de IA pode controlar o KwaFlux: o app de desktop traz um servidor MCP local ao qual Codex, Claude, OpenClaw, DeepSeek (DSH), Hermes e Cursor podem se conectar. Abra Configurações › Avançado › Agent (MCP), copie a configuração para o seu app de chat e mantenha o KwaFlux aberto. A conexão é stdio local neste computador, sem etapa de OAuth.

Onde cada host guarda a config
| Host | Onde |
|---|---|
| Codex | Acrescente a ~/.codex/config.toml. A chave é mcp_servers. Reinicie o Codex ou execute /mcp. |
| Claude Code | O .mcp.json do projeto, ou o comando de instalação. Abra uma sessão nova depois da alteração. |
| Claude Desktop | Mescle em claude_desktop_config.json e depois encerre o app e o processo, não só a janela. No Windows o arquivo fica em %APPDATA%\Claude\. |
| OpenClaw | Mescle em mcp.servers de ~/.openclaw/openclaw.json, ou execute openclaw mcp set. |
| DeepSeek | Um YAML de perfil DSH. Reinicie a sessão DSH. |
| Hermes | Execute hermes mcp add, ou escreva mcp_servers no config.yaml (%LOCALAPPDATA%\hermes no Windows nativo, ~/.hermes nos demais). |
| Cursor | Use a instalação integrada ao app e depois execute Reload MCP no Cursor. |
O que o agente pode fazer
Ele verifica se o app está aberto e com sessão iniciada, lista tarefas e espera uma terminar. Também pode pausar, retomar, cancelar ou tentar de novo uma tarefa que ele mesmo começou. Diagnostique um arquivo danificado antes de repará-lo.
- Converter: exporta para 64 formatos por nível de qualidade, com predefinições para YouTube, TikTok e outras plataformas, e transforma um trecho em GIF. O arquivo é salvo ao lado do arquivo de entrada.
- Reparar: o diagnóstico pode rodar primeiro.
- Aprimorar: reparo de qualidade, cor, estabilização, desentrelaçamento, efeitos inteligentes e beleza. O arquivo é salvo ao lado do arquivo de entrada.
- Baixar: consultar um link e depois salvá-lo. Os downloads ficam desativados até você escolher, em Autorização de agentes, o modo que pede confirmação a cada download. A partir daí, o KwaFlux pergunta em um pop-up antes de cada download.
- A interpolação de quadros fica no app de desktop.
- O recorte e a troca de fundo de pessoas, objetos e céu ficam no app de desktop.
- Clicar em uma pessoa ou em um objeto em um quadro pausado fica no app de desktop.
- O agente não controla uma tarefa que você mesmo começou na janela.
Os downloads ficam desligados até você ligá-los
Abra Configurações › Geral e procure Autorização de agentes. Permitir que agentes iniciem downloads tem três modos: desligado, um que pede confirmação a cada download e um que libera os downloads sem perguntar. No modo que pede confirmação, o KwaFlux mostra um pop-up na área de trabalho com o link, a pasta e o formato, e só o seu clique aprova. Um pop-up sem resposta expira em 120 segundos. O assistente também pede no chat que você confirme que tem o direito de salvar o arquivo, mas a afirmação dele não conta. O KwaFlux não entra em um site nem pula um paywall.
Limites
Os caminhos precisam ser absolutos e apontar para este computador. Converter e aprimorar não deixam o agente escolher a pasta de saída. O app está em download.
O caminho por agente não pede outra licença: uma licença cobre o app e o servidor MCP em até 2 computadores, Windows e Mac em qualquer combinação. As tarefas que um agente inicia rodam nesse computador, e os arquivos de mídia não são enviados para processamento.
O que fica na janela
O agente pode fazer as tarefas listadas acima, e nada além disso. Ele consegue verificar se o app está aberto e se você entrou na conta. Consegue listar tarefas e esperar uma terminar. Consegue pausar, retomar, cancelar ou tentar de novo uma tarefa que ele mesmo iniciou. Consegue diagnosticar um arquivo danificado antes de um reparo. Não consegue controlar uma tarefa que você iniciou clicando na janela do KwaFlux.
Converter exporta para 64 formatos por nível de qualidade e pode transformar um trecho em GIF. Aprimorar cobre reparo de qualidade, cor, estabilização, desentrelaçamento, efeitos inteligentes e beleza. O arquivo é salvo ao lado do arquivo de entrada, e o agente não pode escolher outra pasta. Os caminhos que você passa têm de ser caminhos absolutos neste computador.
A interpolação de quadros, o recorte e a troca de fundo, clicar em uma pessoa ou objeto em um quadro pausado e as prévias grátis de 1, 3 e 5 segundos ficam todos no app de desktop. O agente não os executa.
Os downloads ficam desativados até você escolher, em Autorização de agentes, o modo que pede confirmação a cada download. A partir daí, o KwaFlux pergunta em um pop-up antes de cada download. Uma frase do assistente não conta como aprovação. O KwaFlux não entra em um site por você e não pula um paywall. A tabela de hosts acima mostra onde cada app guarda a config copiada de Configurações. Não invente um caminho. Deixe o KwaFlux aberto enquanto o app de chat está conectado por stdio local.
Se não conectar ou uma tarefa falhar
Confira primeiro o lado do KwaFlux. Abra Configurações › Geral. Em Autorização de agentes, a linha abaixo de Permitir que agentes de IA controlem o KwaFlux mostra cada host conectado agora. Se aparecer Nenhum agente conectado, o app de chat não chegou ao KwaFlux, então a correção está do lado do app de chat.
- Rode
node --versionem um terminal. O servidor precisa do Node.js 18 ou mais recente. Uma versão mais antiga faz ele parar logo na inicialização, e o log do host diz isso com todas as letras. - Codex: digite
/mcpna interface do terminal para ver os servidores ativos, ou rodecodex mcp list. - Claude Code:
claude mcp listmostra um status ao lado de cada servidor, como Connected ou Failed to connect. Um servidor definido no .mcp.json de um projeto espera a sua aprovação na primeira vez que você rodaclaude. - Claude Desktop: os logs ficam em %APPDATA%\Claude\logs no Windows e em ~/Library/Logs/Claude no Mac. O mcp.log registra as conexões, e o mcp-server-kwaflux.log guarda as mensagens do próprio servidor.
- Cursor: abra o painel Output com Ctrl+Shift+U (Cmd+Shift+U no Mac) e escolha MCP Logs na lista suspensa.
Depois de conectado, uma tarefa que falha devolve um código curto, e os assistentes costumam reescrever esse código com outras palavras. Ações recentes de agentes, no mesmo painel, lista cada chamada com o host e o resultado, então você mesmo pode ler o código.
| Código | O que significa | O que fazer |
|---|---|---|
app_not_running | O KwaFlux não está aberto neste computador. | Abra o KwaFlux e depois recarregue o MCP ou reinicie o app de chat. |
agent_control_disabled | Permitir que agentes de IA controlem o KwaFlux está desligado. | Ligue de novo em Configurações › Geral › Autorização de agentes. |
not_signed_in, entitlement_denied | A tarefa precisa de login e de um plano pago. | Entre no KwaFlux e confira o seu plano. |
app_busy | Muitas tarefas foram iniciadas em pouco tempo. | Espere um minuto e peça de novo. |
input_not_local | O caminho começa com duas barras, como \\server\share, ou é um endereço da web. | Copie o arquivo para uma pasta local e informe o caminho completo. |
model_not_installed | O modelo de IA desse recurso ainda não está no computador. | Abra o recurso no KwaFlux e baixe o modelo, ou vá em Configurações › Modelos e armazenamento. |
agent_download_disabled | Os downloads por agentes ainda estão desligados. | Se precisar, escolha em Autorização de agentes o modo que pede confirmação a cada download. |
user_declined, approval_expired | Você recusou o download, ou o pop-up ficou 120 segundos sem resposta. | Peça de novo quando estiver na frente do computador. |
Cada tarefa que um agente adiciona também mostra um aviso curto com o nome do host, por exemplo “Codex adicionou uma tarefa”. A tarefa aparece na central de tarefas junto com as suas. Se você acha que o token de acesso vazou, clique em Redefinir o token de acesso de agentes no fim da linha de conexão. As conexões atuais caem, e os hosts configurados se reconectam com o token novo na próxima chamada.
Teste no seu próprio material
Baixe o KwaFlux e veja os efeitos de graça no seu próprio material antes de pagar. Não precisa de conta. Sua mídia é processada na sua GPU, sem ser enviada para processamento. As prévias de vídeo duram 1, 3 ou 5 segundos; as de estabilização, 5, 15 ou 30 segundos.
Perguntas frequentes
Posso controlar o KwaFlux pelo Claude, pelo Cursor ou por outro assistente de IA?
Sim. O KwaFlux inclui um servidor MCP local que roda via stdio, então clientes como Codex, Claude e Cursor conseguem controlá-lo. Deixe o KwaFlux aberto, copie a configuração de Configurações → Avançado → Agent (MCP) para o app de IA e instale o Node.js 18 ou mais recente. O app de IA usa o Node.js para iniciar o servidor.
Por que não há um botão Authenticate para o KwaFlux?
Porque o servidor MCP do KwaFlux roda localmente via stdio, e não em um URL remoto. Por isso não há etapa de OAuth.
O agente pode exportar ou converter de graça no KwaFlux?
Não, o KwaFlux exige login e um plano pago para converter, reparar, aprimorar e baixar via MCP. As prévias grátis de 1 s, 3 s e 5 s ficam no app de desktop.
O agente pode iniciar downloads no KwaFlux?
Sim, depois que você colocar Permitir que agentes iniciem downloads no modo que pede confirmação a cada download. O KwaFlux passa a perguntar em um pop-up antes de cada download, e o assistente não pode aprovar por você.
Por que o KwaFlux recusa o caminho do meu arquivo?
Os caminhos precisam ser completos e deste computador, como C:\Videos\clip.mp4 ou /Users/you/Movies/clip.mp4. Um caminho relativo falha. Um que começa com duas barras, como \\server\share\clip.mp4, também. O KwaFlux recusa esse tipo de caminho antes de abrir qualquer coisa, porque no Windows, só de verificar o arquivo, o computador pode tentar fazer login nesse servidor. Copie o arquivo para uma pasta local antes.
Como vejo o que o agente fez no KwaFlux?
No KwaFlux, abra Configurações › Geral › Autorização de agentes e veja Ações recentes de agentes. Cada linha mostra o horário, o host, a chamada e o resultado. As tarefas que o agente adicionou também ficam na central de tarefas, e cada uma veio com um aviso com o nome do host.
Os Cloud Agents do Cursor podem usar um servidor MCP local?
Não. Um servidor stdio local é um programa no seu computador. Os Cloud Agents rodam na infraestrutura do Cursor, então não conseguem iniciá-lo. Use o agente do app de desktop do Cursor no mesmo computador.
Por que os caminhos do Windows precisam de barras invertidas duplas no mcp.json?
Porque o JSON trata a barra invertida como início de uma sequência de escape. C:\\Program Files é o JSON válido para C:\Program Files. Com uma barra invertida simples, o arquivo não pode ser lido. Barras normais também funcionam.
Por que o Claude Desktop não enxerga um servidor MCP novo?
Em geral, porque ele continua rodando em segundo plano. Feche a janela, saia pela bandeja do sistema ou pela barra de menus e abra de novo. JSON inválido, como uma barra invertida simples em um caminho do Windows, é a próxima coisa a conferir.
O Claude Code na web vê o KwaFlux local?
Não. O servidor do KwaFlux é um programa local que o host inicia no seu computador. Sessões na nuvem carregam servidores remotos de um .mcp.json do projeto, não o processo Node ao lado do KwaFlux. Use Claude Code ou Claude Desktop na máquina onde o app está aberto.
O que é o tool_timeout_sec no Codex?
É quanto tempo o Codex espera por uma chamada de ferramenta MCP antes de desistir: 60 segundos por padrão. Aumente esse valor em servidores cujas ferramentas podem demorar mais para responder, como uma ferramenta que espera uma exportação de vídeo. Veja como os trabalhos demorados são tratados.
Por que usar aspas simples nos caminhos do Windows no config.toml?
Porque as strings TOML entre aspas simples são literais: as barras invertidas ficam como estão. Em strings entre aspas duplas, a barra invertida inicia um escape, então C:\Program Files precisaria virar C:\\Program Files.
Preciso configurar MCP de novo no app de desktop do ChatGPT?
Não. A página MCP da OpenAI diz que o app de desktop do ChatGPT, a CLI e a extensão de IDE compartilham a config do host Codex. Adicione o KwaFlux uma vez em ~/.codex/config.toml e abra o Codex em qualquer um. O ChatGPT na web não lê esse arquivo.
Onde adicionar servidores MCP no DeepSeek Harness?
Em um arquivo cordis.patch.yml, como uma linha insert do plugin @deepseek-ai/dsh-mcp-client. Use o arquivo próprio de um perfil para valer só nele, ou o arquivo da pasta pessoal, ~/.dsh/cordis.patch.yml, para valer em todos os perfis.
O arquivo de patch é `[]`. Eu colo o KwaFlux embaixo?
Não, troque o [] pelo bloco - insert: do KwaFlux. Um arquivo com [] e outro item de lista não é YAML válido, e o DSH termina com erro de parse. Um patch de perfil novo costuma começar nessa lista vazia.
Um agente rodando em uma VPS consegue usar um servidor MCP local no meu PC?
Não, se for um servidor stdio. Um servidor stdio roda como processo filho do agente, na mesma máquina. Para usar um servidor desses no seu PC, rode o agente lá também. Veja o que é um agente de IA para entender como as partes se conectam.
Por que o servidor MCP falha com o erro “node is not recognized” (“'node' não é reconhecido”)?
Porque o Node.js não está instalado ou não está no PATH que o host enxerga. Instale o Node.js, feche o host e abra de novo. Se não resolver, coloque o caminho completo do node.exe no command do servidor.
Por que chamadas longas de ferramentas MCP dão timeout?
Porque alguns hosts, como Codex e DeepSeek Harness, limitam por padrão cada chamada de ferramenta a 60 segundos. E algumas ferramentas do KwaFlux foram feitas para esperar mais do que isso. Aumente o timeout de ferramentas do host para aquele servidor. O trabalho em si costuma continuar rodando.
O host diz `env: node: No such file or directory` no Mac. E agora?
O host provavelmente foi aberto pelo Dock ou pelo Spotlight, então não recebe o PATH do Terminal e não vê o Node.js instalado com Homebrew ou nvm. No Mac, o lançador do KwaFlux roda o node que estiver nesse PATH. Rode which node no Terminal. Depois coloque no env do servidor um PATH com essa pasta mais /usr/bin:/bin, por exemplo /opt/homebrew/bin:/usr/bin:/bin. Ou abra o host pelo Terminal. Mais sobre Mac: KwaFlux no Mac.
Fontes
- Model Context Protocol: What is the Model Context Protocol (MCP)? (acessado em 2026-10-11)
- Model Context Protocol specification: Transports (stdio) (acessado em 2026-10-11)
- Node.js: Node.js releases (acessado em 2026-10-11)
- Model Context Protocol: Connect to local MCP servers (troubleshooting and Claude Desktop logs) (acessado em 2026-11-08)
- Claude Code docs: Connect Claude Code to tools via MCP (claude mcp list and server status) (acessado em 2026-11-08)
- OpenAI Codex docs: Model Context Protocol (codex mcp list and /mcp) (acessado em 2026-11-08)
Artigos relacionados
Conversão de formato
H.264, H.265 e AV1, processados localmente
AbrirConverter formatos de vídeo localmente (H.264, H.265, MP4, MOV) sem uploads
Converta localmente os masters prontos depois do aprimoramento: que codec e contêiner escolher e por que um conversor embutido poupa um upload.
AbrirReparo de arquivo
Vídeo, imagem e áudio
AbrirDownload de arquivo
Um link colado
Abrir

