Гайды

Как настроить MCP в ComfyUI

22 октября 2026 · 13 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 22 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Настроить MCP в ComfyUI можно двумя путями. Облачное подключение сводится к добавлению адреса https://cloud.comfy.org/mcp как удалённого MCP-сервера и входу по OAuth. Локальное подключение ставится командой pip install comfy-mcp, после чего клиент запускает сервер comfy-mcp на вашей машине и работает с ним через stdio. Выбор между ними определяется тем, где лежат модели и GPU.

Что такое MCP в ComfyUI и какие границы у продукта

MCP в ComfyUI — это сервер, который отдаёт инструменты ComfyUI вашему агенту. В документации проекта на docs.comfy.org сказано, что Comfy MCP Cloud Connection запускает рабочие процессы Comfy Cloud вашим агентом, Comfy MCP Local Connection управляет вашим локальным ComfyUI, а Comfy Agent работает внутри самого ComfyUI для разбора, сборки, правки и запуска выбранного workflow. Это три разных инструмента с разными задачами, и путать их не стоит.

На странице comfy.org/mcp/ продукт описан так: агент превращается в creative technologist, генерирует изображения, видео, аудио и 3D, ищет модели, ноды и шаблоны и запускает реальные workflow. Там же указано, что это первый MCP, построенный для production-конвейеров, и что он рассчитан на пакетную генерацию, воспроизводимость и командную работу.

Что важно для планирования: MCP — открытый стандарт, поэтому подойдёт любой совместимый клиент. В материалах comfy.org/mcp/ перечислены Claude Code, Claude Desktop, Codex, Cursor и другие; вход выполняется по OAuth или по API-ключу в облаке, а локальный запуск не требует аккаунта вообще. В блоге проекта на blog.comfy.org сказано, что Comfy MCP вышел в публичную бету и соединяет Claude, Codex, Hermes и Cursor со всей экосистемой ComfyUI.

Собственный счёт редакции по этому корпусу: скачали подборку результатов веб-поиска по запросу «Как настроить MCP в ComfyUI»: текст отдали 8 из 10. Медиана объёма читаемого текста топа — 1839 слов. Метку 2026 года несут 4 из 8 прочитанных страниц.

Условия доступа и где смотреть актуальные требования

Облачное подключение требует подписки Comfy Cloud любого уровня. На comfy.org/mcp/ прямо сказано: чтобы пользоваться Comfy Cloud через MCP, нужна подписка любого тарифа, а одного пополнения кредитов для запуска генераций недостаточно. Соединение и поиск в облаке бесплатны, а запуск генерации расходует кредиты Comfy Cloud. Агент подтверждает трату у вас перед тем, как её совершить.

Локальное подключение устроено иначе. По данным comfy.org/mcp/, на локальном соединении запуски на вашем железе бесплатны, а сервер открыт. Исключение — партнёрские модели: они работают на инфраструктуре партнёра и тратят кредиты Comfy с вашего аккаунта, поэтому перед их использованием нужно войти. Вход выполняется через comfy-cli с браузерным логином либо с Comfy API-ключом.

Требования к железу различаются по площадкам. В документации на docs.comfy.org указано: облачное подключение работает на GPU Comfy Cloud и не предъявляет требований к вашему железу; локальное использует ваш GPU. Там же отмечено, что для облака нужен собственный агент и активная подписка Comfy Cloud, а для локального — свой агент и установленный ComfyUI.

Отдельная оговорка для владельцев Mac приведена на comfy.org/mcp/: крупные открытые модели сегодня не работают на Apple GPU с приемлемой скоростью, поэтому такие модели стоит запускать в облаке. Это ограничение скорости.

Актуальные требования стоит сверять по первоисточникам, потому что продукт находится в бетe. В блоге проекта на blog.comfy.org указано, что MCP всё ещё в бете и авторы просят тестировать его и сообщать, что работает, а что нет. Документация на docs.comfy.org/agent-tools/mcp содержит разделы про установку, список инструментов и несколько методов аутентификации — это и есть точка сверки.

