Como usar o KwaFlux com o DeepSeek: conectando o DeepSeek Harness (DSH) via MCP

O essencial

• O DeepSeek Harness (DSH) se conecta ao KwaFlux por meio de uma linha insert em um arquivo cordis.patch.yml. O KwaFlux gera essa linha para você.
• Coloque a linha onde o DSH que você usa vai lê-la: o patch da pasta pessoal, ~/.dsh/cordis.patch.yml, vale para todos os perfis; o arquivo próprio de um perfil vale só para aquele perfil.
• O DSH recarrega os arquivos de patch automaticamente, então as ferramentas costumam aparecer sem reiniciar nada.
• Aumente o timeout por chamada de ferramenta, para que um trabalho de vídeo longo não seja interrompido enquanto o DeepSeek espera por ele.

O agente do DeepSeek pode controlar o KwaFlux pelo servidor MCP local que vem instalado com o app. O DeepSeek Harness (DSH) carrega servidores MCP como linhas de plugin em um arquivo de configuração em camadas chamado cordis.patch.yml. No KwaFlux, escolha DeepSeek em Host MCP, copie a linha e acrescente-a ao arquivo de patch que o seu perfil do DSH lê.

Neste guia, você vai ver onde a linha deve ficar, por que o perfil importa, qual timeout aumentar e o que pedir primeiro ao DeepSeek.

Conteúdo

1. Como o DSH carrega servidores MCP
2. Antes de começar
3. Passo 1: copie a linha no KwaFlux
4. Passo 2: escolha o arquivo de patch certo
5. Passo 3: acrescente a linha
6. Passo 4: confira se ela foi carregada
7. Seus primeiros pedidos
8. Solução de problemas
9. Perguntas frequentes

Como o DSH carrega servidores MCP

O DeepSeek Harness monta a configuração a partir de camadas de arquivos de patch. Cada perfil tem o próprio cordis.patch.yml; já o $DSH_HOME/cordis.patch.yml, na pasta pessoal, traz, nas palavras da referência da CLI, “preferências locais da máquina, compartilhadas por todos os perfis, por isso tem prioridade sobre a camada de cada perfil”.

Os servidores MCP são linhas que usam o plugin cliente de MCP do DSH, @deepseek-ai/dsh-mcp-client. O DSH não ativa nenhum por padrão: a referência explica que “cada comando de servidor é código executável confiável fora do sandbox do agente”. Adicionar o KwaFlux é uma decisão explícita de confiar no servidor do KwaFlux.

Antes de começar

• KwaFlux 1.0.14 ou mais recente, aberto.
• Node.js 18 ou mais recente, no PATH. Confira com node --version. 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.
• DeepSeek Harness instalado. A documentação do DSH o identifica como Preview, então caminhos e comandos podem mudar de uma versão para outra.

Passo 1: copie a linha no KwaFlux

No KwaFlux, abra Configurações › Agent (MCP), escolha DeepSeek em Host MCP e clique em Copiar config. Em uma instalação padrão no Windows, a linha é esta:

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']

Observação: o caminho está entre aspas simples. No YAML, strings entre aspas simples mantêm as barras invertidas como estão, então um caminho do Windows não precisa de escape.

Passo 2: escolha o arquivo de patch certo

A dica do KwaFlux cita um único arquivo: “Insira esta linha de plugin em ~/.dsh/profiles/web/cordis.patch.yml e reinicie a sessão DSH.” Isso está certo se você usa o perfil web do DSH, dsh web. Se você usa outra coisa, escolha conforme a tabela:

No Windows, ~ é C:\Users\<you>. Se você definiu DSH_HOME, use essa pasta em vez de ~/.dsh.

O motivo mais comum para o KwaFlux “não aparecer” no DSH é a linha ter ido para um perfil que você não está usando.

Passo 3: acrescente a linha

1. Antes de tudo, faça um backup do arquivo.
2. O arquivo de patch é uma lista YAML. Adicione a linha do KwaFlux no fim, com o mesmo recuo dos outros itens de primeiro nível - insert: ou - replace:.
3. Se o arquivo ainda não existir, crie-o só com a linha do KwaFlux.
4. Se quiser, aumente o timeout das ferramentas dentro de config::

- insert:
    - id: mcp-kwaflux
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: kwaflux
        transport: stdio
        command: 'C:\Program Files\nodejs\node.exe'
        args: ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
        toolCallTimeoutMs: 330000

Um guia de configuração de terceiros informa que o timeout padrão por chamada do DSH é de 60 segundos. A ferramenta de espera do KwaFlux pode esperar até 300 segundos em uma única chamada, então 330.000 milissegundos deixam uma folga. Se a sua versão do DSH rejeitar o campo, remova-o; o DeepSeek ainda pode voltar a esperar depois de uma interrupção.

Passo 4: confira se ela foi carregada

O DSH monitora os arquivos de patch e aplica as edições válidas com recarga automática, então o servidor costuma iniciar poucos segundos depois de você salvar. Se nada mudar, reinicie a sessão do DSH, como sugere a dica do KwaFlux.

Depois, peça:

Use as ferramentas do KwaFlux para ver se o KwaFlux está aberto.

No DSH, as ferramentas do KwaFlux se chamam mcp__kwaflux__<tool>, como mcp__kwaflux__kwaflux_get_app_status. Se o KwaFlux estiver fechado, a ferramenta retorna um erro que começa com app_not_running.

Seus primeiros pedidos

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

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

Conclusão

Copie a linha no KwaFlux, coloque-a no arquivo de patch que o DSH que você realmente usa vai ler e acrescente um timeout de ferramenta maior para os trabalhos de vídeo. O DSH recarrega o arquivo ao salvar. Depois, deixe o KwaFlux aberto e peça ao DeepSeek que verifique o status do app antes do primeiro trabalho de verdade.

Controle o KwaFlux pelo DeepSeek

O KwaFlux inclui um servidor MCP local para o DeepSeek Harness 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