Установка - ComfyUI MCP

1. Установка ComfyUI

ComfyUI Desktop

Самый простой способ получить управляемую установку на macOS / Windows.

Из исходников

Клонируйте и запустите вручную — либо воспользуйтесь инструментом install_comfyui.

2. Добавление MCP-сервера

ComfyUI MCP публикуется в npm как comfyui-mcp и запускается через npx — глобальная установка не нужна.

Локальный ComfyUI
Удалённый ComfyUI
Comfy Cloud

Сервер сам определяет локальную установку и её порт. Добавьте его в ~/.claude/settings.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"]
    }
  }
}

Укажите любой доступный экземпляр через --comfyui-url. Для инструментов, работающих по HTTP (генерация, очередь, воркфлоу, поиск моделей и т. д.), локальная установка не нужна. Если хост не является loopback-адресом, сервер переходит в удалённый режим и пропускает автоопределение COMFYUI_PATH, чтобы устаревшая локальная установка не могла незаметно перехватить загружаемые файлы.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp", "--comfyui-url", "https://my-comfy.example.com"]
    }
  }
}

Большинство инструментов прекрасно работают с удалённым ComfyUI — включая установку кастомных узлов через HTTP API ComfyUI-Manager. Путь к локальной установке по-настоящему нужен только для установки самого ComfyUI, операций на базе comfy-cli, чтения логов и удаления файлов моделей; в удалённом режиме они возвращают понятную ошибку. См. Как это работает.

Задайте COMFYUI_API_KEY, чтобы работать с Comfy Cloud. Сервер переходит в облачный режим: HTTP-примитивы идут через cloud.comfy.org с аутентификацией по X-API-Key. Инструменты, завязанные на WebSocket, а также на локальную файловую систему и процессы, выбрасывают понятную ошибку CLOUD_UNSUPPORTED.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "COMFYUI_API_KEY": "your-comfy-cloud-api-key"
      }
    }
  }
}

Облачный режим пропускает автоопределение локального COMFYUI_PATH и использует собственную библиотеку моделей облака. Инструменты, которым нужен локальный процесс или файловая система, выбрасывают CLOUD_UNSUPPORTED; остальные не падают, а работают в урезанном виде — list_local_models возвращает пустой список, а apply_manifest сообщает skipped/failed по каждому элементу вместо того, чтобы завершиться ошибкой целиком. Полная матрица соответствия возможностей — на странице Конфигурация.

Только облако? Comfy Cloud MCP от Comfy-Org (публичная бета) — канонический выбор, см. Локально vs. Comfy Cloud. Облачный режим comfyui-mcp пригодится, если вам нужен один MCP сразу для локального / удалённого / облачного варианта или поддержка облака нужна уже сегодня.

После этого выполните /mcp в Claude Code, чтобы подключиться.

3. Запуск оркестратора панели

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

npx -y comfyui-mcp@latest connect

Это сокращение для --panel-orchestrator. Команда автоматически нацеливается на тот ComfyUI, который открыт в браузере, поднимает мост на ws://127.0.0.1:9180 (переопределяется через COMFYUI_MCP_BRIDGE_PORT) и должна оставаться запущенной, пока вы пользуетесь панелью. Затем откройте вкладку Агент, выберите провайдера и нажмите Подключить. Управляете удалённым ComfyUI — облачным подом или другой машиной в локальной сети? Запустите ту же команду на своей машине, а не на удалённой, и передайте URL:

npx -y comfyui-mcp@latest connect https://your-pod-url

Вход у провайдера и сам агент остаются локальными; на удалённый хост ничего не устанавливается. Подробности про туннель — в разделе Развёртывание в облаке.

4. (Необязательно) Токены

Некоторые инструменты используют API-токены. Задайте их в блоке env сервера (см. Конфигурация):

CIVITAI_API_TOKEN — скачивание с CivitAI, требующее авторизации
HUGGINGFACE_TOKEN — более высокие лимиты запросов к HuggingFace
GITHUB_TOKEN — генерация скиллов / получение метаданных узлов
COMFY_API_KEY — хостируемые API-узлы comfy.org

Локальная разработка

Проект использует npm link, поэтому npx comfyui-mcp указывает на вашу локальную сборку:

git clone https://github.com/artokun/comfyui-mcp
cd comfyui-mcp
npm install
npm run build
npm link

После изменений в коде: npm run build, затем /mcp, чтобы переподключиться.

​1. Установка ComfyUI

ComfyUI Desktop

Из исходников

​2. Добавление MCP-сервера

​3. Запуск оркестратора панели

​4. (Необязательно) Токены

​Локальная разработка

1. Установка ComfyUI

2. Добавление MCP-сервера

3. Запуск оркестратора панели

4. (Необязательно) Токены

Локальная разработка