ComfyUI 워커 MCP 실행

#1. 대시보드에서 찾고 추천

워크플로우 매뉴얼 사용 안내 — 번호·이름·ID로 검색하고 현재 파일 기준의 사용법과 주의사항을 읽습니다. 새 항목·수정은 페이지를 열거나 새로고침할 때 조회하며, 열린 사전은 60초마다 확인합니다.

1. 원격 MCP 또는 로컬 CLI MCP 연결을 마칩니다. 에이전트 지침은 연결 시 제공됩니다.
2. comfy_status로 실행 권한, 컴피 크레딧과 대기열을 확인합니다. 일반 생성 크레딧과 컴피 크레딧은 별도입니다.
3. comfy_wiki_find로 대시보드의 모델·용도·입출력을 찾고 번호와 이름을 비교합니다. comfy_wiki_read로 후보의 사용 가이드와 검증 기록을 읽은 뒤 사용자에게 추천합니다.

comfy_personal_list로 로그인한 계정이 ComfyUI에 저장한 개인 워크플로우를 찾고, comfy_personal_get으로 원본을 가져옵니다. summary_only=true면 노드 목록만 확인합니다. 다른 사용자의 개인 워크플로우는 조회할 수 없습니다. 저장된 원본에는 개인 프롬프트나 인증값이 들어 있을 수 있으므로 내용을 공유할 때 주의하세요.

대시보드나 내 개인 워크플로우에 적합한 작업이 없으면 없다고 알립니다. 외부 사이트에서 워크플로우를 가져오거나 임의로 그래프를 구성하지 않습니다. list_workflows는 별도인 Labs 워크플로우입니다.

#2. 입력과 견적 준비

comfy_workflow_plan에 대시보드 번호 또는 workflow_id를 전달합니다. 내 개인 워크플로우는 comfy_personal_list의 ID와 source="personal"을 전달합니다. 응답의 editable_inputs에서 노드 ID와 입력 이름을 확인하고, 항목이 100개를 넘으면 comfy_workflow_inputs로 다음 페이지를 확인합니다. 필요한 값을 inputs로 전달해 다시 계획합니다. 원격 연결에서는 comfy_upload_url로 HTTPS 미디어 URL을, 로컬 CLI에서는 comfy_upload_input으로 PC 파일을 올리고 반환된 이름을 사용합니다. 노드 규격은 comfy_node_info로 확인할 수 있습니다.

{"workflow_id":"1","inputs":{"3":{"text":"a quiet forest"}}}

로컬 CLI는 Chrome, Edge 또는 Playwright Chromium이 필요합니다. 원격 연결에서는 서버가 변환합니다. 도구가 저장된 원본을 실행용으로 변환하며, 노드 그래프를 직접 전달하지 않습니다. 대시보드 항목은 표시된 입력만, 개인 항목은 변환된 노드의 단일 값 입력을 변경할 수 있습니다. 연결과 노드 구성은 바꾸지 않습니다.

applied_inputs와 입력 목록의 value로 계획에 실제 반영된 값을 확인하세요.
선택형은 현재 choices, 숫자는 min/max/step을 따릅니다.
워크플로우 이름만 보고 해상도·길이·참고 순서가 적용됐다고 판단하지 않습니다.

#3. 승인·실행·결과

1. 계획의 quote와 credit_cap.minimum을 함께 확인합니다.
   실행 기록이 있는 워크플로우는 최근 평균 예상액 이상으로 상한을 정하며, maximum_credits가 잔액이라고 전부 승인할 필요는 없습니다.
   first_run=true이면 현재 브로커가 잔액을 일시 예약하므로 더 작은 상한을 거절할 수 있습니다.
   최소 예약이 승인 예산보다 크면 실행을 멈추고 알리며 상한을 자동으로 늘리지 않습니다.
   성공한 실행은 실제 시간 1분당 1크레딧(시작한 분 올림)으로 정산하고 남는 예약을 반환합니다.
2. comfy_workflow_run에 계획의 plan_id, 미리 보관한 새 소문자 UUID request_id, 승인할 max_credits를 전달하고 확인 정책을 따릅니다.
   계획의 유지 범위는 응답의 persistence에서 확인합니다.
3. 접수가 불확실하면 재접수하지 말고 같은 ID로 comfy_job을 확인합니다. 완료 후 comfy_download_result로 결과를 새 경로에 저장하거나, 필요한 경우 본인 작업만 comfy_cancel로 취소합니다.

