Por dentro do KwaFluxTutorial

Como usar o KwaFlux no Codex: configuração do MCP, timeouts e aprovações

Adicione o KwaFlux ao OpenAI Codex com codex mcp add ou pelo config.toml, aumente o timeout das ferramentas para vídeos longos e defina as aprovações.

Por Joseph Williams · revisado pela equipe editorial da KwaFlux27 de outubro de 20267 min

O essencial

O Codex se conecta ao KwaFlux com um único comando codex mcp add ou com uma tabela [mcp_servers.kwaflux] no ~/.codex/config.toml. O KwaFlux gera as duas coisas para você.
Por padrão, o Codex dá 60 segundos a cada chamada de ferramenta MCP, e a ferramenta de espera do KwaFlux pode esperar até 300. Aumente o tool_timeout_sec para que os trabalhos de vídeo longos não sejam interrompidos.
A linha de comando não inclui o timeout de inicialização de 20 segundos que vem no TOML do KwaFlux. Acrescente esse valor se o servidor demorar para iniciar.
Com os modos de aprovação do Codex, as ferramentas somente leitura do KwaFlux rodam à vontade, e o Codex continua pedindo confirmação antes dos trabalhos que gravam arquivos.

O Codex, da OpenAI, pode controlar o KwaFlux pelo servidor MCP local que vem instalado com o app. Nas configurações do KwaFlux, escolha Codex, copie o comando de instalação ou a tabela TOML, adicione ao Codex e deixe o KwaFlux aberto. Para trabalhar com vídeo, vale a pena mudar duas configurações: o timeout das ferramentas e o modo de aprovação.

Neste guia, você vai ver as duas formas de adicionar o KwaFlux ao Codex, os timeouts que importam para trabalhos longos, como controlar as aprovações e o que pedir primeiro.

Conteúdo

Como o Codex executa um servidor MCP
Antes de começar
Método 1: codex mcp add
Método 2: editar o config.toml
Timeouts para trabalhos de vídeo longos
Aprovações e listas de ferramentas
Seus primeiros pedidos
Solução de problemas
Perguntas frequentes

Como o Codex executa um servidor MCP

Quando uma sessão começa, o Codex inicia cada servidor MCP local listado na configuração e se comunica com ele pela entrada e saída padrão. As ferramentas do servidor passam então a aparecer para o modelo ao lado das ferramentas do próprio Codex. A Codex CLI e o app de desktop do Codex usam a mesma configuração.

O servidor do KwaFlux é um script Node.js instalado junto com o app. Ele não processa nada sozinho: repassa os pedidos ao KwaFlux em execução, que os verifica e executa os trabalhos.

Antes de começar

KwaFlux 1.0.14 ou mais recente, aberto.
Node.js 18 ou mais recente, no PATH. Confira com node --version e, se precisar, instale a versão LTS atual pelo nodejs.org. O cartão nas configurações do KwaFlux também procura o Node.js e grava o caminho completo dele na configuração, como nos exemplos abaixo; se não encontrar o Node.js, o cartão avisa e grava node no lugar.
No KwaFlux: abra Configurações › Agent (MCP) e escolha Codex em Host MCP.

Método 1: codex mcp add

Clique em Copiar comando de instalação e rode o comando em um terminal. Em uma instalação padrão no Windows, ele fica assim:

codex mcp add kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

Rodamos esse comando na Codex CLI 0.118.0, e ela exibiu Added global MCP server 'kwaflux'. Depois, confira:

codex mcp list

O KwaFlux deve aparecer como habilitado. O comando grava no ~/.codex/config.toml uma tabela só com command e args. Continue lendo para ver as duas linhas que vale a pena acrescentar à mão.

Método 2: editar o config.toml

Em vez disso, clique em Copiar config e acrescente a tabela ao ~/.codex/config.toml ou ao .codex/config.toml de um projeto confiável:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

Como diz a dica do KwaFlux, “A chave é mcp_servers (sublinhado).” Depois, reinicie o Codex ou execute /mcp em uma sessão para ver o servidor.

Observação: o caminho está entre aspas simples de propósito. No TOML, strings entre aspas simples são literais, então as barras invertidas do Windows não precisam de escape. Entre aspas duplas, você teria de escrever \\ para cada uma.

Timeouts para trabalhos de vídeo longos

A documentação de MCP do Codex lista dois timeouts por servidor:

Configuração	Padrão do Codex	Recomendado para o KwaFlux	Por quê
`startup_timeout_sec`	10	20 (no TOML do KwaFlux)	Em uma máquina ocupada, o Node.js e o servidor podem levar alguns segundos para iniciar
`tool_timeout_sec`	60	330	A ferramenta de espera do KwaFlux pode esperar até 300 segundos em uma única chamada

O segundo é o que mais importa. Quando o Codex pede ao KwaFlux que espere uma exportação, a ferramenta de espera fica bloqueada até a tarefa terminar ou até atingir o próprio limite, de até 300 segundos. Com o padrão de 60 segundos do Codex, uma espera mais longa é cortada do lado do Codex, e o modelo pode tratar isso como uma falha. Defina:

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

De qualquer forma, a tarefa continua rodando no KwaFlux. Um timeout só encerra aquela espera, e o Codex pode consultar a tarefa de novo.

Aprovações e listas de ferramentas

O Codex deixa você escolher, por servidor, quando ele pede confirmação antes de rodar uma ferramenta. A documentação lista auto, prompt, writes e approve para default_tools_approval_mode, em que writes “pede confirmação para ferramentas que não estão marcadas como somente leitura”. Isso combina com o KwaFlux: as chamadas de status e de lista de tarefas passam direto, e os trabalhos que gravam arquivos continuam pedindo confirmação.