Таблица ниже сопоставляет два подключения по параметрам из документации проекта.

Порядок действий: облачное подключение

Облачный путь начинается с аккаунта. В блоге проекта на blog.comfy.org сказано, что Comfy MCP соединяет ваш аккаунт Comfy с агентами, поэтому аккаунт нужен для старта, и создать его можно на cloud.comfy.org или в десктопном приложении.

Дальше адрес добавляется в клиент. На comfy.org/mcp/ описан универсальный шаг: добавьте https://cloud.comfy.org/mcp как custom connector или remote MCP-сервер в вашем клиенте, затем войдите по запросу. В документации на docs.comfy.org приведены конкретные пути для каждого клиента.

Для Claude Code команда выглядит так: claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp. Если нужен API-ключ вместо OAuth, к той же команде добавляется заголовок -H "X-API-Key: comfyui-…".

Для Claude Desktop документация описывает путь Customize → Connectors → + → Add custom connector. Введите имя Comfy Cloud MCP, укажите https://cloud.comfy.org/mcp в поле Remote MCP server URL, нажмите Add и завершите браузерный вход с выбором рабочего пространства.

Для Cursor откройте Settings → Tools & MCPs → + New MCP Server → Add a Custom MCP Server. В ~/.cursor/mcp.json или .cursor/mcp.json задайте URL https://cloud.comfy.org/mcp и заголовок X-API-Key со значением ${env:COMFY_API_KEY}; переменная COMFY_API_KEY должна содержать ключ Comfy Cloud.

Для Codex в документации даны две команды: codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp и codex mcp login comfy-cloud. Альтернатива — запись в конфигурации с секцией mcp_servers.comfy-cloud, полем url и env_http_headers с ключом X-API-Key.

Для OpenClaw документация приводит команду openclaw mcp set comfy с JSON, где указаны url, transport: streamable-http и auth: oauth, затем openclaw mcp login comfy и openclaw gateway restart. Вариант с ключом использует заголовок Authorization со значением Bearer ${COMFY_API_KEY}.

Метод аутентификации зависит от клиента. В документации на docs.comfy.org сказано: Claude Code и Claude Desktop используют одноразовый браузерный OAuth-поток; Cursor требует Comfy Cloud API-ключ в конфиге MCP; другие headless-клиенты могут передать ключ через заголовок X-API-Key. Там же отмечено, что device-code OAuth-поток для клиентов без браузера запланирован.

Порядок действий: локальный сервер

Локальный путь начинается с установки. В документации на docs.comfy.org приведена последовательность: pip install "comfy-cli>=1.14.0" для движка, затем comfy install для создания рабочей области ComfyUI (этот шаг пропускается, если область уже есть), затем pip install comfy-mcp, который даёт команду comfy-mcp.

После установки сервер прописывается в клиент. Для Claude Code документация даёт команду claude mcp add comfy-mcp -e COMFY_BIN=/path/to/venv/bin/comfy -- comfy-mcp. Для конфигурационного файла — запись comfy-mcp с полем command и переменной окружения COMFY_BIN, указывающей на бинарник comfy в вашем окружении.

Важное условие из документации: для инструментов исполнения нужен запущенный ComfyUI. Запустить его можно командой comfy launch или вызовом launch_comfyui. Сервер не запускает ComfyUI сам.

Проверка начинается с инструмента server_info(). В документации он описан так: показывает, запущен ли локальный ComfyUI, где именно и какая рабочая область; вызывать первым. Этот вызов отвечает на главный вопрос диагностики — дошёл ли агент до нужного сервера.

Таблица сопоставляет инструменты с задачами, для которых они описаны в документации.

Учебный пример и критерии самостоятельной проверки

Пример ниже — наше предлагаемое упражнение. Результаты зависят от вашей установки.

Задача: выполнить локальный workflow и получить его результат. Вызовите server_info(), проверьте рабочую область и запущенный ComfyUI. Через search_templates и fetch_template получите файл runnable workflow JSON и передайте его путь в run_workflow(workflow_path, wait=False). Сохраните возвращённый prompt_id, дождитесь завершения через wait_for_job и заберите файлы через fetch_outputs(prompt_id, out_dir).

