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를 설정하세요. 키를 버전 관리에 커밋하지 마세요.

Codex가 계속 다시 로그인하라고 요청함(invalid_grant 또는 리프레시 토큰 재사용)

증상: Codex가 Comfy Cloud에서 로그아웃되고 반복해서 재인증을 요청하며, 몇 분마다 발생하기도 합니다. Codex 경고나 로그에 invalid_grant, 이미 사용되었거나 폐기된 리프레시 토큰, OAuth 토큰 갱신 실패 등이 표시될 수 있습니다.원인: 이 문제는 Comfy Cloud가 아니라 Codex가 MCP OAuth 자격 증명을 저장하고 갱신하는 방식에서 비롯됩니다. 여러 Codex 프로세스(TUI 세션, 앱 서버, codex mcp 명령)가 하나의 OAuth 서버를 공유하면, 한 프로세스가 다른 프로세스에서 이미 교체한 토큰으로 갱신을 시도할 수 있습니다. 인증 서버는 이를 토큰 재사용으로 간주하고 세션을 종료합니다. 다른 OAuth MCP 서버 사용자들도 같은 현상을 보고하고 있습니다. 아래 이슈는 Codex 저장소에서 아직 열려 있으므로 현재 상태를 직접 확인할 수 있습니다.

• openai/codex#46028: 오래 실행되는 클라이언트가 교체된 리프레시 토큰을 재사용함
• openai/codex#48507: 동시 프로세스가 리프레시 토큰 교체에서 경합하여 다음 시작 시 invalid_grant 발생
• openai/codex#41133: 종료 시 교체된 리프레시 토큰이 유실될 수 있음
• openai/codex#17265: Codex가 저장된 MCP OAuth 토큰을 갱신하지 않음

해결 방법 1: Codex의 갱신 조정 플래그 켜기. Codex에는 Codex 프로세스 간 OAuth 토큰 갱신을 조정하는 기능 플래그 mcp_oauth_refresh_coordination이 있습니다. 이는 Comfy가 아닌 Codex의 설정입니다. Codex에서는 개발 중인 기능으로 분류되어 기본적으로 꺼져 있으며, Codex와 Comfy 모두 공식 해결책으로 지원하지 않습니다. openai/codex#46028에서는 이 플래그를 켜자 보고자의 테스트에서 오래된 토큰 재사용이 발생하지 않았습니다. 사용 중인 Codex 버전에서 아직 꺼져 있다면 ~/.codex/config.toml에 추가하세요:

[features]
mcp_oauth_refresh_coordination = true

실행 중인 모든 Codex 세션을 닫고 다시 시작하여 모든 세션에 플래그가 적용되도록 하세요. Codex에 comfy-cloud가 이미 로그아웃 상태로 표시된다면 한 번 더 로그인하세요(codex mcp login comfy-cloud 또는 설정의 Authenticate). 이후 Codex 릴리스에서 이 기능이 기본으로 켜지거나 플래그가 제거되면 이 단계는 건너뛰어도 됩니다.해결 방법 2: 서버마다 하나의 Codex 프로세스만 갱신하도록 하기. 플래그를 사용할 수 없거나 효과가 없다면 [mcp_servers.comfy-cloud] 항목을 전역 ~/.codex/config.toml에서 신뢰할 수 있는 프로젝트의 .codex/config.toml로 옮겨, 해당 프로젝트의 세션만 이를 불러오고 갱신하도록 하세요. Comfy Cloud에 연결된 Codex 세션을 동시에 여러 개 실행하지 말고, 컴퓨터를 다시 시작하기 전에 Codex 세션을 닫으세요. 이는 openai/codex#48507에서 보고된 해결 방법입니다.항목을 옮겨도 이미 전역 설정을 불러온 Codex 프로세스는 멈추지 않고 이전 서버 정의를 계속 갱신합니다. 옮긴 뒤에는 실행 중인 모든 Codex 세션을 닫고 Codex 앱 서버를 중지한 다음, 항목이 있는 프로젝트에서만 Codex를 시작하세요.OAuth가 필요 없다면 위의 API 키 설정은 리프레시 토큰을 사용하지 않습니다.이 단계들은 로그아웃 빈도를 줄여 주지만 완전히 없애지는 못할 수 있습니다. Comfy Cloud 측에서도 이 문제의 발생을 줄이기 위한 개선 작업을 진행하고 있습니다.

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 Agent

피드백

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

FAQ

시작하기

비용과 접근

사용하기

트러블슈팅