Comfy Pilot MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Terminal Claude Code incorporado (xterm.js) dentro do ComfyUI
Servidor MCP com acesso direto ao gráfico (criar nós, conectar bordas)
Análise de imagem dos nós Visualizar/Salvar imagem
Downloads de modelos de HuggingFace, CivitAI ou URLs diretos
Descoberta de nó personalizado + instalação do registro

Demo ao vivo

Como fica na prática

comfy-pilot.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "comfy-pilot",
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "comfy-pilot": {
      "command": {
        "path": "comfy",
        "args": [
          "node",
          "install",
          "comfy-pilot"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add comfy-pilot -- comfy node install comfy-pilot

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Comfy Pilot

Crie um fluxo de trabalho SDXL a partir de uma descrição de uma linha

👤 Usuários do ComfyUI que preferem descrever do que arrastar ⏱ ~20 min intermediate

Quando usar: Você sabe o que deseja que o fluxo de trabalho faça; você não quer gastar 20 minutos conectando-o.

Pré-requisitos

ComfyUI + comfy-pilot instalado — nó confortável instalar comfy-pilot
Claude Código CLI — O Pilot o instala automaticamente se estiver faltando

Fluxo

Abra o piloto no ComfyUI

Abra o terminal Pilot e diga: 'Crie um fluxo de trabalho de texto para imagem SDXL com condicionamento de profundidade ControlNet.'✓ Copiado

→ Montagem de gráficos de nós; modelos são instalados se estiverem faltando
Execute-o

Execute o fluxo de trabalho com prompt='cathedral interior, soft light' e meu mapa de profundidade.✓ Copiado

→ Imagem produzida; fluxo de trabalho salvo

Resultado: Um fluxo de trabalho funcional sem colocar manualmente 20 nós.

Armadilhas

Pedindo um modelo exótico que o piloto não consegue encontrar — Forneça um URL de repositório HuggingFace ou ID CivitAI; O piloto baixa o que for especificado

Combine com: comfyui-mcp-server

Refatore um fluxo de trabalho confuso existente

👤 Usuários com fluxos de trabalho que cresceram organicamente ⏱ ~25 min intermediate

Quando usar: Seu gráfico tem 60 nós, metade não utilizados, e você deseja que ele esteja limpo.

Fluxo

Peça um plano de limpeza

Analise meu gráfico atual; listar nós mortos e ramificações redundantes.✓ Copiado

→ Claude lê o gráfico via MCP e produz um plano
Aplicar

Aplicar - mas mantenha o nó Visualizar imagem no final.✓ Copiado

→ Nós removidos; bordas reconectadas; visualização intacta

Resultado: Fluxo de trabalho mais limpo e fácil de editar.

Armadilhas

Removendo um nó do qual o código personalizado downstream dependia — Faça com que a lista piloto toque nos nós antes das operações destrutivas

Instalar automaticamente nós personalizados que um fluxo de trabalho precisa

👤 Pessoas abrindo fluxos de trabalho de terceiros ⏱ ~10 min beginner

Quando usar: Você importou um fluxo de trabalho e o ComfyUI relata nós personalizados ausentes.

Fluxo

Peça ao Piloto para resolver

Encontre e instale todos os nós personalizados que esse fluxo de trabalho precisa.✓ Copiado

→ O piloto lista os nós ausentes e depois instala a partir do registro
Verificar

Recarregue e confirme se o gráfico não possui mais bordas vermelhas.✓ Copiado

→ Gráfico valida de forma limpa

Resultado: Fluxos de trabalho desconhecidos que podem ser usados sem procurar dependências.

Armadilhas

Instalando nós personalizados desconhecidos em escala — Verifique a fonte do pacote antes de deixar o Pilot instalar dezenas

Combinações

Combine com outros MCPs para 10× de alavancagem

comfy-pilot + comfyui-mcp-server

Fluxos de trabalho de autores piloto; o servidor MCP os executa de outros clientes

Faça com que o Pilot crie o fluxo de trabalho; em seguida, execute-o no Claude Desktop via comfyui-mcp-server.✓ Copiado

comfy-pilot + filesystem

Organize os ativos e fluxos de trabalho que o Pilot cria

Depois que o Pilot salvar um fluxo de trabalho, mova-o para ./workflows/<project>/ com um nome datado.✓ Copiado

comfy-pilot + mcp-image

Compare os resultados locais do ComfyUI com as gerações Gemini no mesmo prompt

Execute o mesmo prompt através do fluxo de trabalho do Pilot e da imagem mcp; diferenciar as saídas.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
graph.list_nodes / graph.get_node	optional filter	Leia o fluxo de trabalho atual	0
graph.create_node / graph.connect	type, parent, edges	Nós de autor e arestas de arame	0
image.analyze	node_id (Preview/Save)	Inspecione uma imagem gerada para decidir a próxima etapa	0
model.download	source (HF repo, CivitAI id, or URL), target	Pontos de verificação/LoRAs ausentes	bandwidth
nodes.install	custom node package(s)	Nós personalizados ausentes ou exigidos automaticamente	bandwidth

Custo e limites

O que custa rodar

Cota de API: Apenas computação local
Tokens por chamada: Pequeno (operações gráficas); bytes de imagem/modelo dominam o disco e a largura de banda
Monetário: Livre; sua GPU + largura de banda
Dica: Peça ao Pilot para confirmar antes de baixar pacotes de modelos grandes; muitos fluxos de trabalho compartilham pontos de verificação.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Use env vars se você adicionar tokens HF ou CivitAI para taxas de download mais altas.

Saída de dados: Downloads de HuggingFace / CivitAI / URLs diretos que você autoriza; caso contrário, local.

A instalação de nós personalizados arbitrários executa seu código Python. Verifique a origem do pacote antes de instalar automaticamente em escala.
Os downloads de modelos de URL direto podem buscar arquivos arbitrários – prefira repositórios HF e IDs CivitAI com proveniência conhecida.

Solução de problemas

Erros comuns e correções

Terminal piloto não abre

Reinstale via comfy node install comfy-pilot; garanta a reinicialização do ComfyUI.

Verificar: ComfyUI → Manager → Installed, confirm comfy-pilot listed

A instalação do nó personalizado falha atrás de um proxy corporativo

Defina HTTPS_PROXY no ambiente do processo ComfyUI antes de iniciar.

Verificar: env | grep -i proxy in the ComfyUI terminal

O download do modelo é interrompido parcialmente

Retome executando novamente o download; O piloto retoma de onde parou para fontes compatíveis.

Verificar: Re-run model.download with the same target path

Alternativas

Comfy Pilot vs. outros

Alternativa	Quando usar	Troca
comfyui-mcp-server	Você deseja executar fluxos de trabalho de clientes MCP externos, não de autor dentro do ComfyUI	Nenhum terminal incorporado; superfície diferente
mcp-image	Você prefere a nuvem Gemini ao ComfyUI local	Menos controle; pague por imagem
everart	Você precisa de modelos de estilo pré-treinados	Fornecedor diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills