Comfy MCP: AI 에이전트를 ComfyUI에 연결

​

개요

​

어떤 연결을 선택해야 하나요?

​

Comfy Cloud MCP 연결

​

클라우드 연결 설정

https://cloud.comfy.org/mcp

• Claude Desktop
• Claude Code
• Cursor
• Codex
• OpenClaw
• Other clients

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

1

Customize 열기

사이드바에서 Customize(라벨 1)를 클릭하세요.

2

Connectors 열기

Connectors(라벨 2)를 클릭하세요.

3

사용자 정의 커넥터 추가

1. Connectors 헤더에서 + 버튼(라벨 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를 클릭하여 커넥터를 승인하세요. 연결되었습니다.

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

1

마켓플레이스 추가

Comfy Skills 마켓플레이스를 등록합니다(최초 1회):

/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__<name>__ 접두사는 claude mcp add에 전달한 이름을 사용합니다). 위 플러그인이 권장되는 이유는 이러한 명령을 더 친근한 /comfy-cloud:* 명령으로 감싸기 때문입니다.

Cursor는 HTTP를 통해 원격 MCP 서버에 연결합니다. Cursor는 현재 MCP OAuth를 지원하지 않습니다. MCP 구성에 Comfy Cloud API 키와 함께 Comfy Cloud를 추가하세요.

1

Cursor Settings 열기

오른쪽 위 모서리의 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에 연결됩니다. Settings에서 서버를 추가한 후 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 URL을 입력합니다.
4. Save(라벨 7)를 클릭합니다.

4

Authenticate

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)에 연결합니다. 클라우드 전용이며, 로컬 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

Authenticate

클라이언트가 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} 또는 클라이언트의 비밀 보간(interpolation)을 사용하는 것이 좋습니다.

​

에이전트로 할 수 있는 일

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).

​

알려진 제한 사항

• submit_workflow를 통해 생성된 에셋에는 워크플로 메타데이터가 포함되지 않을 수 있습니다. ComfyUI에서 열 때 원래 워크플로가 다시 열리지 않을 수 있습니다.
• 워크플로 빌드는 에이전트의 정확도에 따라 달라집니다. 복잡한 다중 노드 워크플로는 재시도나 수정이 필요할 수 있습니다.

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

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

​

로컬 Comfy MCP 연결

​

요구 사항

• Python 3.10+
• PATH에 있는 comfy-cli(pip install comfy-cli). 모든 도구가 래핑하는 엔진입니다.
• ComfyUI 워크스페이스. 없으면 comfy install로 생성하세요(기존 체크아웃은 comfy set-default <path>로 사용 가능).
• 실행 도구용 ComfyUI가 실행 중이어야 합니다. comfy launch로 시작하거나 launch_comfyui를 호출하세요. 서버는 ComfyUI를 암시적으로 시작하지 않습니다.

​

설치

pip install comfy-mcp

​

수동 구성

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

{
  "mcpServers": {
    "comfy-mcp": {
      "command": "comfy-mcp",
      "env": { "COMFY_BIN": "/path/to/venv/bin/comfy" }
    }
  }
}

​

빠른 시작

git clone https://github.com/Comfy-Org/comfy-mcp
cd comfy-mcp
pip install "comfy-cli>=1.14.0"  # 엔진
comfy install             # ComfyUI 워크스페이스 생성 (이미 있으면 생략)
pip install comfy-mcp            # 이 MCP 서버 → `comfy-mcp` 명령

comfy launch

​

도구

​

관련 리소스

​

관련 항목: Comfy 인앱 에이전트

​

피드백

• 피드백 설문조사: 버그 신고, 기능 요청 또는 일반적인 소감을 공유하세요.
• Discord: Comfy Discord의 #comfy-mcp-and-cli에서 문의 및 토론하세요.

​

FAQ

​

시작하기

​

비용과 접근

​

사용하기

​

트러블슈팅