Comfy Pilot MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

ComfyUI 내부에 내장된 Claude Code 터미널(xterm.js)
그래프에 직접 액세스할 수 있는 MCP 서버(노드 생성, 에지 연결)
미리보기/이미지 저장 노드의 이미지 분석
HuggingFace, CivitAI 또는 직접 URL에서 모델 다운로드
사용자 정의 노드 검색 + 레지스트리에서 설치

라이브 데모

실제 사용 모습

comfy-pilot.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/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
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

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

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Comfy Pilot

한 줄 설명으로 SDXL 워크플로우를 스캐폴드합니다.

👤 드래그보다 설명을 선호하는 ComfyUI 사용자 ⏱ ~20 min intermediate

언제 쓸까: 워크플로에서 수행하려는 작업이 무엇인지 알고 있습니다. 배선 작업에 20분을 소비하고 싶지는 않습니다.

사전 조건

ComfyUI + comfy-pilot 설치됨 — 편안한 노드 설치 comfy-pilot
클로드 코드 CLI — 누락된 경우 Pilot이 자동으로 설치합니다.

흐름

ComfyUI에서 파일럿 열기

파일럿 터미널을 열고 다음과 같이 말합니다. 'ControlNet 깊이 조절을 사용하여 SDXL 텍스트-이미지 작업 흐름을 구축해 주세요.'✓ 복사됨

→ 노드 그래프 조립; 누락된 경우 모델 설치
실행해 보세요

프롬프트='성당 내부, 부드러운 조명' 및 내 깊이 맵을 사용하여 워크플로를 실행합니다.✓ 복사됨

→ 이미지 생성; 작업 흐름이 저장되었습니다

결과: 20개의 노드를 수동으로 배치하지 않는 작업 흐름입니다.

함정

조종사가 찾을 수 없는 이국적인 모델을 요구함 — HuggingFace 저장소 URL 또는 CivitAI ID를 제공하세요. 파일럿은 지정된 것을 다운로드합니다.

함께 쓰기: comfyui-mcp-server

기존의 지저분한 작업 흐름을 리팩터링

👤 유기적으로 성장한 워크플로를 사용하는 사용자 ⏱ ~25 min intermediate

언제 쓸까: 그래프에는 60개의 노드가 있고 절반은 사용되지 않았으며 깨끗해지기를 원합니다.

흐름

청소 계획을 요청하세요

현재 그래프를 분석합니다. 죽은 노드와 중복 분기를 나열합니다.✓ 복사됨

→ Claude는 MCP를 통해 그래프를 읽고 계획을 세웁니다.
적용하다

적용 — 그러나 끝에 미리보기 이미지 노드를 유지합니다.✓ 복사됨

→ 노드가 제거되었습니다. 가장자리가 다시 배선됨; 그대로 미리보기

결과: 더 깔끔하고 편집하기 쉬운 작업 흐름.

함정

다운스트림 사용자 정의 코드가 의존하는 노드 제거 — 파괴적인 작업 전에 파일럿 목록이 노드를 터치하도록 하세요.

워크플로우에 필요한 사용자 정의 노드 자동 설치

👤 타사 워크플로를 여는 사람들 ⏱ ~10 min beginner

언제 쓸까: 워크플로를 가져왔고 ComfyUI에서 사용자 정의 노드가 누락되었다고 보고합니다.

흐름

파일럿에게 해결을 요청하세요.

이 워크플로에 필요한 사용자 정의 노드를 찾아서 설치하세요.✓ 복사됨

→ 파일럿은 누락된 노드를 나열한 다음 레지스트리에서 설치합니다.
확인하다

다시 로드하고 그래프에 더 이상 빨간색 테두리가 없는지 확인하세요.✓ 복사됨

→ 그래프가 깔끔하게 검증됩니다.

결과: 종속성에 대한 동굴 탐험 없이 사용할 수 있는 알 수 없는 워크플로입니다.

함정