확정된 실패·취소는 환불되며 불확실한 작업은 정산이 보류될 수 있습니다. 원본 워크플로우가 바뀌면 계획을 다시 준비해야 합니다.

AIMZ ComfyUI 대시보드에서 배경 제거 워크플로우를 찾아 추천해 줘.
선택한 번호의 입력과 컴피 크레딧 견적을 알려 주고, 내 승인 후 실행해 결과를 저장해 줘.

#워크스페이스에서 실행하기

워크스페이스 전용 도구는 화면과 같은 서버 계획·실행 경로를 사용합니다.
최신 클라이언트의 이미지·영상·오디오 노드에서 ComfyUI를 고르고 대시보드 또는 내 워크플로우를 선택하세요.
입력 규격을 불러오면 해상도·길이·시드 등 실제 옵션과 참고 순서를 설정할 수 있습니다.
에이전트도 다음 도구로 작업하며, 오래된 클라이언트는 현재 도구 규격과 업데이트 안내를 먼저 확인합니다.

1. workspace_comfy_inputs로 노드의 연결을 읽습니다. 현재 revision을 사용한 production_update(edit)로 draft.model="comfyui", 전체 워크플로우 ID와 source를 저장합니다.
2. workspace_comfy_plan(board_id,node_id) 후 workspace_comfy_plan_status(plan_id)를 조회합니다. 준비가 끝나면 실제 editable_inputs·가이드·참고 연결·차단 사유·견적을 확인합니다. 다음 입력 페이지가 있으면 이어 읽습니다.
3. 노드의 params.inputs에 실제 입력 값을, params.bindings에 참고 노드와 입력 슬롯을 순서대로 저장하고 다시 계획합니다. 미연결 입력이나 게시 예제 파일을 대신 실행하지 않습니다.
4. runnable=true인 계획을 workspace_comfy_run으로 실행합니다. 새로운 소문자 UUID를 먼저 기록하고, 진행 중이거나 접수가 불확실하면 같은 ID로 workspace_comfy_job만 조회합니다.

{"model":"comfyui","params":{"workflow":"선택한 전체 ID","source":"dashboard","inputs":{"해상도노드ID":{"megapixels":1.6}},"bindings":[{"node_id":"참고로더ID","input":"media_state","source_node_id":"연결한캐릭터노드"},{"node_id":"참고로더ID","input":"media_state","source_node_id":"연결한공간노드"}]}}

이 경로는 서버에서 워크플로우를 변환하므로 로컬 브라우저가 필요 없습니다. 계획은 본인만 조회·실행할 수 있습니다. 완료 결과는 라이브러리에 남고, 실행 당시 입력과 같은 노드에 연결됩니다. 실행 중 노드를 수정하면 새 결과로 덮어쓰지 않습니다. attach_result=false는 조회만 합니다. 생성 완료와 영상·음향 품질 검수는 별도입니다.

음악·효과음을 만들 때도 오디오 출력이 있는 실제 워크플로우와 가이드를 먼저 고릅니다.
오디오 노드는 kind="audio", draft.model="comfyui"를 사용하며 음원 참고는 실제 audio 입력 슬롯에 바인딩합니다.
생성 결과는 오디오 결과로 라이브러리와 노드에 연결하고, 영상 URL로 가장하거나 예제 음원을 대신 쓰지 않습니다.
production_audio_sample → production_media_job → production_audio_listen으로 실제 구간 소리를 받습니다.
청취할 수 없으면 검수는 uncertain / observed:false이며 음량 수치나 낮은 음성 분류 점수만으로 승인하지 않습니다.

#독립된 컷을 함께 생성하기 (CLI 0.4.44+)

0.4.44는 진행 중인 컷이 있어도 다음 독립 컷의 단계별 계획을 준비할 수 있습니다.
현재 승인 참고와 실제 여유 슬롯을 확인하며, 계획 준비는 슬롯이나 크레딧 예약이 아닙니다.
0.4.43에서 다음 계획이 막히면 CLI를 갱신하고 기존 작업은 같은 요청 ID로 조회하세요.

