ComfyUI MCP: генерация из Claude Code, Cursor и локальных LLM

Comfy-Org/comfy-mcp· Проверено 12.11.2026· 340на GitHub

Даёт агенту ваш ComfyUI: запустить workflow или шаблон, дождаться задания и забрать картинки, видео и звук, найти ноды и модели, поставить недостающие. Без своей видеокарты можно генерировать на GPU Comfy Cloud.

3 реализации:

Локальный сервер от создателей ComfyUI поверх comfy-cli: 41 инструмент для запуска, шаблонов, нод, моделей и управления самим ComfyUI.

Как подключить

Что сделать до подключения

Python 3.10 или новее

Поставить сервер вместе с движком: pip install comfy-mcp "comfy-cli>=1.14.0"

Создать рабочую папку ComfyUI командой comfy install, если её ещё нет

Запустить ComfyUI командой comfy launch и оставить работать

COMFY_API_KEY

Нужен только для моделей сторонних сервисов (Seedream, Veo, Kling и других): ключ создаётся на platform.comfy.org/profile/api-keys и начинается с comfyui-

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'COMFY_BIN=<полный путь к comfy>' --transport stdio comfyui \
  -- comfy-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.comfyui]
command = "comfy-mcp"
args = []

[mcp_servers.comfyui.env]
COMFY_BIN = "<полный путь к comfy>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "comfyui": {
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "comfyui": {
      "type": "stdio",
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "comfyui": {
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "comfyui": {
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "comfyui": {
        "type": "local",
        "command": ["comfy-mcp"],
        "environment": {
          "COMFY_BIN": "<полный путь к comfy>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "comfyui": {
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "comfyui": {
      "command": "comfy-mcp",
      "args": [],
      "env": {
        "COMFY_BIN": "<полный путь к comfy>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

server_infoпроверяет, запущен ли ComfyUI

run_workflowзапускает workflow из JSON

generate_imageделает картинку по тексту

run_templateзапускает шаблон из галереи

jobследит за заданием и отменяет

fetch_outputsкопирует результаты в папку

preview_mediaделает раскадровку видео

search_templatesищет шаблоны

fetch_templateсохраняет шаблон в JSON

set_workflow_slotменяет промпт, сид, шаги

vary_workflowразмножает workflow в варианты

validate_workflowпроверяет граф до запуска

nodesищет ноды в вашей установке

search_modelsищет модели на диске

install_nodeставит пакеты нод

download_modelскачивает модель

system_statsпоказывает свободную VRAM

free_memoryвыгружает модели из VRAM

get_logsчитает лог ComfyUI

partner_generateгенерирует моделью стороннего сервиса

Показано 20 из 41.

Удалённый сервер Comfy: workflow выполняются на GPU Comfy Cloud, ставить ComfyUI и иметь видеокарту не нужно.

Как подключить

Что сделать до подключения

Аккаунт Comfy Cloud: вход идёт через браузер с выбором рабочего пространства

Для клиентов без OAuth, например Cursor, ключ Comfy Cloud в заголовке X-API-Key

X-API-Key

Ключ Comfy Cloud с platform.comfy.org/profile/api-keys, начинается с comfyui-: нужен клиентам без MCP OAuth и для запуска без браузера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

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

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.comfy-mcp]
url = "https://cloud.comfy.org/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

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

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

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

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

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

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

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

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "comfy-mcp": {
        "type": "remote",
        "url": "https://cloud.comfy.org/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://cloud.comfy.org/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

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

Инструменты сервера

search_templatesищет шаблоны

submit_workflowотправляет workflow в облако

get_outputзабирает результат

Сервер на Node.js с плагином для Claude Code: сам собирает граф, правит живой canvas, ведёт историю генераций и работает с локальными моделями через Ollama.

Как подключить

Что сделать до подключения

Node.js 22 или новее

ComfyUI Desktop или ComfyUI из исходников, запущенный во время работы

CIVITAI_API_TOKEN

Нужен для скачивания моделей с CivitAI; для закрытых моделей HuggingFace задайте HUGGINGFACE_TOKEN

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'CIVITAI_API_TOKEN=<токен CivitAI, если нужен>' --transport stdio comfyui-mcp \
  -- npx -y comfyui-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.comfyui-mcp]
command = "npx"
args = ["-y", "comfyui-mcp"]

[mcp_servers.comfyui-mcp.env]
CIVITAI_API_TOKEN = "<токен CivitAI, если нужен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "comfyui-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "comfyui-mcp": {
        "type": "local",
        "command": ["npx", "-y", "comfyui-mcp"],
        "environment": {
          "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": "<токен CivitAI, если нужен>"
      }
    }
  }
}

Инструменты сервера

generate_imageделает картинку, видео или звук

enqueue_workflowставит workflow в очередь

queueуправляет очередью

create_workflowсобирает граф из заготовки

visualize_workflowрисует граф в Mermaid

get_imageпоказывает результат агенту

upload_imageзагружает картинку во input

download_modelскачивает и ищет модели

list_local_modelsперечисляет модели

clear_vramосвобождает видеопамять

search_custom_nodesищет пакеты нод

get_historyразбирает упавший запуск

restart_comfyuiперезапускает ComfyUI

Показано 13 из 38.

Что попросить агента

«Проверь, что мой ComfyUI запущен, запусти workflow ~/workflows/txt2img.json и покажи картинку»Агент вызовет server_info, run_workflow и fetch_outputs

«Найди шаблон для генерации видео и запусти его с промптом <промпт>»Агент вызовет search_templates, fetch_template, set_workflow_slot и run_workflow

«Сделай 4 варианта этой картинки с разными сидами»Агент вызовет vary_workflow, затем run_workflow для каждого варианта и fetch_outputs

«Почему упал последний запуск? Поставь то, чего не хватает»comfyui-mcp вызовет get_history с action diagnose, затем search_custom_nodes и download_model

«Сгенерируй картинку заката над горами»Агент вызовет generate_image и вернёт результат

Для каких задач

Запустить свой workflow из JSON и забрать готовые картинки в нужную папку

Найти шаблон в галерее, подставить промпт и сид и сделать серию вариантов

Проверить workflow до запуска и доставить недостающие ноды и модели

Разобрать упавший запуск по логам и трассировке

Освободить видеопамять перед тяжёлым заданием

Генерировать на GPU Comfy Cloud без своей видеокарты

Ограничения

Для локальной генерации нужна видеокарта: Comfy MCP советует от 24 ГБ VRAM для всего, 8–24 ГБ хватит на картинки, меньше 8 ГБ — уходить в облако или к сторонним моделям

partner_generate и ноды сторонних сервисов (Partner Nodes) в workflow тратят кредиты Comfy; подтверждение ловит только ноды, которые знает comfy-cli, поэтому чужой workflow проверяйте до запуска

pip install comfy-mcp не ставит comfy-cli: без comfy 1.14.0 или новее сервер стартует, но каждый вызов падает с ошибкой «comfy not found on PATH»

Comfy MCP в бете и распространяется по AGPL-3.0 или коммерческой лицензии

Если не работает

На macOS запуск падает с PermissionError: [Errno 1] Operation not permitted или Fatal Python error

macOS закрывает доступ к ~/Documents, ~/Desktop и ~/Downloads. Дайте клиенту Full Disk Access или перенесите ComfyUI, например в ~/ComfyUI, и укажите путь командой comfy set-default <путь>.

Каждый вызов Comfy MCP падает с ошибкой «comfy not found on PATH»

Поставьте comfy-cli: pip install "comfy-cli>=1.14.0". Если клиент не видит PATH вашего venv, укажите полный путь к comfy в COMFY_BIN.

comfyui-mcp пишет «ComfyUI not detected on ports 8188, 8000»

Запустите ComfyUI: Desktop по умолчанию слушает порт 8000, CLI — 8188. Для своего порта задайте COMFYUI_PORT.

comfyui-mcp пишет «COMFYUI_PATH is not configured»

Задайте COMFYUI_PATH — папку, где лежит каталог models/, например ~/Documents/ComfyUI.

Клиент показывает каждый инструмент Comfy MCP дважды

В конфиге две записи с одной командой comfy-mcp, например старая comfy-local и новая. Оставьте одну.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Comfy MCPразработчик сервиса	Comfy Org	340	локально	не нужен	41	5 ноября 2026
Comfy Cloud MCPразработчик сервиса	Comfy Org	340	HTTP	вход	3	5 ноября 2026
comfyui-mcp	artokun	919	локально	не нужен	38	9 ноября 2026

Частые вопросы

Чем Comfy MCP отличается от Comfy Cloud MCP?

Comfy MCP клиент запускает у вас на компьютере, и он управляет вашим ComfyUI. Comfy Cloud MCP живёт по адресу https://cloud.comfy.org/mcp и выполняет задания на GPU Comfy Cloud. Подключать оба сразу можно.

Куда сохраняются сгенерированные картинки?

ComfyUI пишет их в папку output рабочего пространства. fetch_outputs дополнительно копирует результаты задания в любую папку, которую вы назовёте агенту, оригиналы остаются на месте.

Можно ли управлять ComfyUI на другом компьютере?

Да, в Comfy MCP задайте COMFYUI_URL, например http://gpu-box:8188, или пару COMFYUI_HOST и COMFYUI_PORT. Адрес должен быть простым http без пути и параметров. У comfyui-mcp для этого есть флаг --comfyui-url.

Как не упереться в видеопамять, если рядом работает локальная LLM?

Агент читает свободную VRAM через system_stats и выгружает модели ComfyUI через free_memory. Саму LLM клиент выгружает своими средствами, например ollama stop <модель>, сервер до неё не дотягивается.

Что за gemma4 для ComfyUI MCP?

Это модели artokun/gemma4-comfyui-mcp для Ollama: Gemma 4, дообученная на 1 055 проверенных сценариях comfyui-mcp. Ставится командой ollama pull artokun/gemma4-comfyui-mcp:e4b, есть варианты :e2b на ~2 ГБ VRAM и :12b на ~8 ГБ.

Как подключить ComfyUI MCP к Claude Code?

Для Comfy MCP выполните claude mcp add comfy-mcp -e COMFY_BIN=<путь к comfy> -- comfy-mcp. Облачный вариант добавляется командой claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp, вход через /mcp → Authenticate.

Работает ли сервер из России?

Comfy MCP и comfyui-mcp работают с ComfyUI на вашем компьютере без аккаунтов. Для Comfy Cloud MCP и моделей сторонних сервисов нужен аккаунт Comfy и кредиты.

ComfyUI MCP: генерация из Claude Code, Cursor и локальных LLM

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы