2nd/10_Wiki/Topics/Domain_Design/Comfyui/위키 ComfyUI MCP Server - ComfyUI 2026-05-20.md

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit

id	title	category	status	verification_status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	created_at	updated_at	review_reason	merge_history	tags	raw_sources	applied_in	github_commit
comfyui-mcp-server---comfyui	ComfyUI MCP Server - ComfyUI	10_Wiki/Topics	draft	conceptual				B	0.8	2026-05-20	2026-05-20			web wikify	https://docs.comfy.org/development/cloud/mcp-server

ComfyUI MCP Server - ComfyUI

🎯 한 줄 통찰 (One-line insight)

Model Context Protocol (MCP)를 통해 AI 에이전트(Claude, Cursor 등)를 Comfy Cloud와 연결하여 로컬 GPU 없이 클라우드에서 워크플로우를 실행하고 이미지를 생성하는 서버 서비스입니다.

🧠 핵심 개념 (Core concepts)

• Model Context Protocol (MCP) 연동: AI 어시스턴트가 Comfy Cloud의 기능을 사용할 수 있도록 도구(Tools)와 리소스를 연결합니다.
• 클라우드 기반 실행: 로컬 GPU 설치 없이 클라우드 GPU를 활용하여 워크로드를 처리하며, API 키를 통해 인증합니다.
• 자동화된 워크플로우 생성: AI 에이전트가 자연어 명령을 바탕으로 ComfyUI API 형식의 JSON 워크플로우를 구성하고 실행합니다.
• Discovery & Execution: 템플릿, 모델, 노드를 검색하는 기능과 작업 제출, 파일 업로드, 상태 확인 등의 실행 도구를 제공합니다.

🧩 추출된 패턴 (Extracted patterns)

• Client-Server 구조: MCP 클라이언트(Claude Desktop, Cursor 등)가 지정된 URL(https://cloud.comfy.org/mcp)로 접속하여 기능을 호출하는 방식입니다.
• 도구 중심의 기능 분할:
  • Discovery: 검색 및 탐색 도구
  • Execution: 워크플로우 실행 및 관리 도구
  • Saved Workflows: 저장된 워크플로우 관리 도구
• 단계별 설정 프로세스: API 키 발급 \rightarrow 클라이언트 연결 설정 \rightarrow 서버 URL 및 헤더(X-API-Key) 구성 순으로 진행됩니다.

📖 세부 내용 (Details)

🛠️ Available Tools (사용 가능한 도구)

1. Discovery (탐색)

Tool	Description
search_templates	텍text, 태그, 미디어 유형 또는 모델을 통해 미리 구축된 워크플Longrightarrow 템플릿 검색
search_models	텍스트, 타입, 베이스 모델 또는 소스를 통해 모델 카탈로그 검색
search_nodes	텍스트, 카테고리 또는 입/출력 유형을 통해 사용 가능한 노드 검색

2. Execution (실행)

Tool	Description
submit_workflow	Comfy Cloud에서 실행할 ComfyUI API 형식의 워크플로우 제출
upload_file	워크플로우(예: LoadImage)에서 사용할 입력 이미지 또는 파일 업로드
get_job_status	제출된 워크플로우의 실행 상태 폴링(Polling)
get_output	완료된 워크플로우로부터 출력 이미지, 비디오 또는 오디오를 가져옴
use_previous_output	하나의 출력을 다른 것의 입력으로 재사용하여 워크플로우 체인 형성
cancel_job	대기 중이거나 실행 중인 작업 취소
get_queue	실행 중이거나 대기 중인 작업 수 확인

3. Saved Workflows (저장된 워크플로우)

Tool	Description
list_saved_workflows	Comfy Cloud에서 저장된 워크플로우 목록 탐색
get_saved_workflow	저장된 워크플릿의 노드, 입력 및 구성을 검사

🚀 Quick Start (빠른 시작)

1. API Key 발급: platform.comfy.org 접속 \rightarrow 로그인 \rightarrow + New 클릭 \rightarrow 이름 입력 \rightarrow 생성 및 즉시 저장(재확인 불가).
2. 클라이언트 연결:
   • 서버 URL: https://cloud.comfy.org/mcp
   • 설정 예시 (Claude Code):

     claude mcp add comfyui-cloud \
     --transport http \
     https://cloud.comfy.org/mcp \
     -H "X-API-Key: your-api-key-here"
     

⚠️ Known Limitations (알려진 제한 사항)

• 워크플로우 실행: 저장된 워크플로우 ID로 직접 실행 불가(브라우징만 가능). 에이전트가 처음부터 재구성해야 함.
• 메타데이터 부재: 생성된 자산에 워크플로우 JSON 메타데이터가 포함되지 않음.
• 정확도 의존성: 복잡한 노드 구성은 AI의 자연어 처리 능력에 따라 반복 작업이 필요할 수 있음.
• 인증: API Key 방식만 지원하며, OAuth는 아직 미지원.

⚖️ 모순 및 업데이트 (Contradictions & updates)

• 연구 프리뷰(Research Preview): 현재 이 프로젝트는 제한된 초기 액세스(Limited Early Access) 상태이며, 기능과 동작이 변경될 수 있습니다.

🛠️ 적용 사례 (Applied in summary)

• Example Prompts:
  • "우주를 떠다니는 우주비행사 고양이 이미지 생성 (카툰 스타일)"
  • "텍스트-비디오 생성을 위한 워크플로우 템플릿 찾기"
  • "SDXL 체크포인트 모델 검색 및 가용성 확인"

✅ 검증 상태 및 신뢰도

• 상태: draft
• 검증 단계: conceptual
• 출처 신뢰도: B (Primary Source — 웹사이트 본문 직접 추출)
• 중복 검사 결과: 신규 생성 (New discovery)

🔗 관련 문서 링크 (Related document links)

• Comfy Cloud - MCP 서버가 연결되는 대상 클라우드 인프라입니다.
• Model Context Protocol - AI 에이전트와 서버를 연결하는 표준 프로토콜입니다.
• Claude Desktop - MCP 서버를 사용할 수 있는 주요 클라이언트 중 하나입니다.
• Cursor - MCP 서버를 통해 워크플로우 실행이 가능한 AI 코드 에디터입니다.
• ComfyUI API Format - 에이전트가 생성해야 하는 워크플로우의 데이터 규격입니다.

📝 변경 이履歴 (Change history)

• 2026-05-20: Astra /wikify 로 https://docs.comfy.org/development/cloud/mcp-server 본문에서 초안 생성.