workspace_comfy_capacity로 현재 계정의 max_concurrent_runs와 active_request_ids를 확인합니다. 기본 한도는 1이며 관리자가 계정별로 최대 5까지 설정할 수 있습니다. 다른 보드의 실행과 접수 미확정 작업도 포함하므로 워커 수만 보고 추가 접수하지 않습니다. 조회 실패를 빈 대기열로 해석하지 마세요.

승인된 같은 캐릭터·공간 시트를 읽는 독립 컷은 함께 진행할 수 있습니다. 앞 컷의 생성 결과를 참고하는 후속 컷은 그 결과와 검수를 기다립니다. 현재 입력·검수·예산 조건을 통과한 노드마다 새 UUID를 기록하고 하나씩 접수한 뒤 각각의 원래 ID로 조회하세요. unknown·접수 예약만 있는 시도·일반 생성이 남아 있으면 새 제작 실행을 멈추고 먼저 복구합니다. 한도 조회가 실행 자리를 예약하거나 워커 5개의 즉시 배정을 보장하지는 않습니다.

동시 실행에도 일반·컴피 예산, 단계·시도 한도와 실제 정산을 그대로 적용합니다. 첫 실행의 전체 잔액 임시 예약 정책도 같습니다. 구형 클라이언트나 서버에서는 순차 실행을 유지하세요.

#MiniMax H3 참고 영상·멀티샷

장면에 필요한 승인 자료부터 고릅니다. 이어지는 캐릭터와 장소는 승인된 캐릭터 시트·공간 시트를 재사용하고, 형상이나 브랜드 고증이 필요한 소품을 추가합니다. 단일 캐릭터 그림만 있다면 그대로 단일 참고라고 기록하며, 다면 시트를 확인한 것처럼 설명하지 않습니다. 필요한 시트가 없으면 해당 자료의 준비·검수를 먼저 계획합니다.

노드 이름과 프롬프트에 각 참고의 역할·유지할 특징·충돌 시 우선순위를 적습니다. API 연결 역할은 기존 ref를 쓰며 새로운 역할 값을 만들지 않습니다. params.bindings의 실제 이미지 순서에 맞춰 <Picture N>을 인용하세요. 캐릭터·공간·소품·스타일은 해당 이미지를 출처로 삼는 <Subject N>으로 정의하고, 그림 자체가 구도 기준인 경우에만 독립 Picture 항목으로 설명합니다. 순서를 바꾸면 번호와 설명도 함께 고칩니다. 각 장면에 필요한 참고만 연결하며 선택적 예시를 항상 네 번째 이미지로 채우지 않습니다.

subject_definitions:
<Subject 1> is the approved character from <Picture 1>; preserve its proportions, clothing and linework.
<Subject 2> is the room from <Picture 2>; retain its layout and room materials only.
<Subject 3> is the product from <Picture 3>; retain its geometry and verified markings, not the photo rendering of the whole scene.
retention_analysis:
Character identity follows <Subject 1>, room structure follows <Subject 2>, and product details follow <Subject 3>. No reference overrides another subject’s role.

공식 참고 프롬프트 가이드의 여섯 구역에 피사체 정의, 유지할 요소, 장면별 동작과 소리를 작성하세요. 후속 컷은 [Shot 2] At 00:03.000처럼 지시할 수 있지만 정확한 컷 수와 전환 시점은 결과를 확인해야 합니다. R2V 참고를 임의로 시작·끝 프레임으로 바꾸지 않습니다.

H3 공식 입력 한도는 이미지 최대9장·영상 최대3개·음원 최대3개, 전체 파일 최대12개입니다. 영상과 음원은 각각 파일당2~15초, 종류별 합계15초 이내입니다. 이는 채울 목표가 아닌 상한이며 선택한 워크플로우의 실제 입력 규격도 확인합니다. 현재 워크스페이스 H3 영상 바인딩은 시각 참고만 전달하므로 소리가 필요하면 별도 음원 입력으로 연결하세요. 한도를 넘으면 필요한 자료를 조용히 누락하지 말고 구성을 다시 계획합니다.

음식 조리·포장·먹는 동작마다 Foley를 구체적으로 적고, 요청된 배경음악 여부도 명시합니다. 1.6MP는 면적 설정이며 노드 배수 반올림 때문에 출력 비율이 달라질 수 있습니다. 생성 파일의 실제 크기를 확인하고 정확한 납품 비율은 필요한 패딩으로 맞춥니다.

#도구

자세한 인자는 MCP 도구 레퍼런스를 확인하세요.