Критерии проверки: server_info() показывает нужный локальный экземпляр; шаблон сохранён в файл; run_workflow возвращает идентификатор; завершённая задача отдаёт файлы в выбранную папку.
Если какой-то пункт не проходит, сузьте шаг: сначала добейтесь ответа server_info(), потом переходите к запуску. Так вы отделите проблему соединения от проблемы самого workflow.

Смежные варианты и что выбирать по задаче

Выбор между облаком и локальным сервером документация проекта описывает прямо. На comfy.org/mcp/ сказано: новым пользователям стоит начинать с облака — это простейшая настройка и более совместимый вариант для claude.ai, ChatGPT и Claude Desktop; локальное подключение выбирают те, у кого ComfyUI уже стоит на машине, или те, кто работает в основном в кодинг-агенте вроде Claude Code, Cursor или Codex.

По данным docs.comfy.org, облачное подключение подходит новичкам, которым не хочется ставить ComfyUI локально, и тем, кто делится workflow; локальное — тем, у кого ComfyUI уже есть, у кого приватные кастомные ноды и кому нужен доступ к локальной файловой системе. Там же указано, что облако даёт GPU Comfy Cloud без требований к железу, а локальное подключение использует ваш GPU.

Два сервера можно держать одновременно. На comfy.org/mcp/ сказано, что большинство клиентов спокойно запускают два MCP-сервера рядом, и они аутентифицируются независимо: облачное соединение входит в ваш аккаунт Comfy, а локальное не требует входа до запуска партнёрских моделей. Практический сценарий из того же источника: бесплатно прототипировать на своём GPU, а тяжёлую пакетную задачу отправить на GPU облака из того же чата.

Рядом с MCP живут смежные инструменты. В документации на docs.comfy.org названы Comfy CLI — командная строка для локальной установки и запуска ComfyUI и для вызова хостящихся партнёрских нод из скриптов или CI, с командой comfy generate в бете, — и шаринг workflow на Comfy Cloud из интерфейса, который инструмент share_workflow выполняет из сессии агента. Для OpenClaw там же указан навык Comfy Cloud на ClawHub, устанавливаемый командой openclaw skills install @comfy-org/comfy.

Если вам ближе локальные модели без облака, посмотрите материал LM Studio бесплатно: запуск LLM на своём ПК. Для практики внутри ComfyUI пригодятся разборы Как оживить фото в ComfyUI и ComfyUI inpainting: как удалить объект.

Типичные проблемы и проверяемые способы диагностики

Первая частая причина сбоя — ComfyUI не запущен. В документации на docs.comfy.org сказано, что для инструментов исполнения нужен работающий ComfyUI, и сервер не запускает его сам. Проверка: вызовите server_info() и посмотрите, находит ли он локальный экземпляр.

Вторая причина — неверный адрес сервера. Для облака адрес указан точно: https://cloud.comfy.org/mcp, и он вводится как remote MCP-сервер или custom connector. Проверка: сверьте строку в конфиге клиента с этим значением.

Третья причина — неподходящий метод входа. По документации Cursor требует Comfy Cloud API-ключ в конфиге MCP, а Claude Code и Claude Desktop используют браузерный OAuth. Проверка: посмотрите состояние аутентификации через get_server_info.

Четвёртая причина связана с Codex и обновлением токенов. В документации на docs.comfy.org упомянут issue openai/codex#17265: Codex не обновляет сохранённые MCP OAuth-токены. Там же приведён флаг конфигурации mcp_oauth_refresh_coordination = true в секции features.

Пятая причина — ограничения загрузки файлов. В документации сказано, что лимиты размера загрузки зависят от MCP-клиента, и некоторые клиенты задают собственные ограничения на файлы. Проверка: уменьшите размер файла и повторите загрузку.

Шестая причина — шаблон, который ваша установка не может выполнить. В документации на docs.comfy.org описан инструмент validate_workflow для проверки workflow по данным локального экземпляра перед запуском. Проверка: возьмите шаблон из search_templates, подходящий вашей конфигурации, и запустите его отдельно.

