Comfy Cloud MCP

​

개요

​

Comfy Cloud MCP 설치

https://cloud.comfy.org/mcp

• Claude Desktop
• Claude Code
• Cursor
• Codex
• OpenClaw
• 기타 클라이언트

Claude Desktop은 Comfy Cloud를 UI를 통해 사용자 지정 커넥터로 추가한 다음 OAuth 로그인을 실행합니다.

1

사용자 정의 열기

사이드바에서 Customize(1로 표시)를 클릭하세요.

2

커넥터 열기

Connectors(2로 표시)를 클릭하세요.

3

사용자 지정 커넥터 추가

1. 커넥터 헤더에서 + 버튼(3으로 표시)을 클릭하세요.
2. Add custom connector(4로 표시)를 선택하세요.

4

서버 세부 정보 입력

1. Name 필드(5로 표시)에 Comfy Cloud MCP와 같은 이름을 입력하세요.
2. Remote MCP server URL을 https://cloud.comfy.org/mcp로 설정하세요(6으로 표시).
3. Add(7로 표시)를 클릭하세요.

5

로그인

1. 브라우저가 열리면 워크스페이스(예: Personal Workspace)를 선택하세요.
2. Continue를 클릭하여 커넥터를 승인합니다. 연결됩니다.

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로 할 수 있는 작업 확인

프롬프트를 건너뛰고 일반 언어로 요청할 수도 있습니다. MCP 도구는 동일하게 작동합니다.

comfy-cloud 플러그인을 설치하세요. 이 플러그인은 MCP 연결과 슬래시 명령어를 한 번에 추가합니다. 이 플러그인은 Comfy의 Claude Code 플러그인과 커뮤니티 에이전트 스킬을 호스팅하는 Comfy Skills 저장소를 통해 게시됩니다.

1

마켓플레이스 추가

Comfy Skills 마켓플레이스를 등록합니다(한 번만 수행):

/plugin marketplace add Comfy-Org/comfy-skills

2

플러그인 설치

/plugin install comfy-cloud@comfy-skills

3

로그인

/mcp를 실행하고 comfy-cloud → Authenticate를 선택하세요. 브라우저가 열려 로그인하고 토큰은 자동으로 새로 고쳐집니다.

플러그인은 다음 슬래시 명령어를 추가합니다:

명령어	설명
/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로 할 수 있는 작업 확인

플러그인 없이 연결만 원하시나요?

서버를 직접 추가하세요:

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp

그런 다음 /mcp를 실행하고 comfy-cloud → Authenticate를 선택하세요. -s user를 추가하면 모든 프로젝트에서 사용할 수 있습니다.이 방법도 MCP 프롬프트로 동일한 워크플로를 제공합니다: /mcp__comfy-cloud__generate-image, /mcp__comfy-cloud__search-models 등(/mcp__<이름>__ 접두사는 claude mcp add에 전달한 이름을 사용합니다). 위 플러그인은 이를 더 친숙한 /comfy-cloud:* 명령어로 래핑하므로 권장됩니다.

Cursor는 원격 MCP 서버에 HTTP로 연결됩니다. Cursor는 현재 MCP OAuth를 지원하지 않습니다. MCP 구성에 Comfy Cloud API 키를 사용하여 Comfy Cloud를 추가하세요.

1

Cursor 설정 열기

오른쪽 상단의 Settings 기어(1로 표시)를 클릭하세요.

2

Tools & MCP 열기

1. 사이드바에서 Tools & MCPs(2로 표시)를 클릭하세요.
2. + New MCP Server(3으로 표시) → Add a Custom MCP Server를 클릭하세요.

3

API 키 추가

~/.cursor/mcp.json(전역) 또는 .cursor/mcp.json(프로젝트)을 편집하세요. 서버 URL을 설정하고 X-API-Key 헤더에 Comfy Cloud API 키를 전달하세요. 키는 platform.comfy.org/profile/api-keys에서 생성하세요(comfyui-로 시작):

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "${env:COMFY_API_KEY}"
      }
    }
  }
}

COMFY_API_KEY를 셸 또는 시스템 환경에 설정하세요. Git에 커밋할 수 있는 파일에 키를 하드코딩하는 대신 ${env:COMFY_API_KEY}를 사용하는 것이 좋습니다.

4

생성 시작

일반 언어로 요청하세요(“고양이 우주비행사 이미지 생성”, “Wan 2.2 비디오 템플릿 찾기”). Cursor가 대신 MCP 도구를 호출합니다.

