Como usar o KwaFlux pelo Cursor: configuração do MCP, primeiros pedidos e soluções

O essencial

• O agente do Cursor consegue comandar o KwaFlux pelo servidor MCP local que vem com o app. A configuração é um botão no KwaFlux ou uma entrada no mcp.json.
• Deixe o KwaFlux aberto e o Node.js instalado. O servidor é um programa local no seu computador, então os agentes na nuvem do Cursor não conseguem alcançá-lo.
• Por padrão, o Cursor pede confirmação antes de rodar ferramentas MCP. Aprove primeiro as somente leitura para testar a conexão.
• A maioria das falhas de configuração vem de três coisas: um caminho do Windows sem escape no JSON, editar o mcp.json errado e não recarregar.

O agente do Cursor consegue comandar o KwaFlux no seu computador pelo servidor MCP local que é instalado junto com o app. No KwaFlux, abra Configurações › Agent (MCP), escolha o Cursor e clique em Instalar no Cursor, ou cole uma entrada no mcp.json do Cursor. Depois, peça ao agente para diagnosticar, reparar, converter ou aprimorar um vídeo.

A configuração leva uns cinco minutos. O Cursor roda o servidor, e o KwaFlux faz o processamento.

Neste guia, você vai ver as duas formas de adicionar o KwaFlux ao Cursor, como conferir a conexão, o que pedir primeiro e como resolver os problemas mais comuns.

Conteúdo

1. O que o Cursor faz com um servidor MCP?
2. Antes de começar
3. Método 1: instalar pelo KwaFlux com um botão
4. Método 2: editar o mcp.json você mesmo
5. Confira se está conectado
6. Os seus primeiros pedidos
7. Aprovações e execução automática
8. Solução de problemas
9. Perguntas frequentes

O que o Cursor faz com um servidor MCP?

Um servidor MCP dá ferramentas extras ao agente do Cursor. No caso de um servidor local (stdio), o Cursor inicia o programa no seu computador ao carregar, e o agente chama as ferramentas dele quando um pedido precisa delas.

O servidor do KwaFlux é um script Node.js que vem com o app. As ferramentas dele verificam o status do app, colocam na fila trabalhos como conversão, reparo e aprimoramento e esperam que terminem. Para entender o que é um agente e como esse ciclo funciona, veja o que é um agente de IA.

Antes de começar

Observação: no Mac, o trecho do KwaFlux aponta para um auxiliar dentro do app (<KwaFlux.app>/Contents/Helpers/kwaflux-mcp-run) em vez de um caminho de script. Copie pelo app, para que a localização real já venha preenchida.

Método 1: instalar pelo KwaFlux com um botão

1. No KwaFlux, abra Configurações e vá até Agent (MCP).
2. Em Host MCP, escolha Cursor.
3. Clique em Instalar no Cursor. O KwaFlux copia a configuração e abre o Cursor com um link de instalação.
4. Aprove a instalação no Cursor.
5. Como diz a dica do KwaFlux: “Depois de instalar, recarregue o MCP no Cursor.”

Ao clicar, o KwaFlux copia a configuração e mostra “Configuração copiada, abrindo o Cursor — cole manualmente se não abrir”. Se o Cursor não abrir, siga o Método 2; a configuração já está na sua área de transferência.

O botão abre um link neste formato, com a configuração codificada no final:

cursor://anysphere.cursor-deeplink/mcp/install?name=kwaflux&config=eyJjb21tYW5kIjoiQzpcXFByb2dyYW0gRmlsZXNcXG5vZGVqc1xcbm9kZS5leGUiLCJhcmdzIjpbIkM6XFxQcm9ncmFtIEZpbGVzXFxLd2FGbHV4XFxUb29sc1xca3dhZmx1eC1tY3BcXGt3YWZsdXhfbWNwLm1qcyJdfQ

Esse é o link de uma instalação padrão no Windows. O seu pode ser diferente se você instalou o KwaFlux em outro lugar.

Método 2: editar o mcp.json você mesmo

O Cursor lê os servidores MCP de dois arquivos:

O KwaFlux é um app de desktop, não parte de um projeto, então use o arquivo global.

1. No KwaFlux, escolha Cursor em Host MCP e clique em Copiar config.
2. Abra o ~/.cursor/mcp.json ou crie o arquivo.
3. Se o arquivo for novo, cole o trecho inteiro. Se ele já tiver servidores, adicione só a entrada kwaflux dentro do mcpServers que já existe.

Para uma instalação padrão no Windows, o trecho é:

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

4. Salve e depois reinicie o Cursor ou desligue e ligue o servidor em Customize.

Dica: mantenha as barras invertidas duplas. No JSON, uma \ sozinha inicia uma sequência de escape, então C:\Program Files invalida o arquivo inteiro, e o Cursor descarta todos os servidores dele, não só o KwaFlux.

Confira se está conectado

1. Abra Customize na barra lateral do Cursor e procure kwaflux. Ele deve estar ativado, com as ferramentas listadas.
2. No chat do agente, pergunte:

O KwaFlux está rodando? Confira com as ferramentas do KwaFlux.

O agente chama kwaflux_get_app_status. Se o KwaFlux estiver aberto, a resposta informa também se você fez login. Se estiver fechado, a ferramenta devolve um erro que começa com app_not_running. Abra o KwaFlux e pergunte de novo.

3. Peça a sua lista de tarefas. Uma lista vazia não é problema; significa que a cadeia inteira funciona.

Os seus primeiros pedidos

Passe caminhos locais completos e diga para que você quer o resultado:

Cada tarefa aparece na lista de tarefas do KwaFlux, onde você pode acompanhar, pausar ou cancelar. Para detalhes sobre conversão, veja o Conversor.

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

Aprovações e execução automática

A documentação do Cursor diz que ele “pede aprovação antes de usar ferramentas MCP por padrão”, e as ferramentas MCP seguem os mesmos Run Modes dos comandos de terminal. É um padrão sensato para o KwaFlux:

• As ferramentas somente leitura, como status do app, lista de tarefas, detalhes de tarefa e lista de formatos de exportação, podem entrar na lista de permitidas sem risco.
• As ferramentas que colocam trabalhos na fila gravam arquivos novos ao lado da origem. Continue aprovando essas pessoalmente até confiar nos seus pedidos.

Solução de problemas

Para problemas que não são específicos do Cursor, veja o guia de solução de problemas do MCP do KwaFlux.

Conclusão

Clique em Instalar no Cursor ou cole uma entrada no ~/.cursor/mcp.json. Depois recarregue, deixe o KwaFlux aberto e peça ao agente para conferir o status do app antes do primeiro trabalho de verdade. A partir daí, conversões, reparos e aprimoramentos podem começar no chat do Cursor e aparecer na lista de tarefas do KwaFlux.

Comande o KwaFlux pelo Cursor

O KwaFlux inclui um servidor MCP local para o Cursor e outros apps 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