higgsfield-mcp-server

Удалённый MCP-сервер, который позволяет Claude генерировать изображения и видео через API Higgsfield AI — фотореалистичные фотографии (Soul), изображения по референсам (Popcorn) и видео (Google Veo 3.1, Kling, ByteDance Seedance) — прямо из чата.

Доступные инструменты

Все инструменты генерации асинхронны: они немедленно возвращают request_id; вызывайте higgsfield_check_status (Claude сделает это автоматически), пока задание не будет completed.

Related MCP server: higgsfield-mcp

1. Получите свои ключи API Higgsfield

1. Перейдите на https://cloud.higgsfield.ai и войдите в систему.

2. Создайте ключ API (вы уже сделали это, если читаете это после того, как попросили Клода о помощи) — вы получите API Key ID и API Key Secret. Скопируйте оба, они показываются только один раз.

2. Разверните этот сервер (бесплатный тариф подходит)

Вам нужно место, где Node-процесс будет работать 24/7 и будет доступен по HTTPS. Два бесплатных варианта, не требующих кредитной карты для такого небольшого сервера:

Вариант A: Render.com

1. Запушьте эту папку в новый репозиторий GitHub (можно приватный).

2. На https://render.com → New + → Web Service → подключите этот репозиторий.

3. Настройки:

   • Runtime: Node

   • Build Command: npm install

   • Start Command: npm start

4. В разделе Environment добавьте три переменные:

   • HF_API_KEY_ID = ваш Higgsfield API Key ID

   • HF_API_KEY_SECRET = ваш Higgsfield API Key Secret

   • MCP_ACCESS_TOKEN = любая длинная случайная строка, которую вы придумаете (например, выполните openssl rand -hex 32 локально или просто наберите 40+ символов) — это пароль, который Claude будет использовать для связи с вашим сервером, чтобы никто другой не мог потратить ваши кредиты Higgsfield.

5. Разверните. Render выдаст вам URL вида https://higgsfield-mcp-server.onrender.com. Ваша MCP-конечная точка — это этот URL + /mcp, например https://higgsfield-mcp-server.onrender.com/mcp.

Примечание: бесплатные веб-сервисы Render засыпают после бездействия, и на следующий запрос уходит несколько секунд на пробуждение — для нечастого использования подходит.

Вариант B: Railway.app

Та же идея: новый проект из этого GitHub-репозитория, задайте те же три переменные окружения, Railway автоматически определит npm start. Вы получите URL вида https://higgsfield-mcp-server-production.up.railway.app, конечная точка — это URL + /mcp.

3. Добавьте его в Claude как пользовательский коннектор

В Claude (claude.ai / десктопное приложение) → Settings → Connectors → Add custom connector:

• Name: Higgsfield

• URL: https://<ваш-развёрнутый-url>/mcp

• Authentication: Bearer token → вставьте значение MCP_ACCESS_TOKEN, которое вы задали в шаге 2.

Включите его для своего чата, и Claude сможет вызывать указанные выше инструменты.

Локальное тестирование (необязательно)

cp .env.example .env   # fill in real values
npm install
npm start

Сервер слушает http://localhost:3000/mcp (или $PORT).

Замечания по безопасности

• HF_API_KEY_ID / HF_API_KEY_SECRET дают полный доступ к вашей учётной записи Higgsfield и биллингу. Они должны храниться только в переменных окружения хоста — никогда не коммитьте их и не вставляйте в URL.

• MCP_ACCESS_TOKEN — это то, что не даст случайному человеку, нашедшему URL вашего сервера, генерировать контент за ваши кредиты Higgsfield. Относитесь к нему как к паролю.

• Каждый вызов генерации расходует кредиты Higgsfield в соответствии с тарифами вашего плана.