> ## Documentation Index
> Fetch the complete documentation index at: https://comfyui-mcp.artokun.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Установка

> Установите ComfyUI и подключите MCP-сервер — локально, удалённо или в Comfy Cloud.

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

<CardGroup cols={2}>
  <Card title="ComfyUI Desktop" icon="desktop" href="https://www.comfy.org/download">
    Самый простой способ получить управляемую установку на macOS / Windows.
  </Card>

  <Card title="Из исходников" icon="github" href="https://github.com/comfyanonymous/ComfyUI">
    Клонируйте и запустите вручную — либо воспользуйтесь инструментом [`install_comfyui`](/docs/docs/tools/install-environment).
  </Card>
</CardGroup>

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

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

<Tabs>
  <Tab title="Локальный ComfyUI">
    Сервер сам определяет локальную установку и её порт. Добавьте его в `~/.claude/settings.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "comfyui": {
          "command": "npx",
          "args": ["-y", "comfyui-mcp"]
        }
      }
    }
    ```
  </Tab>

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

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

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

  <Tab title="Comfy Cloud">
    Задайте `COMFYUI_API_KEY`, чтобы работать с [Comfy Cloud](https://cloud.comfy.org). Сервер
    переходит в **облачный режим**: HTTP-примитивы идут через `cloud.comfy.org` с
    аутентификацией по `X-API-Key`. Инструменты, завязанные на WebSocket, а также на локальную
    файловую систему и процессы, выбрасывают понятную ошибку `CLOUD_UNSUPPORTED`.

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

    <Note>
      Облачный режим пропускает автоопределение локального `COMFYUI_PATH` и использует
      собственную библиотеку моделей облака. Инструменты, которым нужен локальный процесс или
      файловая система, выбрасывают `CLOUD_UNSUPPORTED`; остальные не падают, а работают в
      урезанном виде — `list_local_models` возвращает пустой список, а `apply_manifest`
      сообщает `skipped`/`failed` по каждому элементу вместо того, чтобы завершиться ошибкой
      целиком. Полная матрица соответствия возможностей — на странице
      [Конфигурация](/docs/docs/configuration#deployment-modes).
    </Note>

    <Note>
      **Только облако?** [Comfy Cloud MCP от Comfy-Org](https://docs.comfy.org/agent-tools) (публичная бета) — канонический выбор, см. [Локально vs. Comfy Cloud](/docs/docs/local-vs-comfy-cloud). Облачный режим `comfyui-mcp` пригодится, если вам нужен один MCP сразу для локального / удалённого / облачного варианта или поддержка облака нужна уже сегодня.
    </Note>
  </Tab>
</Tabs>

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

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

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

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

```bash theme={null}
npx -y comfyui-mcp@latest connect
```

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

Управляете **удалённым** ComfyUI — облачным подом или другой машиной в локальной сети?
Запустите ту же команду на **своей машине**, а не на удалённой, и передайте URL:

```bash theme={null}
npx -y comfyui-mcp@latest connect https://your-pod-url
```

Вход у провайдера и сам агент остаются локальными; на удалённый хост ничего не
устанавливается. Подробности про туннель — в разделе
[Развёртывание в облаке](/docs/docs/cloud-deployment).

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

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

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

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

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

```bash theme={null}
git clone https://github.com/artokun/comfyui-mcp
cd comfyui-mcp
npm install
npm run build
npm link
```

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