Comfy MCP 사용법: 클로드 코드에서 말로 ComfyUI 돌리기

Comfy MCP는 AI 에이전트를 ComfyUI에 연결하는 공식 서버입니다. 2026년 6월 29일 공개 베타로 나왔고, 연결하면 클로드 코드나 클로드 데스크톱 같은 클라이언트에서 문장으로 지시해 이미지와 영상, 음악, 3D를 만듭니다.

노드를 선으로 잇는 화면은 ComfyUI의 힘이면서 진입 장벽이었습니다. 모델 로더와 샘플러, VAE를 각각 놓고 연결해야 그림 한 장이 나옵니다.

Comfy MCP는 그 작업을 에이전트에게 넘깁니다. 주방에 들어가 조리 도구를 직접 늘어놓는 대신 창구에 주문을 넣는 방식인데, 무엇이 열리고 무엇이 막히는지는 조건에 따라 꽤 다릅니다. 공식 문서를 근거로 2026년 9월 22일 기준으로 정리했습니다.

연결 두 가지 가운데 무엇을 고를지

먼저 정할 것은 클라우드와 로컬 가운데 어느 쪽에 붙일지입니다. 둘은 실행되는 곳이 다릅니다.

권하는 기준은 셋입니다.

• 처음 써 본다면 설정이 단순한 클라우드부터 시작합니다
• 이미 로컬에 ComfyUI를 돌리고 있거나 코딩 에이전트에서 주로 일한다면 로컬을 고릅니다
• 맥에서 오픈 웨이트 모델을 돌릴 생각이라면 클라우드를 권합니다. MiniMax H3나 LTX-2.3 같은 최근 모델은 덩치가 커서 애플 GPU로는 쓸 만한 속도가 나오지 않는다고 적었습니다

둘을 함께 붙여 두는 것도 정상입니다. 다만 같은 Comfy 계정이어도 로그인은 따로 해야 하고, 한쪽에 로그인했다고 다른 쪽이 열리지는 않습니다.

클라우드 연결 설정하기

Comfy Cloud 계정이 먼저 있어야 합니다. 새로 가입하면 무료로 5회를 돌려 볼 수 있습니다.

클로드 데스크톱을 기준으로 한 순서입니다.

1. 사이드바에서 Customize를 엽니다
2. Connectors를 누릅니다
3. Connectors 머리글의 + 버튼을 누르고 Add custom connector를 고릅니다
4. 이름에 Comfy Cloud MCP 같은 값을 넣고, Remote MCP server URL에 https://cloud.comfy.org/mcp를 넣은 뒤 Add를 누릅니다
5. 브라우저가 열리면 워크스페이스를 고르고 Continue로 승인합니다

클로드 코드와 커서, 코덱스용 설정도 따로 안내되어 있습니다. 인증 방식이 다른데 클로드 코드와 클로드 데스크톱은 브라우저 OAuth를 한 번 거치고, 커서는 설정에 Comfy Cloud API 키를 넣어야 합니다.

로컬 연결 설정하기

로컬 쪽은 comfy-mcp라는 공식 서버를 내 컴퓨터에서 띄우고, 그 서버가 같은 컴퓨터의 ComfyUI를 부리는 구성입니다. 설치된 커스텀 노드와 모델을 그대로 쓸 수 있어서 내 환경에 맞는 워크플로를 짭니다.

필요한 것은 넷입니다.

• 파이썬 3.10 이상
• comfy-cli 1.14.0 이상 (pip install "comfy-cli>=1.14.0")
• ComfyUI 작업 공간. 없으면 comfy install로 만들고, 기존 설치본은 comfy set-default <경로>로 지정합니다
• 실행 중인 ComfyUI

설치는 한 줄입니다.

여기서 자주 걸리는 곳이 둘 있습니다.

서버가 ComfyUI를 대신 켜 주지 않습니다. comfy launch로 먼저 띄워 두거나 launch_comfyui 도구를 부르라고 문서가 못 박아 두었습니다.

PATH 문제. MCP 클라이언트는 자기 환경으로 서버를 실행해서 셸의 PATH를 물려받지 못하는 경우가 많습니다. comfy가 가상 환경 안에 있거나 경로가 특이하면 COMFY_BIN에 절대 경로를 넣어 줍니다.

설정이 번거로우면 문서가 제안하는 방법이 하나 있습니다. 그 문서 주소를 그대로 에이전트에게 주고 설정해 달라고 맡기는 쪽입니다.

에이전트가 쓰는 도구

도구를 직접 부르지는 않습니다. 원하는 것을 말하면 에이전트가 알맞은 도구를 고릅니다. 고양이 우주비행사 그림을 만들어 달라거나 이 사진을 키워 달라는 식으로 평범하게 적으면 됩니다.

