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

# [[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](https://platform.comfy.org/login) 접속 $\rightarrow$ 로그인 $\rightarrow$ `+ New` 클릭 $\rightarrow$ 이름 입력 $\rightarrow$ 생성 및 즉시 저장(재확인 불가).
2.  **클라이언트 연결**: 
    *   서버 URL: `https://cloud.comfy.org/mcp`
    *   설정 예시 (Claude Code):
        ```bash
        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 본문에서 초안 생성.