Higgsfield MCP в Claude Code: подключение и контроль расходов

Официальный MCP-сервер Higgsfield можно добавить в Claude Code одной командой claude mcp add с адресом https://mcp.higgsfield.ai/mcp. После подключения вы описываете задачу обычными словами, а агент обращается к Higgsfield, создаёт изображение или видео и показывает результат в окне Claude Code. Здесь действуют два вида расходов: кредиты аккаунта Higgsfield за генерации и лимиты Claude Code на работу сервера в контексте. Поэтому отключайте MCP, когда он не нужен.

Раньше приходилось открывать сайт Higgsfield, осваивать его интерфейс, составлять промпт, запускать генерацию, скачивать файл и переносить его в проект. С собственным MCP-сервером Higgsfield эту работу можно поручить Claude Code.

Теперь можно создавать материалы в Higgsfield через Claude Code, не переключаясь на сайт для каждой генерации.

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

Учитывайте, что агент может запустить много генераций, а оплата взимается за каждую. В каждой задаче указывайте бюджет и допустимое число попыток.

Ниже разберём подключение сервера, первую задачу, виды расходов и способы отключить MCP.

Шаг 1. Добавьте сервер Higgsfield командой claude mcp add#

Откройте терминал в папке проекта, где будете создавать изображения и видео, и выполните команду:

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

Адрес опубликован на официальной странице higgsfield.ai/mcp; скопируйте его кнопкой Copy connector URL.

Если не указывать флаг --scope, сервер добавится только для текущего проекта. С параметром --scope project он будет доступен всей команде проекта, а с --scope user — во всех ваших проектах.

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

Обзор других MCP-серверов для Claude Code — в отдельной статье.

Шаг 2. Войдите в аккаунт Higgsfield через /mcp#

Запустите Claude Code и введите /mcp. Выберите в списке higgsfield: откроется браузер, где нужно войти в аккаунт Higgsfield.

Плата за генерации будет списываться с этого аккаунта. До входа сервер вернёт ошибку 401: Claude Code обнаружит подключение, но не сможет им пользоваться.

Шаг 3. Убедитесь, что сервер подключён#

В терминале запустите:

claude mcp list

Возле higgsfield должен появиться статус ✔ Connected.

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

claude mcp get higgsfield

Если это не помогло, удалите сервер и добавьте его заново:

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

После повторного добавления снова войдите через /mcp. При удалении сервера Claude Code также стирает сохранённый вход, поэтому без повторной авторизации возникнет та же ошибка 401.

Как MCP-серверы расходуют контекст Claude Code?#

Сначала попросите агента показать возможности сервера, но пока ничего не создавать. Так вы узнаете о доступных инструментах и стоимости до расходов:

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

Затем опишите задачу. В конце каждой просьбы добавляйте условие: до платной генерации покажи стоимость и согласуй количество попыток.

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

Пример задачи для изображения на первом экране сайта:

Создай в Higgsfield изображение для первого экрана сайта моего продукта. Продукт: [ссылка]. Предложи объект, ракурс, цветовую гамму и окружение, которые помогут посетителю понять продукт. Оставь свободное место под заголовок и кнопку. Нужен горизонтальный формат. Сохрани готовый файл в папку images проекта.
Перед платной генерацией покажи стоимость, согласуй количество попыток и дождись моего «да».

Пример задачи для короткого видео на основе этого изображения:

Создай в Higgsfield короткое видео на основе изображения images/hero.png: камера медленно приближается к продукту, фон слегка движется. Предложи модель и спроси, какая длительность нужна. Подготовь 1 вариант.
Перед платной генерацией покажи стоимость, согласуй количество попыток и дождись моего «да».

Затем агент обращается к Higgsfield, составляет промпт, запускает генерацию и показывает результат в Claude Code. Уточнения и правки тоже можно описывать словами.

Какие модели доступны и за что взимается плата#

В Higgsfield собраны инструменты для генерации, а расход учитывается в кредитах согласно условиям аккаунта.

Чтобы узнать, какие модели доступны и сколько они стоят в кредитах на момент запроса, воспользуйтесь первым примером из предыдущего раздела.

Через MCP расходуются кредиты аккаунта Higgsfield, а работа сервера использует лимиты Claude Code. Таким образом, есть два счётчика расходов. О расходе токенов Claude Code подробнее рассказано в отдельной статье:

Сколько лимитов использует MCP-сервер и когда его отключать#

Каждый MCP-сервер использует лимиты: описания его инструментов занимают место в контексте модели.

По умолчанию в Claude Code работает поиск инструментов. При запуске сессии загружаются названия инструментов и инструкции сервера, а полные описания появляются по мере необходимости. Если Claude Code использует ваш ANTHROPIC_BASE_URL, поиск отключён, и описания загружаются целиком. В обоих случаях сервер занимает часть контекста сессии.

Большое количество MCP-инструментов может расходовать лимиты, даже если они не нужны. Отключайте серверы, которыми не пользуетесь, чтобы освободить контекст.

Включить и выключить сервер можно несколькими способами:

• Временно отключить. Используйте переключатель higgsfield в /mcp. Claude Code перестанет подключаться к серверу, но сохранит настройку и запомнит выбор для этого проекта.
• Удалить полностью. Выполните claude mcp remove higgsfield. Вместе с сервером удалится сохранённая авторизация аккаунта.
• Подключить снова. Воспользуйтесь переключателем в /mcp или ещё раз выполните claude mcp add, после чего войдите через /mcp.

Оставляйте сервер включённым, пока создаёте изображения и видео. Если работаете с кодом или текстами и генерация не нужна, отключите его.

Как выбрать способ работы с Higgsfield#

Официальная страница Higgsfield описывает подключение MCP-сервера, а также вариант с программой Higgsfield и навыками для Claude Code и Codex:

Можно начать с MCP-сервера: его добавляют одной командой, а подключение отключают переключателем. Если вы генерируете часто и хотите не держать сервер в контексте, рассмотрите программу Higgsfield и навыки.

Следующий шаг: в подключённом аккаунте Higgsfield выполните описанную выше проверку инструментов, моделей и стоимости в кредитах без генерации. До первого запуска выберите один результат и предел попыток. Для отдельной работы через Ailoot API используйте руководство по запросу изображения или руководство по видеозадаче и результату: это другой API-процесс и аккаунт, а не подключение Higgsfield MCP.