Codex는 Streamable HTTP를 통해 Comfy Cloud에 연결합니다. 설정에서 서버를 추가한 다음 OAuth로 로그인하세요.

1

설정 패널 열기

1. Logged in with API key 아래에서 Settings(1로 표시)를 클릭하세요.
2. Settings(2로 표시)를 클릭하여 전체 설정 패널을 엽니다.

2

MCP 서버 설정 열기

1. 설정 목록에서 MCP servers(3으로 표시)를 클릭하세요.
2. + Add server(4로 표시)를 클릭하여 새 MCP 서버를 추가합니다.

3

Comfy Cloud에 연결

1. 연결 유형으로 Streamable HTTP를 선택하세요.
2. Name 필드(5로 표시)에 Comfy Cloud MCP와 같은 이름을 입력하세요.
3. URL 필드(6으로 표시)에 https://cloud.comfy.org/mcp를 입력하세요.
4. Save(7로 표시)를 클릭하세요.

4

인증

1. 저장된 서버 항목에서 Authenticate(8로 표시)를 클릭하세요.
2. 브라우저 팝업에서 워크스페이스를 선택하고 Continue를 클릭하여 로그인을 완료하세요. 연결됩니다.

일반 언어로 요청하세요(“고양이 우주비행사 이미지 생성”, “Wan 2.2 비디오 템플릿 찾기”). Codex가 대신 MCP 도구를 호출합니다.

CLI를 선호하시나요?

터미널에서 등록 및 로그인:

codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp
codex mcp login comfy-cloud

이렇게 하면 ~/.codex/config.toml(또는 신뢰할 수 있는 프로젝트의 .codex/config.toml)에 항목이 기록됩니다.

OAuth 대신 API 키 사용(헤드리스 또는 CI)

브라우저를 사용할 수 없는 경우 환경 변수에서 가져온 헤더로 서버를 추가하세요. platform.comfy.org/profile/api-keys에서 키를 생성하세요(comfyui-로 시작). 그런 다음 ~/.codex/config.toml에 추가:

[mcp_servers.comfy-cloud]
url = "https://cloud.comfy.org/mcp"
env_http_headers = { "X-API-Key" = "COMFY_API_KEY" }

COMFY_API_KEY를 셸 또는 시스템 환경에 설정하세요. 키를 버전 관리에 커밋하지 마세요.

ClawHub에서 Comfy Cloud 스킬을 설치하세요. OpenClaw를 호스팅된 MCP 서버(cloud.comfy.org/mcp)에 연결합니다. Cloud 전용이며, 로컬 ComfyUI 설치를 구동하지 않습니다.

1

스킬 설치

openclaw skills install @comfy-org/comfy

스킬 페이지: clawhub.ai/comfy-org/skills/comfy.

2

OAuth로 연결 (권장)

MCP 서버를 등록하고 Comfy 계정으로 로그인합니다:

openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login comfy
openclaw gateway restart

openclaw mcp login이 인증 URL을 출력합니다. URL을 열고 로그인한 뒤 CLI 안내에 따라 흐름을 완료하세요(--code 값으로 다시 실행하라고 할 수 있음). openclaw mcp status --verbose로 확인합니다.

auth: "oauth"가 설정되면 OpenClaw는 해당 서버 항목의 정적 headers를 무시합니다. OAuth와 하드코딩된 API 키 헤더를 함께 쓰지 마세요.

3

생성 시작

일반 언어로 요청하세요(“고양이 우주비행사 이미지 생성”, “Wan 2.2 비디오 템플릿 찾기”). OpenClaw가 대신 MCP 도구를 호출합니다.

OAuth 대신 API 키 사용 (헤드리스 또는 CI)

platform.comfy.org/profile/api-keys에서 키를 생성하세요(comfyui-로 시작). 내보낸 뒤 서버를 등록합니다:

export COMFY_API_KEY="comfyui-..."
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${COMFY_API_KEY}"}}'
openclaw gateway restart

OpenClaw에서는 커스텀 X-API-Key 헤더보다 Authorization: Bearer를 권장합니다. 일부 OpenClaw 빌드는 streamable-http 전송에서 커스텀 헤더를 드롭할 수 있으며, Bearer가 프록시를 더 안정적으로 통과합니다. COMFY_API_KEY는 셸 프로필 또는 OpenClaw 환경에 두세요. 키를 커밋하지 마세요.

원격 HTTP 전송을 지원하는 모든 MCP 클라이언트는 Comfy Cloud에 연결할 수 있습니다. 서버 URL은 항상 https://cloud.comfy.org/mcp입니다.