도구는 네 묶음으로 나뉩니다.

일이 흘러가는 순서는 대체로 같습니다. 무엇이 있는지 찾고, 맞는 템플릿이 있으면 그것을 돌리고, 끝날 때까지 기다린 뒤 결과를 받습니다. 서버는 맨땅에서 워크플로를 짜기보다 이미 만들어진 템플릿을 먼저 찾도록 되어 있어서 결과가 더 빨리 나오는 편입니다.

get_prompting_guide는 따로 볼 만합니다. 모델 계열마다 권장하는 스텝과 cfg, 샘플러, 해상도를 돌려주는 도구라 설정값을 짐작으로 넣지 않아도 됩니다.

크레딧과 요금 조건

여기서 오해가 자주 생깁니다.

검색은 무료입니다. search_templates와 search_models, search_nodes는 Comfy 계정만 있으면 씁니다.

생성에는 Comfy Cloud 구독이 필요합니다. 크레딧이나 충전 잔액이 남아 있어도 구독이 활성 상태가 아니면 생성이 열리지 않는다고 문서가 분명히 적었습니다. 검색은 되는데 그림만 안 나온다면 여기를 먼저 봅니다.

Comfy Cloud 요금은 월 20달러 Standard부터 시작합니다. 요금제별 차이는 컴피UI 정리 글에 표로 정리해 두었습니다.

결과물을 받는 방식

MCP 서버가 클라우드에서 돌기 때문에 생성된 파일이 내 컴퓨터에 저절로 저장되지는 않습니다. 작업이 끝나면 에이전트가 get_output을 부르고, 서버는 둘을 돌려줍니다.

• 짧은 시간만 유효한 서명된 다운로드 주소
• 바로 실행할 수 있는 셸 명령 (맥과 리눅스는 curl, 윈도우는 curl.exe)

에이전트가 그 명령을 셸에서 실행하면 파일이 내려옵니다. 자동 저장을 기대하면 결과물을 놓치기 쉬우니 이 단계를 기억해 두는 편이 낫습니다.

공개 베타에서 알려진 제약

Comfy가 스스로 적어 둔 한계입니다. 업무에 묶기 전에 확인할 점이 있습니다.

공식 안내도 API와 도구, 동작이 바뀔 수 있다고 적었습니다. 시험 삼아 붙여 보는 단계로 두고, 자동화 흐름에 넣는 것은 정식 공개 뒤로 미루는 편이 안전하다고 봅니다.

자주 묻는 질문

로컬 연결만 쓰면 요금이 안 드나요?

로컬에서 오픈 웨이트 모델을 돌리는 데는 요금이 붙지 않습니다. 다만 파트너 노드로 외부 상용 모델을 부르면 그 사용량에는 요금이 붙습니다.

클로드 코드에서도 쓸 수 있나요?

쓸 수 있습니다. 클라이언트별 설정이 따로 안내되어 있고, 이미 로컬에 ComfyUI를 돌리고 있다면 로컬 연결 쪽이 맞습니다.

맥에서는 어느 쪽이 더 나을까요?

오픈 웨이트 모델을 돌릴 생각이면 클라우드를 권한다고 문서가 적었습니다. 최근 모델은 크기가 커서 애플 GPU로는 실용적인 속도가 나오지 않는다는 이유입니다.

ComfyUI를 켜 두지 않아도 로컬 연결이 되나요?

실행 도구를 쓰려면 ComfyUI가 켜져 있어야 합니다. 서버가 알아서 띄우지 않으므로 comfy launch로 먼저 실행하거나 launch_comfyui 도구를 부릅니다.

정리

노드를 직접 잇는 일이 진입 장벽이었는데 그 몫을 에이전트가 맡는 구성입니다. 다만 지금은 베타이고 구독 조건과 다운로드 단계가 붙어 있어서, 먼저 써 보고 흐름이 맞는지 확인하는 쪽이 현실적입니다.

3줄 요약:

• Comfy MCP는 AI 에이전트를 ComfyUI에 연결하는 공식 서버이고 2026년 6월 29일 공개 베타로 나왔습니다.
• 연결은 설치가 없는 Comfy Cloud 쪽과 내 컴퓨터의 ComfyUI를 부리는 오픈소스 로컬 쪽 두 가지입니다.
• 검색 도구는 계정만 있으면 무료이고 생성에는 Comfy Cloud 구독이 필요하며 출력물은 셸 명령으로 내려받습니다.

Sources

• Comfy MCP: Connect AI Agents to ComfyUI (ComfyUI 공식 문서)
• Agent Tools 개요 (ComfyUI 공식 문서)
• Comfy Cloud 요금 안내
• Comfy 공식 사이트