이 기능은 컴피 클라우드의 기능으로, 클라우드 버전에서만 사용할 수 있습니다. 컴피 클라우드에 대해 자세히 알아보려면 컴피 클라우드를 참조하세요.
공개 베타. Comfy Cloud MCP는 공개 베타 중입니다. API, 도구 및 동작이 변경될 수 있습니다. 문제를 신고하거나 제안을 공유하려면 피드백을 참조하세요.
개요
Comfy Cloud MCP 서버는 Model Context Protocol을 통해 AI 에이전트를 Comfy Cloud에 연결합니다. 연결 후에는 에이전트와의 채팅에서 이미지, 비디오, 오디오 및 3D를 생성하고, 모델, 노드 및 템플릿을 검색하며, ComfyUI 워크플로를 실행할 수 있습니다. 서버는cloud.comfy.org/mcp에서 원격으로 실행됩니다. 워크플로는 Comfy Cloud GPU에서 실행되므로 로컬 GPU가 필요하지 않습니다. 에이전트는 HTTPS를 통해 서버와 통신하며, 서버는 도구 호출을 대신 인증된 요청으로 변환하여 Comfy Cloud에 전송합니다.
현재 지원 범위는 Claude Code와 Claude Desktop에 국한되며, 이들은 OAuth(일회성 브라우저 로그인)를 통해 로그인합니다. 더 많은 클라이언트 지원이 곧 제공될 예정입니다.
에이전트가 할 수 있는 작업
직접 MCP 도구를 호출하지 않습니다. 에이전트가 사용자의 요청에 따라 적합한 도구를 선택합니다. 슬래시 명령어와 프롬프트(아래 참조)는 에이전트를 일반적인 작업으로 안내하는 단축키이지만, 일반 언어로도 작동합니다(“고양이 우주비행사 이미지 생성”, “이 사진 업스케일”, “Wan 2.2 비디오 템플릿 찾기”). 일반적인 흐름:- 탐색: 사용 가능한 항목 확인(
search_templates,search_models,search_nodes, 또는 그래프 스타일 질문의 경우cql). - 실행: 생성 또는 워크플로 실행(
submit_workflow, 입력 이미지가 필요한 경우upload_file사용). - 출력 가져오기: (
get_output는 에이전트가 셸에서 실행하는 다운로드 명령을 반환).
MCP 도구
연결되면 에이전트가 액세스할 수 있는 도구입니다. 이름은 MCP 클라이언트 로그 및 디버깅에 표시되는 것과 일치합니다.Discovery
| 도구 | 설명 |
|---|---|
search_templates | ��스트, 태그, 미디어 유형 또는 모델로 comfy.org의 사전 제작된 워크플로 템플릿 검색 |
search_models | 텍스트, 유형, 베이스 모델 또는 소스로 모델 카탈로그 검색 |
search_nodes | 텍스트, 카테고리 또는 입력/출력 유형으로 사용 가능한 노드 검색. 또한 서브그래프 블루프린트(예: 텍스트 → 이미지 또는 배경 제거와 같은 사전 연결된 노드 그룹)를 표시합니다. |
cql | 구조적 질문(예: 어떤 노드가 이미지를 생성하는지, 또는 노드 유형 간의 경로)을 위해 CQL 그래프 쿼리 실행. 특정 노드에 대한 전체 입력 사양이 필요한 경우 search_nodes 사용 |
Execution
| 도구 | 설명 |
|---|---|
submit_workflow | Comfy Cloud에서 실행할 ComfyUI API 형식 워크플로 제출 |
upload_file | 워크플로에서 사용할 입력 이미지 또는 파일 업로드(예: LoadImage 사용) |
get_job_status | 제출된 워크플로의 실행 상태 폴링 |
get_output | 완료된 워크플로에서 출력 이미지, 비디오 또는 오디오 검색 |
use_previous_output | 한 실행의 출력을 다른 실행의 입력으로 재사용하여 워크플로 체이닝 |
cancel_job | 대기 중 또는 실행 중인 작업 취소 |
get_queue | 실행 중 및 대기 중인 작업 수 확인 |
Saved workflows
| 도구 | 설명 |
|---|---|
list_saved_workflows | Comfy Cloud에서 저장된 워크플로 찾아보기 |
get_saved_workflow | 저장된 워크플로의 노드, 입력 및 구성 검사 |
save_workflow | 워크플로를 Comfy Cloud 계정에 저장 |
저장된 워크플로를 찾아보고 검사할 수 있지만, 현재 에이전트가 ID로 직접 실행할 수는 없습니다. 저장된 워크플로는 ComfyUI 그래프 형식을 사용하며 실행 전에 API 형식으로 변환해야 합니다. 알려진 제한 사항을 참조하세요.
Sharing workflows
| 도구 | 설명 |
|---|---|
share_workflow | 저장된 워크플로를 게시하고 누구나 열 수 있는 ?share=<id> URL 반환 |
import_shared_workflow | 공유 URL 또는 bare 공유 ID를 워크플로 JSON으로 확인하고 선택적으로 계정에 저장 |
comfy.org/workflows/<slug>-<hex> 허브 URL에서 마지막 하이픈으로 구분된 16진수 토큰이 공유 ID입니다. 예를 들어, comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7의 공유 ID는 1c77e82713b7입니다. 해당 토큰을 share_id로 import_shared_workflow에 전달하세요. share_url 매개변수는 https://cloud.comfy.org/?share=...와 같은 ?share=<id> 쿼리 URL만 허용하며 허브 페이지 URL은 허용하지 않습니다.
설치
클라이언트를 선택하세요:Claude Code
플러그인을 설치합니다. 연결과 명령이 한 번에 이루어집니다.
Claude Desktop
앱에서 사용자 정의 커넥터를 추가한 후 로그인합니다.
Claude Code
comfy-cloud 플러그인을 설치합니다. MCP 연결과 슬래시 명령이 한 번에 추가됩니다. 이 플러그인은 Comfy용 Claude Code 플러그인과 커뮤니티 에이전트 스킬을 호스팅하는 Comfy Skills 저장소를 통해 게시됩니다.
플러그인은 다음 슬래시 명령을 추가합니다:
| 명령 | 기능 |
|---|---|
/comfy-cloud:generate-image | 이미지 생성, 편집 또는 수정 |
/comfy-cloud:generate-video | 비디오 생성, 편집 또는 확장 |
/comfy-cloud:generate-audio | 오디오, 음악 또는 음향 효과 생성 |
/comfy-cloud:generate-3d | 텍스트 또는 이미지로 3D 모델 생성 |
/comfy-cloud:remove-background | 이미지에서 배경 제거 |
/comfy-cloud:upscale-image | 이미지를 더 높은 해상도로 업스케일 |
/comfy-cloud:search-templates | comfy.org에서 미리 빌드된 워크플로 템플릿 검색 |
/comfy-cloud:search-models | 사용 가능한 모델 검색 |
/comfy-cloud:search-nodes | 노드 검색 및 연결 제안 받기 |
/comfy-cloud:help | ComfyUI Cloud로 할 수 있는 작업 확인 |
플러그인 없이 연결만 선호하시나요?
플러그인 없이 연결만 선호하시나요?
서버를 직접 추가합니다:그런 다음
/mcp를 실행하고 comfy-cloud → Authenticate를 선택합니다. -s user를 추가하면 모든 프로젝트에서 사용할 수 있습니다.이 방법도 동일한 워크플로를 MCP 프롬프트로 노출합니다: /mcp__comfy-cloud__generate-image, /mcp__comfy-cloud__search-models 등 (/mcp__<name>__ 접두사는 claude mcp add에 전달한 이름을 사용합니다). 위의 플러그인이 더 친숙한 /comfy-cloud:* 명령으로 감싸 주므로 권장됩니다.Claude Desktop
Claude Desktop은 UI를 통해 Comfy Cloud를 사용자 정의 커넥터로 추가한 후 OAuth 로그인을 실행합니다.
Claude Desktop은 Claude Code 슬래시 명령을 지원하지 않습니다. 대신 동일한 워크플로를 위해 프롬프트 선택기를 엽니다:
| 프롬프트 | 설명 |
|---|---|
generate-image | 텍스트 설명에서 이미지 생성 |
generate-video | 텍스트 또는 이미지에서 비디오 생성 |
generate-audio | 오디오, 음악 또는 음향 효과 생성 |
generate-3d | 텍스트 또는 이미지에서 3D 모델 생성 |
upscale-image | 이미지를 더 높은 해상도로 업스케일 |
remove-background | 이미지에서 배경 제거 |
search-templates | 미리 빌드된 워크플로 템플릿 검색 |
search-models | 모델 검색 (체크포인트, LoRA, VAE) |
search-nodes | 노드 검색 및 연결 제안 받기 |
help | ComfyUI Cloud로 할 수 있는 작업 확인 |
헤드리스 / CI (API 키)
Claude Code와 Claude Desktop은 OAuth를 사용하므로 API 키가 필요하지 않습니다. 브라우저를 사용할 수 없는 헤드리스 또는 CI 설정의 경우 대신 API 키로 인증합니다:키 생성
platform.comfy.org/profile/api-keys로 이동하여 New API Key를 클릭하고 복사합니다(
comfyui-로 시작).출력 및 다운로드
MCP 서버는 클라우드에서 실행되며 사용자 기기에 파일을 절대 쓰지 않습니다. 생성이 완료되면 에이전트가get_output을 호출하며, 다음을 반환합니다:
- 임시 서명된 다운로드 URL(짧은 기간 동안 유효).
- 바로 실행 가능한 셸 명령(macOS 및 Linux에서는
curl, Windows에서는curl.exe).
관련 리소스
| 리소스 | 용도 |
|---|---|
| Comfy Skills | Claude Code 플러그인 마켓플레이스 및 커뮤니티 스킬 라이브러리입니다. 위에서 사용된 comfy-cloud 플러그인이 여기에 배포되어 있습니다. Comfy 워크플로를 위한 추가 스킬을 찾아보거나 기여하세요. |
| Comfy CLI | 로컬 ComfyUI 설치/실행 및 스크립트나 CI에서 호스팅된 파트너 노드를 호출하기 위한 명령줄 도구입니다 (comfy generate, 베타). 터미널 또는 자동화 워크플로가 필요할 때 MCP를 보완합니다. |
| Share a workflow on Comfy Cloud | Comfy Cloud UI에서 워크플로를 공유합니다 (MCP share_workflow 도구가 에이전트 세션에서 이 작업을 수행합니다). |
피드백
Comfy Cloud MCP는 공개 베타 버전입니다. 사용해 보시고 어떤 점이 잘 작동하고 어떤 점이 그렇지 않은지 알려주세요:- 피드백 설문: 버그를 신고하거나, 기능을 요청하거나, 일반적인 의견을 공유해 주세요.
- Discord: 질문과 토론을 위해 Comfy Discord의 #comfy-mcp-and-cli 채널을 이용해 주세요.
알려진 제한 사항
Comfy Cloud MCP는 초기 릴리스입니다. 다음 제한 사항이 알려져 있으며 현재 작업 중입니다: 워크플로- 저장된 워크플로는 ID로 실행할 수 없습니다. 에이전트는 저장된 워크플로를 나열하고 검사할 수 있지만, 실행 전에 API 형식으로 재구성하거나 변환해야 합니다.
- 생성된 에셋에 워크플로 메타데이터가 포함되지 않을 수 있습니다. MCP를 통해 생성된 이미지는 ComfyUI에서 열 때 워크플로를 다시 열지 못할 수 있습니다.
- 워크플로 구축은 에이전트의 정확성에 달려 있습니다. 복잡한 다중 노드 워크플로는 재시도 또는 개선이 필요할 수 있습니다.
- 출력은 쉘 다운로드 단계가 필요합니다. 출력 및 다운로드를 참조하세요.
- 업로드 크기 제한은 MCP 클라이언트에 따라 적용될 수 있습니다. 일부 클라이언트는 파일 업로드에 자체 제한을 부과합니다.
- OAuth 또는 API 키. Claude Code와 Claude Desktop은 일회성 브라우저 OAuth 흐름을 사용합니다. 헤드리스 클라이언트는 대신
X-API-Key헤더를 통해 Comfy Cloud API 키를 전달할 수 있습니다. 브라우저를 열 수 없는 클라이언트를 위한 장치 코드 OAuth 흐름이 계획되어 있습니다.
자주 묻는 질문
지원되는 클라이언트는 무엇인가요?
지원되는 클라이언트는 무엇인가요?
현재 Claude Code와 Claude Desktop이 지원되며, 둘 다 OAuth로 로그인합니다. 더 많은 클라이언트 지원이 곧 추가될 예정입니다.
API 키가 필요한가요?
API 키가 필요한가요?
Claude Code나 Claude Desktop���서는 필요하지 않습니다. OAuth를 사용합니다. API 키는 브라우저가 없는 헤드리스 또는 CI 환경에서만 필요합니다.
슬래시 명령이 Claude Desktop에서 작동하나요?
슬래시 명령이 Claude Desktop에서 작동하나요?
아니요. 슬래시 명령은 Claude Code 플러그인에 포함되어 있습니다. Claude Desktop은 동일한 MCP 서버에 연결됩니다(일반 언어로 요청하거나 프롬프트 선택기를 사용하면 도구가 작동합니다). 하지만 Claude Code 플러그인이나 슬래시 명령은 지원하지 않습니다.
/comfy 또는 /cloud를 입력했는데 아무것도 나타나지 않습니다.
/comfy 또는 /cloud를 입력했는데 아무것도 나타나지 않습니다.
/comfy 또는 /cloud 명령은 없습니다. 명령은 연결 방식에 따라 두 가지 접두사 중 하나로 나타납니다:- 플러그인 (권장):
/comfy-cloud:generate-image,/comfy-cloud:generate-video, … : 전체를 보려면/comfy-cloud:를 입력하세요. - 직접 연결 (플러그인 없음):
/mcp__comfy-cloud__generate-image, … : 보려면/mcp__를 입력하세요.
로그인 시 브라우저가 열리지 않았습니다.
로그인 시 브라우저가 열리지 않았습니다.
Claude Code에서
/mcp를 실행하고 comfy-cloud를 선택한 다음 인증을 선택하세요. Claude Desktop에서는 사용자 정의 → 커넥터에서 커넥터를 다시 열고 로그인을 트리거하세요.에이전트로 Comfy를 로컬에서 실행하는 것은 어떻습니까?
에이전트로 Comfy를 로컬에서 실행하는 것은 어떻습니까?
Comfy Cloud MCP는 저희가 호스팅하는 서비스이지만, 로컬 에이전트 워크플로는 ComfyUI가 오픈소스화된 이후로 존재해 왔습니다. Agent Tools 개요에서 로컬 ComfyUI는 어떻습니까?를 참조하여 클라우드가 먼저 출시된 이유, 현재 사용할 수 있는 커뮤니티 MCP 서버, 그리고 또 다른 옵션으로 Comfy CLI를 확인하세요.