1

서버 URL 추가

https://cloud.comfy.org/mcp를 가리키는 원격 MCP 항목을 추가하세요. 대부분의 클라이언트는 url 필드가 있는 JSON 구성을 사용합니다:

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp"
    }
  }
}

Windsurf는 url 대신 serverUrl을 사용합니다. Amp는 Settings → MCP Servers 또는 ~/.config/amp/settings.json에서 동일한 mcpServers 형식을 사용합니다.

2

인증

클라이언트가 MCP OAuth를 지원하는 경우 브라우저에서 로그인하라는 메시지가 표시됩니다. 그렇지 않으면 API 키 헤더를 추가하세요(아래 참조).

3

재시작 및 확인

클라이언트를 재시작하세요. comfy-cloud 서버 아래에 Comfy Cloud 도구(search_templates, submit_workflow, get_output 등)가 등록된 것을 확인할 수 있습니다.

헤드리스 / CI (API 키): OAuth를 사용할 수 없는 경우 platform.comfy.org/profile/api-keys에서 키를 생성하고 X-API-Key 헤더로 전달하세요:

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "comfyui-…"
      }
    }
  }
}

터미널에서 Claude Code의 경우:

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"

Git에 커밋하는 구성 파일에 키를 하드코딩하는 대신 ${env:COMFY_API_KEY} 또는 클라이언트의 비밀 변수 보간을 사용하는 것이 좋습니다.

​

에이전트가 할 수 있는 작업

1. 검색: 사용 가능한 항목 확인 (search_templates, search_models, search_nodes 또는 그래프 스타일 질문의 경우 cql).
2. 실행: 생성 실행 — 일치하는 사전 제작된 템플릿의 경우 run_template, 사용자 정의 워크플로의 경우 submit_workflow (입력 이미지가 필요한 경우 upload_file 사용), 또는 파트너 모델(Flux, Grok, Gemini, OpenAI, Ideogram, Seedance 등)의 경우 partner_generate.
3. 대기 및 출력 검색: wait_for_job을 호출한 후 get_output이 에이전트가 셸에서 실행할 다운로드 명령을 반환.

​

MCP 도구

​

탐색

​

생성

​

작업 및 배치

​

저장된 워크플로

​

워크플로 공유

​

앱 및 링크

​

계정 및 세션

​

크레딧 및 사용

​

출력 및 다운로드

1. 임시 서명된 다운로드 URL(짧은 기간 동안 유효).
2. 바로 실행 가능한 셸 명령(macOS 및 Linux에서는 curl, Windows에서는 curl.exe).

​

관련 리소스

​

관련: Comfy In-App Agent

​

피드백

• 피드백 설문: 버그를 신고하거나, 기능을 요청하거나, 일반적인 의견을 공유해 주세요.
• Discord: 질문과 토론을 위해 Comfy Discord의 #comfy-mcp-and-cli 채널을 이용해 주세요.

​

알려진 제한 사항

• 에디터 형식에서 실행 가능한 형식으로의 변환에는 아직 미흡한 부분이 있습니다. 저장된 워크플로는 run_saved_workflow를 통해 파일 이름으로 실행되지만(서버가 자동으로 변환), 일부 노드 구성은 여전히 불완전하게 변환됩니다.
• submit_workflow로 생성된 에셋에는 워크플로 메타데이터가 포함되지 않을 수 있습니다. ComfyUI에서 열 때 원본 워크플로를 다시 열지 못할 수 있습니다.
• 워크플로 구축은 에이전트의 정확성에 달려 있습니다. 복잡한 다중 노드 워크플로는 재시도 또는 개선이 필요할 수 있습니다.

• 출력은 쉘 다운로드 단계가 필요합니다. 출력 및 다운로드를 참조하세요.
• 업로드 크기 제한은 MCP 클라이언트에 따라 적용될 수 있습니다. 일부 클라이언트는 파일 업로드에 자체 제한을 부과합니다.

• OAuth 또는 API 키. Claude Code와 Claude Desktop은 일회성 브라우저 OAuth 흐름을 사용합니다. Cursor는 MCP 구성에 Comfy Cloud API 키가 필요합니다(OAuth 없음). 다른 헤드리스 클라이언트는 대신 X-API-Key 헤더를 통해 Comfy Cloud API 키를 전달할 수 있습니다. 브라우저를 열 수 없는 클라이언트를 위한 장치 코드 OAuth 흐름이 계획되어 있습니다.

​

자주 묻는 질문