Удалённый / размещённый коннектор

comfyui-mcp говорит на том же транспорте MCP Streamable-HTTP, который используют размещённые коннекторы (например, собственный Custom Connector Comfy cloud.comfy.org/mcp). Одной командой он работает как сервер с токен-аутентификацией за публичным HTTPS-туннелем, так что его можно добавить в Claude Desktop → Connectors или вызывать headlessly откуда угодно.

Это opt-in. Транспорт stdio по умолчанию (и обычный --http на loopback) ведёт себя как раньше — открытый и локальный. Аутентификация и туннель включаются, только когда вы задаёте токен или передаёте --tunnel.

Хотите управлять удалённым подом ComfyUI (например, RunPod) панелью агента вместо этого? Это другая возможность — см. Развёртывание в облаке. Эта страница про то, как выставить сам MCP-сервер comfyui-mcp удалённым клиентам вроде Claude Desktop; она вообще не трогает ComfyUI и мост панели. Оба под капотом используют быстрый туннель cloudflared — самый простой способ их перепутать.

Туннель одной командой

npx -y comfyui-mcp@latest --tunnel

Это делает четыре вещи:

Принудительно включает HTTP-транспорт (MCP_TRANSPORT=http).
Генерирует сильный случайный токен аутентификации, если вы его не задали.
Поднимает быстрый туннель cloudflared к локальному порту MCP.
Печатает готовый к вставке блок: публичный URL https://…/mcp, токен и фрагмент коннектора Claude Desktop.

Вывод выглядит так:

════════════════════════════════════════════════════════════════════
 ComfyUI MCP — Remote / Hosted Connector is LIVE
════════════════════════════════════════════════════════════════════
 Public MCP URL : https://shiny-otter-1234.trycloudflare.com/mcp
 Auth token     : 9f2c…<redacted>
 ...
════════════════════════════════════════════════════════════════════

Не закрывайте терминал. Быстрый туннель cloudflared эфемерен — его URL меняется на каждый запуск и закрывается вместе с процессом. Для стабильного имени хоста поднимите свой именованный туннель cloudflared, нацеленный на локальный HTTP-порт.

cloudflared не установлен?

cloudflared поставляется как необязательная зависимость. Если бинарник не найден, сервер продолжает работать локально и печатает подсказку по установке:

npm install -g cloudflared          # cross-platform
brew install cloudflared            # macOS
winget install cloudflare.cloudflared  # Windows

Затем перезапустите с --tunnel.

Добавить в Claude Desktop

Откройте Claude Desktop → Settings → Connectors → Add custom connector и заполните:

Поле	Значение
Name	`ComfyUI`
URL	напечатанный URL `https://…/mcp`
Header	`X-API-Key: <token>` (или `Authorization: Bearer <token>`)

Сохраните, затем включите коннектор в чате. Инструменты ComfyUI появляются точно так же, как у локального stdio-сервера.

Headless / программный конфиг

Любой MCP-клиент, который умеет удалённый сервер Streamable-HTTP, подойдёт. Передайте URL и заголовок аутентификации:

{
  "mcpServers": {
    "comfyui": {
      "url": "https://shiny-otter-1234.trycloudflare.com/mcp",
      "headers": { "X-API-Key": "<token>" }
    }
  }
}

Обе формы заголовка принимаются на каждом запросе к /mcp:

# X-API-Key (matches Comfy Cloud's convention)
curl -H "X-API-Key: <token>" https://…/mcp

# Authorization: Bearer
curl -H "Authorization: Bearer <token>" https://…/mcp

Ручная настройка (свой туннель / прокси)

Если публичную конечную точку вы предпочитаете вести сами, запустите HTTP-транспорт с фиксированным токеном и поставьте его за своим reverse-прокси, туннелем или VPN:

COMFYUI_MCP_HTTP_TOKEN=my-long-random-secret \
  npx -y comfyui-mcp@latest --http --host 0.0.0.0 --port 9100

Затем нацельте туннель/прокси на http://127.0.0.1:9100/mcp.

Привязка к непетлевому хосту (например, 0.0.0.0) без токена — это жёсткий отказ: сервер не стартует, вместо того чтобы выставить открытый эндпоинт /mcp за пределы машины. Задайте COMFYUI_MCP_HTTP_TOKEN (рекомендуется), используйте --tunnel или привяжитесь к петлевому хосту. Если вам действительно нужен открытый эндпоинт (например, за своим аутентифицирующим прокси), явно согласитесь через --allow-unauthenticated-non-loopback (env COMFYUI_MCP_ALLOW_UNAUTH=1), который снижает отказ до предупреждения.

Справка по аутентификации

Настройка	Эффект
`COMFYUI_MCP_HTTP_TOKEN`	Общий секретный токен, обязательный на `/mcp`. Не задан → эндпоинт открыт.
`--token <value>`	То же, что переменная окружения; флаг CLI побеждает переменную.
`--tunnel` / `MCP_TUNNEL=1`	Принудительно HTTP, автогенерация токена если не задан, открыть туннель cloudflared.
`--http` / `MCP_TRANSPORT=http`	HTTP-транспорт без туннеля (аутентификация всё равно действует, если задан токен).
`--host`, `--port`	Адрес привязки (по умолчанию `127.0.0.1:9100`).
`--allow-unauthenticated-non-loopback` / `COMFYUI_MCP_ALLOW_UNAUTH=1`	Согласие на ОТКРЫТЫЙ `/mcp` на непетлевом хосте. Без этого эта комбинация — жёсткий отказ при старте.

Токены сравниваются за постоянное время, и шлюз применяется на каждом HTTP-методе (POST/GET/DELETE) на эндпоинте MCP. Привязка непетлевого хоста без токена отклоняется при старте, пока не задан аварийный люк выше.

Дорожная карта: OAuth

Сегодняшняя аутентификация — ручной общий секретный токен (Bearer / X-API-Key), который покрывает и headless, и путь Custom Connector Claude Desktop. Полноценный браузерный вход OAuth (как у размещённого коннектора Comfy) — запланированное продолжение: это более тяжёлое изменение и для ручного подключения не требуется.

См. также

Развёртывание в облаке — управляйте удалённым подом ComfyUI панелью агента (другой туннель, другая цель)
Настройки — полный справочник переменных окружения

​Туннель одной командой

​cloudflared не установлен?

​Добавить в Claude Desktop

​Headless / программный конфиг

​Ручная настройка (свой туннель / прокси)

​Справка по аутентификации

​Дорожная карта: OAuth

​См. также

Туннель одной командой

cloudflared не установлен?

Добавить в Claude Desktop

Headless / программный конфиг

Ручная настройка (свой туннель / прокси)

Справка по аутентификации

Дорожная карта: OAuth

См. также