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

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

Source: https://ailoot.ai/blog/ru/higgsfield-mcp-claude-code/
Canonical: https://ailoot.ai/blog/ru/higgsfield-mcp-claude-code/
Language: ru
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-120
Revision: sha256-6dcd7ee9d1472209ec712a9014c8cb14765ff1f434745dcb720510280c015732


Официальный 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.

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевые сведения раздела">

## Главное

Добавьте сервер в терминале командой `claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp`. Затем в Claude Code введите `/mcp`, выберите `higgsfield` и войдите в аккаунт Higgsfield в браузере. API-ключ не требуется. Убедитесь в подключении командой `claude mcp list`: возле сервера должен отображаться статус ✔ Connected. Генерации оплачиваются кредитами аккаунта Higgsfield, поэтому попросите агента сначала показать стоимость и согласовать число попыток. Когда генерации не нужны, отключите сервер переключателем в `/mcp`: MCP использует контекст и лимиты Claude Code.

</div>

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

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

```bash
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 — в [отдельной статье](https://ailoot.ai/blog/ru/mcp-servers-claude-code/).

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

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

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

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

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

```bash
claude mcp list
```

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

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

```bash
claude mcp get higgsfield
```

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Через MCP расходуются кредиты аккаунта Higgsfield, а работа сервера использует лимиты Claude Code. Таким образом, есть два счётчика расходов. О расходе токенов Claude Code подробнее рассказано [в отдельной статье](https://ailoot.ai/blog/ru/where-claude-code-tokens-go/):

| Что расходуется | За что | Где проверить | Как сократить расход |
|----|----|----|----|
| Лимиты Claude Code | Названия инструментов и инструкции сервера в контексте, ваши сообщения и работа агента | Лимиты вашей подписки Claude Code | Подключать сервер только в проекте для генераций и отключать его, когда работы с медиа нет |
| Кредиты Higgsfield | Каждая генерация изображения или видео | Аккаунт Higgsfield или запрос к агенту | Просить показать стоимость и согласовывать число попыток для каждой задачи |

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

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

По умолчанию в Claude Code работает [поиск инструментов](https://ailoot.ai/blog/ru/claude-code-tool-search-mcp-limit/). При запуске сессии загружаются названия инструментов и инструкции сервера, а полные описания появляются по мере необходимости. Если 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 | `claude mcp add` с адресом `https://mcp.higgsfield.ai/mcp`, затем вход в аккаунт через браузер | Устанавливать программу не нужно. Пока сервер включён, он использует контекст |
| Программа Higgsfield и навыки | `npm i -g @higgsfield/cli`, затем `higgsfield auth login` (вход в браузере), затем `npx skills add higgsfield-ai/skills` | Этот способ Higgsfield предлагает для Claude Code и Codex. Постоянный MCP-сервер в контексте не требуется |

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

**Следующий шаг:** в подключённом аккаунте Higgsfield выполните описанную выше проверку инструментов, моделей и стоимости в кредитах без генерации. До первого запуска выберите один результат и предел попыток. Для отдельной работы через Ailoot API используйте [руководство по запросу изображения](https://ailoot.ai/docs/en/api/images/) или [руководство по видеозадаче и результату](https://ailoot.ai/docs/en/api/video-music/): это другой API-процесс и аккаунт, а не подключение Higgsfield MCP.

<div class="section">

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

**Нужен ли API-ключ для Higgsfield MCP?**

Нет. Войдите в аккаунт Higgsfield через браузер: в Claude Code введите `/mcp`, выберите `higgsfield` и завершите вход.

**Какова стоимость видео через Higgsfield MCP?**

Она зависит от выбранной модели; кредиты списываются с аккаунта Higgsfield. Попросите агента назвать стоимость до начала генерации и дождаться вашего согласия.

</div>

<div class="section" role="doc-bibliography" aria-label="Список источников">

### Источники

- [Higgsfield: страница MCP](https://higgsfield.ai/mcp) — адрес сервера `mcp.higgsfield.ai/mcp`, вход через аккаунт, а также способ настройки с программой Higgsfield и навыками для Claude Code и Codex.
- [Anthropic: Claude Code и MCP](https://code.claude.com/docs/en/mcp) — команды `claude mcp add`, `list`, `get` и `remove`, параметр `--scope`, переключатель в `/mcp`, поиск инструментов и загрузка описаний в контекст.

</div>



<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Руководства Ailoot">

[Руководства Ailoot](https://ailoot.ai/docs/)

</div>

<div class="aside" data-semantic="ailoot-cta" role="note" aria-label="Перейти на Ailoot">

[Перейти на Ailoot](https://ailoot.ai/)

</div>

## Вопросы и ответы

### Что сделать перед первой платной генерацией в Higgsfield?

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

### Подтверждает ли Connected успешную генерацию видео?

Нет. Это подтверждение подключения MCP после входа в аккаунт. Для генерации ещё нужны разрешённая задача, кредиты аккаунта и проверка возвращённого изображения или видео. Отключайте MCP-сервер, когда этот процесс не используется.


## Ailoot · Компания и портфель её проектов

Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.