Você também pode limitar o que o Codex carrega com enabled_tools, uma lista de permissões, ou disabled_tools, uma lista de bloqueio. Por exemplo, se você só usa o Codex para converter e reparar, liste apenas as ferramentas de tarefas, de conversão e de reparo. Menos ferramentas também deixam mais espaço no contexto do modelo, como explica nosso post sobre o design das ferramentas.

Seus primeiros pedidos

Veja se o KwaFlux está aberto e liste minhas tarefas recentes no KwaFlux.

Depois:

Peça ao Codex	O que o KwaFlux faz
“Diagnostique D:\Phone\clip.mp4 e repare o arquivo com o modo recomendado.”	Faz o diagnóstico e depois uma tarefa de reparo; o resultado é gravado ao lado do original
“Liste os formatos de exportação do KwaFlux para TikTok e depois exporte D:\Clips\promo.mov no nível HD 1080P.”	Consulta os níveis do formato e depois coloca na fila uma exportação do Conversor
“Converta cada .mkv em D:\Rec para MP4 com o perfil de qualidade, um de cada vez, esperando cada um terminar.”	Coloca as conversões na fila, uma após a outra, dentro do limite de frequência do KwaFlux
“Aplique a Estabilização de vídeo em D:\Walk\bridge.mp4.”	Uma tarefa de aprimoramento com IA usando as configurações padrão do app

A interpolação de quadros e as ferramentas de recorte e de substituição ficam no app; o assistente é instruído a mandar você para lá nesses casos. Os downloads feitos por agentes ficam desativados, a menos que você mude Permitir que agentes iniciem downloads, em Autorização de agentes, para a opção que pergunta a cada download. Aí o KwaFlux mostra uma janela para cada download, e o assistente também pede que você confirme no chat que tem o direito de baixar aquele conteúdo.

Solução de problemas

Sintoma	Causa provável	Solução
O `/mcp` não mostra o kwaflux	Chave errada (`mcp-servers` ou `mcpServers`) ou arquivo errado	Use `[mcp_servers.kwaflux]` no `~/.codex/config.toml`
O servidor estoura o tempo na inicialização	Padrão de 10 segundos com uma inicialização lenta	Acrescente `startup_timeout_sec = 20`
As esperas falham depois de cerca de um minuto	Timeout de ferramenta de 60 segundos	Acrescente `tool_timeout_sec = 330`
A configuração de um projeto é ignorada	O projeto não é confiável	Marque o projeto como confiável ou use a configuração global
Toda chamada retorna `app_not_running`	O KwaFlux está fechado	Abra o KwaFlux e peça de novo
Erro de análise do TOML no caminho	Barras invertidas entre aspas duplas	Use aspas simples ou duplique cada barra invertida

Para problemas comuns a todos os hosts, veja o guia de solução de problemas do MCP do KwaFlux.

Conclusão

Adicione o KwaFlux com o comando ou com o TOML que o KwaFlux copia para você e depois acrescente duas linhas: um timeout de inicialização de 20 segundos e um timeout de ferramenta de 330 segundos. Escolha o modo de aprovação writes se quiser que o Codex peça confirmação só antes dos trabalhos que criam arquivos. Deixe o KwaFlux aberto e comece com uma verificação de status.

Controle o KwaFlux pelo Codex

O KwaFlux inclui um servidor MCP local para o Codex e outros apps compatíveis com MCP. 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

Teste no seu próprio material

Baixe o KwaFlux e veja os efeitos de graça no seu próprio material antes de pagar — sem conta, processado na sua GPU, sem enviar sua mídia para processamento. As prévias de vídeo duram 1, 3 ou 5 segundos; as de estabilização, 5, 15 ou 30 segundos.

Experimentar o KwaFlux grátis Explorar recursos

Perguntas frequentes

Onde o Codex guarda os servidores MCP?

No ~/.codex/config.toml, com uma tabela [mcp_servers.<name>] para cada servidor. Um projeto confiável também pode ter o próprio .codex/config.toml. A CLI e o app de desktop leem os dois.

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 ficar bloqueadas por mais tempo, 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.

O Codex pode rodar ferramentas MCP sem pedir confirmação?

Depende do modo de aprovação que você definir. O Codex pode pedir confirmação para todas as ferramentas, só para as que não são somente leitura, ou para nenhuma. O modo writes é um meio-termo razoável para ferramentas que criam arquivos.

O Codex é uma boa escolha para trabalhar com vídeo?

Depende do seu jeito de trabalhar. O Codex combina com quem se sente à vontade no terminal ou já o usa para programar. Para outras pessoas, um app de chat pode ser mais fácil. Nossa comparação de assistentes mostra as opções.

Fontes

OpenAI, Codex documentation, MCP page (codex mcp add; config.toml fields; startup_timeout_sec default 10; tool_timeout_sec default 60; approval modes; enabled_tools and disabled_tools; /mcp) (acessado em 2026-10-26)
TOML v1.0.0, "String" (literal strings in single quotes) (acessado em 2026-10-26)
Node.js, "Node.js Releases" (acessado em 2026-10-25)

tutorial
MCP

Joseph Williams

Autor e editor da KwaFlux. Os artigos são revisados pela equipe editorial da KwaFlux e se baseiam em nossas notas de pesquisa de produto e nas especificações publicadas.