Седьмая причина — расход кредитов на партнёрских моделях. В документации отмечено, что шаблоны и workflow могут тратить кредиты, и агент спрашивает подтверждение перед тратой. Проверка: убедитесь, что вы вошли в аккаунт перед запуском партнёрской модели.

Восьмая причина — нестандартный адрес ComfyUI. Инструмент server_info() показывает, где работает локальный ComfyUI и какая рабочая область выбрана. Проверка: убедитесь, что агент обращается к тому адресу, где действительно работает ваш экземпляр.

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

Чем официальный MCP от ComfyUI отличается от community-версии?

Официальный сервер описан на comfy.org/mcp/ как первый MCP, построенный для production-конвейеров, и он связан с аккаунтом Comfy. Community-серверы живут в отдельных репозиториях и на сторонних каталогах. Для настройки по документации берите официальный путь: облако через https://cloud.comfy.org/mcp или локальный comfy-mcp из PyPI.

Нужен ли именно Claude или подойдёт другой агент?

MCP — открытый стандарт, и в материалах comfy.org/mcp/ перечислены Claude Code, Claude Desktop, Codex, Cursor и другие совместимые клиенты. В блоге проекта к ним добавлены Hermes и OpenClaw. Метод входа зависит от клиента: где-то это OAuth, где-то API-ключ.

Какое железо нужно для локального запуска с MCP?

Локальное подключение использует ваш GPU и ваши модели. В документации на docs.comfy.org указано, что облако работает на GPU Comfy Cloud без требований к вашему железу. Для Mac на comfy.org/mcp/ есть оговорка: крупные открытые модели сегодня не работают на Apple GPU с приемлемой скоростью, их стоит запускать в облаке.

Стоит ли MCP денег сверх обычного использования ComfyUI?

На локальном соединении запуски на вашем железе бесплатны, а сервер открыт; партнёрские модели тратят кредиты Comfy с вашего аккаунта. В облаке соединение и поиск бесплатны, а генерация расходует кредиты Comfy Cloud, и нужна подписка любого уровня. Агент подтверждает трату перед её совершением.

Может ли MCP работать с моделями, которых нет локально?

Да. В облачном подключении доступны модели Comfy Cloud, и туда можно импортировать свои модели. В документации на docs.comfy.org отмечено, что партнёрские API-ноды вызываются через облако. Локальное подключение работает с моделями, скачанными на вашу машину.

Готовый промпт для запуска задачи через агента

Промпт, чтобы агент сам разобрал вашу установку и предложил рабочий план.

Ты помогаешь мне настроить локальный MCP в ComfyUI. Сначала вызови server_info() и проверь рабочую область и состояние ComfyUI. Найди шаблон под задачу [ваша задача] через search_templates, сохрани JSON через fetch_template и проверь ноды моей установки. Выполни файл через run_workflow, дождись результата через wait_for_job и забери файлы через fetch_outputs. Перед запуском покажи план и требуемые параметры.

В промпте замените [ваша задача] на свою формулировку. Для облачного сценария используйте отдельный набор инструментов: get_server_info, search_templates, get_template, run_template или submit_workflow, затем wait_for_job и get_output.

Вариации той же задачи:

• Пакетный запуск: попросите агента запустить run_workflow с wait=False, вернуть prompt_id и описать, как отслеживать задачи по нему.
• Разбор облачного workflow: при облачном подключении попросите import_shared_workflow превратить ссылку шаринга в JSON и объяснить структуру графа.
• Проверка совместимости: попросите сверить ноды из шаблона с тем, что установлено у вас, и назвать расхождения.
• Диагностика входа: попросите проверить состояние аутентификации и подсказать, где взять API-ключ для вашего клиента.
• Перенос на облако: попросите описать, что изменится в запуске при переходе на облачное подключение.

Если генерация падает на этапе запуска, разбор причин есть в материале Stable Diffusion не генерирует: причины и проверка.