Skip to main content
이제 Comfy Registry에 등록되었습니다. ComfyUI-Manager에서 ComfyUI Agent Panel (comfyui-agent-panel)을 설치하거나, 최신 빌드를 원한다면 git으로 설치하세요 (아래 설정 참고).
**comfyui-mcp-panel**은 ComfyUI 사이드바에 자율 에이전트를 심어 넣습니다. 이미지, 워크플로우, 변경 사항을 요청하면 실제 ComfyUI를 대상으로 작업하고 그 자리에서 답합니다. 제공자를 선택하면 — Claude, ChatGPT, Gemini, 또는 Ollama(로컬) 중에서 — 해당 에이전트가 백그라운드에서 실행됩니다: 구독 제공자는 API 키가 필요 없고, 로컬 모델은 계정 자체가 필요 없습니다(Ollama 백엔드는 호스팅된 OpenAI 호환 엔드포인트에도 접속할 수 있습니다). 매트릭스는 백엔드를, 각 모델 등급이 실제로 어떻게 동작하는지는 LLM 아레나를 참고하세요.
구독 제공자는 API 키도, 토큰당 과금도 없으며 — 로컬 모델은 완전히 무료·오프라인으로 동작합니다. 에이전트는 디스크에 저장된 로그인 정보로 인증합니다(Ollama의 경우 그냥 로컬 데몬과 통신합니다). 오케스트레이터 하나가 루프백 브리지 포트 하나 (ws://127.0.0.1:9199)에서 모든 제공자를 서비스하며, 각 패널 탭은 핸드셰이크 시점에 자신의 제공자를 선택합니다. 브리지는 루프백 전용이며, 패널은 그래프 명령의 고정 허용 목록만 실행합니다(임의의 JavaScript는 실행하지 않습니다).
처음이신가요? 백엔드 / 제공자에서 선택 UI, 제공자에 중립적인 AgentBackend 포트, 기능 매트릭스(Claude와 ChatGPT 사이에서 동일한 부분과 다른 몇 가지 차이)를 설명합니다.

​
설정

  1. 팩 설치 — ComfyUI-Manager에서 comfyui-agent-panel을 검색하거나, git으로 설치하세요:
    Manager의 버전 드롭다운에서는 Nightly가 아니라 Latest를 선택하세요. 이름과 달리 Manager의 Nightly는 매일 밤 빌드되지 않습니다: 설치 시점에 저장소를 한 번만 복제한 뒤 그 브랜치를 다시는 추적하지 않습니다. 그날 main이었던 커밋에 그대로 고정되는 반면 Latest는 릴리스마다 함께 갱신됩니다 — 그래서 Nightly는 보통 Latest보다 더 오래된 상태이며, 방치할수록 조용히 더 뒤처집니다. 업데이트가 없다고 표시되는 이유는, Nightly 입장에서는 실제로 업데이트가 없기 때문입니다.실제로 어느 지점에 있는지 확인하려면 Node Pack Info → Version의 SHA를 저장소 커밋 기록과 비교하세요. 벗어나려면 같은 드롭다운에서 Latest (x.y.z)를 선택하거나 — git으로 유지하고 싶다면 — custom_nodes/comfyui-mcp-panel에서 git pull을 실행하세요. 깔끔하게 fast-forward됩니다.
  2. 백그라운드 에이전트가 사용자의 구독을 쓸 수 있도록, 원하는 제공자에 한 번 로그인하세요:
  3. 자신의 컴퓨터에서 오케스트레이터를 시작하고 계속 실행해 두세요 — 자세한 내용은 패널 오케스트레이터 시작하기를 참고하세요:
  4. ComfyUI를 재시작하고 에이전트 탭을 연 다음 제공자를 선택하고(Claude / ChatGPT 칩), 연결을 클릭하세요. 패널이 오케스트레이터의 루프백 브리지에 연결됩니다. 요청을 입력하면 에이전트가 응답합니다. 연결 해제를 누르면 연결이 끊기지만, 오케스트레이터는 사용자가 멈출 때까지 계속 실행됩니다.
claude mcp add도, API 키도 필요 없습니다. 패널은 순수 프런트엔드 확장 기능이라 오케스트레이터를 직접 실행할 수 없으므로, 오케스트레이터는 언제나 사용자가 직접 시작하는 프로세스입니다 — 패널은 이미 실행 중인 브리지에 자동으로 연결할 뿐입니다. 필요 조건은 PATH에 있는 Node.js/npx와 위에서 설명한 제공자 로그인뿐입니다. 브리지 포트는 COMFYUI_MCP_BRIDGE_PORT로 바꿀 수 있습니다.
원격 ComfyUI를 다루시나요?(클라우드 GPU 파드, LAN의 다른 컴퓨터 등) 위 설정 과정은 그대로 적용되지만, 오케스트레이터는 원격 컴퓨터가 아니라 자신의 컴퓨터에서 실행하세요: npx -y comfyui-mcp@latest connect <remote-url>을 실행하면 파드의 HTTPS 페이지로 이어지는 보안 터널을 포함해 나머지를 알아서 처리합니다. 그런 다음 패널에서 연결을 클릭하세요. 전체 절차는 클라우드 배포를 참고하세요.
제공자 온보딩. 연결 시점에 패널은 각 제공자의 준비 상태를 확인합니다(PATH에 CLI가 있는지 + 디스크에 로그인 정보가 있는지 — macOS 키체인도 함께 처리됩니다). 온보딩 카드는 어느 제공자도 로그인되어 있지 않을 때만 나타납니다. 저장된 선택이 사용할 수 없는 상태라면 패널이 준비된 제공자로 자동 전환하며(저장된 선호는 유지됩니다), 준비되지 않은 제공자의 행에는 일회성 claude / codex login 단계를 시작해 주는 “설정” 작업이 표시됩니다. 자세한 내용은 백엔드 → 준비 상태 및 온보딩을 참고하세요.

​
할 수 있는 일

에이전트(Claude 또는 ChatGPT)는 comfyui-mcp의 모델 스킬(IDEOGRAM, WAN, LTX, Qwen 등)을 불러오므로, 사용자가 다루는 모델을 이미 알고 있습니다 — Claude는 네이티브로, ChatGPT는 같은 지식을 MCP 도구로 노출한 형태로 이용합니다 (지식 동등성). 이미지·동영상·오디오를 생성하고, ComfyUI를 살펴보고 관리하고, 사용자의 설정에 대해 추론한 다음 패널 채팅으로 답할 수 있습니다. 또한 워크플로우나 설치 팩 전체를 한 번에 불러올 수 있고 (panel_load_workflow pack:<name>) 비용을 고려합니다: 번들 팩은 로컬 GPU / 무료이며, 즉석에서 만든 그래프의 경우 에이전트가 런타임을 확인하고(list_packs에 action:"check_runtime") 유료 API 크레딧을 쓰기 전에 먼저 물어봅니다. 자세한 내용은 스킬, 팩 & 런타임 비용을 참고하세요.

​
실시간 그래프 조작

자율 에이전트는 panel_* 명령의 고정 허용 목록을 통해 실제 ComfyUI를 조작합니다 — 임의의 JavaScript는 실행하지 않습니다. 모든 그래프 변경은 LiteGraph의 변경 추적을 거치므로 Ctrl+Z로 되돌릴 수 있습니다. 동일한 panel_* 표면이 두 백엔드에 똑같이 노출되므로(Claude는 인프로세스, ChatGPT/Codex는 루프백 HTTP MCP를 통해) 패리티가 자동으로 유지됩니다.

​
읽기

​
그래프 편집 (되돌리기 가능)

​
서브그래프

​
공간 배치

에이전트는 노드의 기하 정보를 볼 수 있습니다 — panel_query_graph의 상세 행은 각 노드의 pos/size, 서브그래프 입출력 rails, groups, 노드별 color/collapsed 값을 반환하며, 이에 대응하는 쓰기 작업으로 캔버스를 배치한 다음 결과를 스크린샷으로 찍어 자신의 레이아웃을 스스로 판단합니다. workflow-layout 스킬은 이를 의존성 기반 계층형 배치와 겹침 없는 자동 레이아웃으로 엮어내며, 그 핵심 규칙은 입력과 출력을 항상 드러내 두어 바로 이어서 작업할 수 있게 하는 것입니다.

​
워크플로우 탭

​
워크플로우를 한 번에 불러오기

​
지식 및 비용 인식

에이전트는 번들로 포함된 전문 지식을 찾아내고, 크레딧을 쓰기 전에 런타임 비용을 확인합니다(두 백엔드 모두 동일한 도구 사용 — 자세한 내용은 스킬, 팩 & 런타임 비용 참고):

​
실행 및 보기

​
커스텀 노드 (내장 ComfyUI Manager)

​
MCP 및 세션

​
사용자와 상호작용

모든 도구는 선택적으로 tab_id를 받습니다 — 각 브라우저 탭이 각자의 연결을 가지며, 라우팅은 기본적으로 유일한 탭이나 사용자가 마지막으로 입력한 탭을 대상으로 합니다.

​
되감기 및 롤백

지난 메시지는 고정되어 있지 않습니다. 아무 메시지에나 마우스를 올리면 나타나는 ✎ 편집 버튼을 누르면 롤백 모달이 열립니다: 코드를 롤백(그래프를 해당 턴의 스냅숏으로 되돌림)하거나, 대화를 롤백(세션을 그 지점으로 포크)하거나, 둘 다 롤백한 다음 그 지점부터 수정한 메시지를 다시 보낼 수 있습니다. 그래프 되돌리기는 턴별 스냅숏을 사용하므로, 한 턴을 되돌리면 그 턴이 시작된 시점의 그래프가 정확히 복원됩니다. 흔한 경우는 단축키 두 가지로 처리됩니다:
  • /revert — 마지막 턴의 그래프 편집을 되돌립니다.
  • Esc 두 번 — 마지막 턴을 빠르게 되감습니다: 그래프를 되돌리고 메시지를 입력창으로 불러와 수정한 뒤 다시 보낼 수 있습니다.
코드(그래프) 롤백은 두 제공자 모두에서 동작합니다 — 오케스트레이터 안의 턴별 스냅숏으로 구현되어 있습니다. 대화 롤백(과거 턴으로 채팅을 포크하는 것)은 현재 Claude 전용입니다. ChatGPT/Codex 백엔드는 스레드 전체만 재개할 수 있어 패널이 이 범위를 막아 둡니다. 자세한 내용은 기능 매트릭스를 참고하세요.

​
대기 메시지 트레이

에이전트가 바쁠 때 입력해도 메시지가 채팅 속에 묻히지 않습니다 — 다운로드 트레이 위에 고정된 대기(Pending) 트레이에 채팅 흐름과 별도로 대기합니다. 대기 중인 메시지마다 편집, 즉시 전송, 삭제 버튼과, 에이전트가 메시지를 처리하는 순서를 재정렬할 수 있는 끌기 핸들(≡, 왼쪽)이 있습니다. 즉시 전송은 현재 턴을 중단시켜 바로 방향을 바꿉니다. 대기 중인 메시지가 큐에서 빠지면 채팅 맨 아래에 나타나므로, 전체 기록이 에이전트(Claude 또는 ChatGPT)가 실제로 처리한 순서 그대로 읽힙니다.

​
파괴적 작업 확인

되돌릴 수 없는 작업은 먼저 확인을 구합니다. panel_clear(모든 노드 삭제)와 panel_restart_comfyui는 예/아니오 카드를 띄우고 예를 눌러야만 실행됩니다 — 에이전트가 그래프를 조용히 날려버리거나 ComfyUI를 재시작할 수 없습니다.

​
재연결 내구성

멈춰버린(wedged) 오케스트레이터가 더 이상 패널을 고립시키지 않습니다. 이전 오케스트레이터가 여전히 브리지 포트를 붙잡고 있어도, 연결을 누르면 실패하는 대신 그 좀비 프로세스를 회수합니다 — 막히는 대신 패널이 다시 연결됩니다.

​
입력창 첨부 파일

입력창에 첨부하거나, 끌어다 놓거나, 붙여넣을 수 있습니다. 이미지뿐 아니라 입력창은 이제 동영상, 워크플로우 .json, 텍스트 파일도 받아들이므로, 참고할 영상 클립이나 손볼 워크플로우, 메모 파일을 에이전트에게 바로 건넬 수 있습니다.

​
에이전트 답변 속 풍부한 미디어

실행 결과 미디어가 에이전트에게 다시 전달될 때, 출력은 단순한 이미지 블록이 아니라 에이전트가 추론할 수 있는 메타데이터를 함께 담고 있습니다: 각 출력의 경로 (하위 폴더 기준 상대 경로), 파일 크기, 픽셀 크기, 그리고 에셋 세트 묶음 정보 (이번 실행에서 나온 “N개 중 K번째 출력”과 형제 파일명들, 또는 “단일 출력”), 여기에 렌더링 소요 시간과 완료 시각까지 포함됩니다. 동영상 스토리보드는 페이로드에 포맷과 실제 프레임 수/fps가 담겨 있으면 이를 함께 추가합니다. 그 덕분에 에이전트는 실제로 저장된 결과물을 정확히 지칭하고, 크기·해상도·이번 실행에서 생성된 파일 개수까지 이야기할 수 있습니다.

​
코드 블록 복사 및 줄바꿈

렌더링된 코드 블록에는 마우스를 올리면 나타나는 복사 버튼과, 전역으로 저장되는 줄바꿈 토글이 있습니다(기본값은 꺼짐 — 켜기 전까지 긴 줄은 가로로 스크롤됩니다). 인라인 코드에도 각자 복사 버튼이 있습니다. 둘 다 패널 디자인에 맞춘 스타일을 사용합니다.

​
렌더 정체 경고

오케스트레이터는 ComfyUI 대기열을 수동적으로 감시하는 워치독을 실행합니다: 노드/진행률이 더 이상 나아가지 않는 렌더는 정체됨으로 표시되고 에이전트에게 알려집니다(그래서 막힌 작업 뒤에 무작정 작업을 계속 쌓지 않습니다). 임계값은 설정 → Comfy MCP 에이전트 → 일반의 렌더 정체 경고 (초) 설정입니다(기본값 180초, 범위 15–3600). 이 값은 연결 시점에 전송되고 실시간으로 반영되므로 — 값을 바꿔도 다시 연결할 필요가 없습니다. 자세한 내용은 설정 → COMFYUI_MCP_STALL_S를 참고하세요.

​
백그라운드 탭 안정성

ComfyUI 탭이 백그라운드에 있어도 스트리밍 답변이 이제 정상적으로 렌더링됩니다. 이전에는 답변의 타자기 효과가 requestAnimationFrame으로 동작했는데, 브라우저는 숨겨진 탭에서 이를 멈추기 때문에 — 여러 단계로 이어지는 긴 실행 도중 탭을 전환하면 말풍선이 비어 있는 채로 스트리밍 커서만 멈춰 있어, 턴이 이미 끝났는데도 에이전트가 “생각하다 멈춘” 것처럼 보였습니다. 이제 탭이 숨겨지면 답변이 즉시 동기적으로 마무리되며, visibilitychange 핸들러가 탭이 숨겨질 때 대기 중인 답변을 모두 내보내고 탭으로 돌아오면 타자기 효과를 다시 시작합니다. 전면(foreground)에서의 애니메이션은 그대로입니다.

​
RunPod 클라우드 제어

툴바의 호스트 표시에는 🟢 로컬 · 사용자의 장비 또는 **🔵 RunPod · <pod> · GPU · /hr∗∗이표시되며,클릭하면∗∗RunPod제어판∗∗이열립니다:실시간상태카드(GPU/VRAM/가동시간//hr**이 표시되며, 클릭하면 **RunPod 제어판**이 열립니다: 실시간 상태 카드 (GPU / VRAM / 가동 시간 / ·hr / ComfyUI URL / 유휴 자동 정지 카운트다운), 파드를 이름으로 나열하는 드롭다운, 연결 / 시작 / 정지 / 로컬 사용, 그리고 확인이 필요한 배포 버튼이 있습니다. API 키 카드에서 RUNPOD_API_KEY를 한 번만 설정해 두면 RunPod 콘솔을 건드리지 않고도 배포·모니터링·로컬⇄파드 전환·클라우드 GPU 정지까지 할 수 있습니다 — 호스트 표시는 항상 다음 렌더가 어디서 실행될지 알려줍니다. 자세한 내용은 클라우드 배포와 블로그 글 임대한 클라우드 GPU에서 ComfyUI 실행하기를 참고하세요.

​
CivitAI 브라우저

툴바의 Civitai 버튼을 누르면 CivitAI 브라우저 전체가 열립니다 — 이미지, 동영상, 체크포인트, LoRA, 워크플로우를 검색·필터링하고 전체 화면 뷰어로 볼 수 있습니다. 결과를 골라 에이전트와 공유하거나, 컴퓨터로 다운로드하거나, 포함된 워크플로우를 캔버스에 저장할 수 있습니다. 자세한 이야기: ComfyUI 속 CivitAI.

​
참고