대규모로 알 수 없는 커스텀 노드 설치 — Pilot이 수십 개를 설치하기 전에 패키지 소스를 즉시 확인하십시오.

조합

다른 MCP와 조합해 10배 효율

comfy-pilot + comfyui-mcp-server

파일럿 작성자 워크플로 MCP 서버는 다른 클라이언트에서 이를 실행합니다.

Pilot이 워크플로를 구축하도록 하세요. 그런 다음 comfyui-mcp-server를 통해 Claude Desktop에서 실행하세요.✓ 복사됨

comfy-pilot + filesystem

Pilot이 생성하는 자산 및 워크플로 구성

Pilot이 워크플로를 저장한 후 날짜가 지정된 이름을 사용하여 ./workflows/<project>/로 이동합니다.✓ 복사됨

comfy-pilot + mcp-image

동일한 프롬프트에서 로컬 ComfyUI 결과를 Gemini 세대와 비교

Pilot의 워크플로와 mcp-image를 통해 동일한 프롬프트를 실행합니다. 출력을 다르게 해보세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
graph.list_nodes / graph.get_node	optional filter	현재 워크플로 읽기	0
graph.create_node / graph.connect	type, parent, edges	작성자 노드 및 와이어 에지	0
image.analyze	node_id (Preview/Save)	생성된 이미지를 검사하여 다음 단계 결정	0
model.download	source (HF repo, CivitAI id, or URL), target	누락된 체크포인트/LoRA	bandwidth
nodes.install	custom node package(s)	누락되거나 자동으로 필요한 사용자 정의 노드	bandwidth

비용 및 제한

운영 비용

API 쿼터: 로컬 컴퓨팅만
호출당 토큰: 소형(그래프 작업) 이미지/모델 바이트가 디스크와 대역폭을 지배합니다.
금액: 무료; GPU + 대역폭
팁: 대규모 모델 번들을 다운로드하기 전에 파일럿에게 확인을 요청하세요. 많은 워크플로가 체크포인트를 공유합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 더 높은 다운로드 속도를 위해 HF 또는 CivitAI 토큰을 추가하는 경우 env vars를 사용하십시오.

데이터 외부 송신: HuggingFace/CivitAI/귀하가 승인한 직접 URL에서 다운로드 그렇지 않으면 로컬입니다.

임의의 사용자 정의 노드를 설치하면 Python 코드가 실행됩니다. 대규모 자동 설치 전에 패키지 소스를 확인하세요.
직접 URL 모델 다운로드는 임의의 파일을 가져올 수 있습니다. 출처가 알려진 HF 저장소 및 CivitAI ID를 선호합니다.

문제 해결

자주 발생하는 오류와 해결

파일럿 터미널이 열리지 않습니다

comfy node install comfy-pilot을 통해 다시 설치하세요. ComfyUI가 다시 시작되는지 확인하세요.

확인: ComfyUI → Manager → Installed, confirm comfy-pilot listed

기업 프록시 뒤에서 사용자 정의 노드 설치가 실패함

시작하기 전에 ComfyUI 프로세스 환경에서 HTTPS_PROXY를 설정하세요.

확인: env | grep -i proxy in the ComfyUI terminal

모델 다운로드가 도중에 중단됨

다운로드를 다시 실행하여 재개하세요. 파일럿은 호환 가능한 소스에 대해 중단된 부분부터 다시 시작됩니다.

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

대안

Comfy Pilot 다른 것과 비교

대안	언제 쓰나	단점/장점
comfyui-mcp-server	ComfyUI 내부 작성이 아닌 외부 MCP 클라이언트에서 워크플로를 실행하고 싶습니다.	내장된 터미널이 없습니다. 다른 표면
mcp-image	로컬 ComfyUI보다 Cloud Gemini를 선호합니다.	통제력이 떨어집니다. 이미지당 지불
everart	사전 훈련된 스타일 모델이 필요합니다.	다른 공급자

Comfy Pilot