Higgsfield AI MCP: генерация картинок и видео из Claude, Codex и Cursor

higgsfield-ai/cursor-plugin· Проверено 13.11.2026· 37на GitHub

Даёт агенту генерацию в Higgsfield: картинки, видео и звук на моделях Seedance, Kling и других, апскейл, удаление фона, Soul-персонажи и баланс кредитов. Готовые файлы ложатся в Assets вашего аккаунта.

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

Удалённый сервер Higgsfield по адресу https://mcp.higgsfield.ai/mcp: вход через аккаунт Higgsfield, ключ API не нужен, генерации списывают кредиты подписки.

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

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

Аккаунт Higgsfield с активной платной подпиской

При первом подключении клиент открывает окно входа Higgsfield: войдите и разрешите доступ

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

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

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

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

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

[mcp_servers.higgsfield]
url = "https://mcp.higgsfield.ai/mcp"

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

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

{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

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

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

{
  "mcpServers": {
    "higgsfield": {
      "type": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

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

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

{
  "mcpServers": {
    "higgsfield": {
      "httpUrl": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

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

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

{
  "mcpServers": {
    "higgsfield": {
      "httpUrl": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "higgsfield": {
        "type": "remote",
        "url": "https://mcp.higgsfield.ai/mcp"
      }
    }
  }
}

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

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

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

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

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

{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

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

Собрать вместе с другими серверами в одном mcp.json →

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

generate_imageгенерирует картинку

generate_videoгенерирует видео

generate_audioгенерирует звук

models_exploreподбирает модель и параметры

jobs_waitждёт пакет генераций

get_workflow_instructionsзагружает готовый сценарий

Сторонний локальный сервер на Python поверх Higgsfield API: 85 моделей с параметрами, бесплатная оценка цены до запуска и обучение Soul ID; работает по ключу API.

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

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

Python 3.10 или новее и uv; без uv поставьте пакет командой pip install higgsfield-mcp-unified и запускайте higgsfield-mcp

Ключ Higgsfield API: ID и секрет

HIGGSFIELD_API_KEY

ID ключа: создайте ключ на open.higgsfield.ai в разделе API keys

HIGGSFIELD_SECRET

Секрет того же ключа с open.higgsfield.ai

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

Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.

HIGGSFIELD_API_KEYHIGGSFIELD_SECRET

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

claude mcp add --env 'HIGGSFIELD_API_KEY=<ID ключа>' --env 'HIGGSFIELD_SECRET=<секрет ключа>' --transport stdio higgsfield-mcp-unified \
  -- uvx --from higgsfield-mcp-unified higgsfield-mcp

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

[mcp_servers.higgsfield-mcp-unified]
command = "uvx"
args = ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"]

[mcp_servers.higgsfield-mcp-unified.env]
HIGGSFIELD_API_KEY = "<ID ключа>"
HIGGSFIELD_SECRET = "<секрет ключа>"

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

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "higgsfield-mcp-unified": {
        "type": "local",
        "command": ["uvx", "--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
        "environment": {
          "HIGGSFIELD_API_KEY": "<ID ключа>",
          "HIGGSFIELD_SECRET": "<секрет ключа>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "higgsfield-mcp-unified": {
      "command": "uvx",
      "args": ["--from", "higgsfield-mcp-unified", "higgsfield-mcp"],
      "env": {
        "HIGGSFIELD_API_KEY": "<ID ключа>",
        "HIGGSFIELD_SECRET": "<секрет ключа>"
      }
    }
  }
}

Собрать вместе с другими серверами в одном mcp.json →

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

list_modelsпоказывает модели и параметры

recommend_modelподбирает модель под задачу

validate_paramsпроверяет параметры до запуска

estimate_costсчитает цену в кредитах и долларах

preflight_checkпроверяет ключи

generate_imageгенерирует и правит картинки

generate_videoгенерирует видео

generate_batchзапускает пачку заданий

get_statusпроверяет статус задания

subscribeждёт готовый результат

cancel_jobотменяет задание в очереди

upload_imageзагружает картинку, WAV или MP4

list_model_presetsпоказывает пресеты модели

create_characterобучает Soul ID по фото

list_charactersперечисляет персонажей

get_balanceпоказывает баланс

Показано 16 из 22.

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

«Сгенерируй видео моделью Seedance: человек идёт по лесу на рассвете, камера следует вплотную»Агент вызовет generate_video; если модель или параметры неясны, сначала models_explore

«Какой у меня баланс кредитов Higgsfield? Покажи последние генерации»Агент вызовет инструменты аккаунта Higgsfield и вернёт баланс и список генераций

«Перед каждой генерацией называй цену в кредитах и жди моего подтверждения»Агент будет сначала сообщать стоимость и запускать generate_image или generate_video только после вашего ответа

«Сделай 60-секундное faceless-видео про <тема>»Агент вызовет get_workflow_instructions, загрузит подходящий сценарий и пройдёт его шаги

«Сколько будет стоить <запрос> моделью <модель>? Если меньше <N> кредитов, запускай»higgsfield-mcp-unified вызовет estimate_cost, затем generate_image или generate_video и subscribe для результата

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

Сгенерировать картинку или видео нужной моделью, например Seedance или Kling 3.0

Сделать озвучку текста, клонировать или сменить голос, дублировать видео

Увеличить разрешение, убрать фон, расширить кадр картинки или видео

Нарезать видео с YouTube на короткие клипы через Personal Clipper

Обучить Soul-персонажа по фото и снимать его в новых сценах

Проверить баланс кредитов и найти прошлые генерации и загрузки

Ограничения

Higgsfield MCP подключается только при платной подписке, и каждая генерация списывает кредиты по обычным ценам: Unlimited и бесплатные генерации действуют только на сайте higgsfield.ai

Своего лимита расхода кредитов у сервера нет: агента можно попросить называть цену и ждать подтверждения, но это просьба в чате без жёсткого ограничения

Картинки, приложенные к чату, агент не видит: референсы уходят в Higgsfield через отдельное окно загрузки или по прямой ссылке

higgsfield-mcp-unified ведёт один автор, проект в стадии alpha; его экспериментальный режим для Sora 2, Veo 3 и Nano Banana ходит в закрытый бэкенд сайта по cookie, сделан обратной разработкой, и автор предупреждает, что это, вероятно, нарушает условия использования Higgsfield

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

Клиент пишет «Authorization with the MCP server failed»

Срок входа истёк. Отключите коннектор Higgsfield в настройках клиента, подключите заново и снова разрешите доступ.

Коннектор подключён, но агент не вызывает инструменты Higgsfield

Начните новый разговор и прямо упомяните Higgsfield. Проверьте, включён ли коннектор в текущем разговоре: в некоторых клиентах он включается отдельно.

Cursor или другой агент пишет «MCP HTTP exchange failed»

Временная ошибка связи: повторите запрос. Если ошибка не уходит, отключите и снова подключите сервер в настройках агента.

Генерация не появилась в Assets

Подождите до 60 секунд и проверьте Manage Account → Usage. Если кредиты списались, а результата нет, напишите в поддержку с ID генерации и временем запуска.

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

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Higgsfield MCPразработчик сервиса	Higgsfield AI	37	HTTP	вход	6	22 августа 2026
higgsfield-mcp-unified	Hikhakk	105	локально	токен	22	17 октября 2026

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

Сколько стоят генерации через Higgsfield MCP?

Каждая генерация списывает кредиты по обычным ценам, какой бы ни был тариф. Безлимитные модели и бесплатные генерации работают только на сайте higgsfield.ai. Перед работой можно спросить агента о балансе и попросить называть цену каждой генерации.

Как передать агенту свою картинку для референса?

Скажите агенту, что хотите использовать файл с компьютера: он откроет окно загрузки Higgsfield прямо в разговоре. Картинку из интернета передайте прямой ссылкой, прошлую генерацию, Soul-персонажа или Element назовите по имени.

Где искать готовые картинки и видео?

В Assets на higgsfield.ai с пометкой источника MCP, обычно в течение 60 секунд после окончания задания. Если кредиты списались, а файла нет, проверьте Manage Account → Usage и напишите в поддержку с ID генерации.

Чем higgsfield-mcp-unified отличается от Higgsfield MCP?

Он запускается у вас на компьютере и работает по ключу Higgsfield API, отдельного продукта для разработчиков с оплатой по запросам. Взамен даёт estimate_cost для бесплатной оценки цены, проверку параметров и вебхуки.

Можно подключить Higgsfield сразу в нескольких агентах?

Да, один аккаунт Higgsfield можно одновременно подключить в Claude, ChatGPT, Cursor и других агентах. Кредиты у них общие.

Нужно ли ставить Higgsfield MCP через npm install -g?

Нет, Higgsfield MCP работает на серверах Higgsfield и подключается адресом https://mcp.higgsfield.ai/mcp. Команда npm i -g @higgsfield/cli ставит Higgsfield CLI: его Higgsfield предлагает для Claude Code, OpenClaw и Hermes, после установки нужен вход higgsfield auth login.

Как подключить Higgsfield AI MCP к Claude?

В claude.ai или Claude Desktop откройте Settings → Connectors → Add custom connector, назовите коннектор Higgsfield и вставьте https://mcp.higgsfield.ai/mcp. Нажмите Connect и войдите в аккаунт Higgsfield.

Как подключить Higgsfield MCP к Codex?

Codex подключается как любой MCP-клиент: адрес https://mcp.higgsfield.ai/mcp прописывается в настройках агента, вход идёт через аккаунт Higgsfield. Готовый фрагмент есть во вкладке Codex в блоке «Как подключить».

Что за npm-пакет @higgsfield/video-editor-mcp?

Это Higgsfield Video Editor для Claude Desktop: локальный MCP-сервер, который монтирует видеопроекты на вашем Mac, открытого репозитория у пакета нет. Нужны Mac, Claude Desktop, Node.js 22.13 или новее и ffmpeg; ставится командой npx -y --registry=https://registry.npmjs.org @higgsfield/video-editor-mcp@latest setup.

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

Генерация идёт на серверах Higgsfield: нужен аккаунт Higgsfield с платной подпиской, а для higgsfield-mcp-unified — ключ Higgsfield API с оплатой по запросам в долларах США.