Как подключить Higgsfield к Microsoft Copilot через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Higgsfield, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Higgsfield + Microsoft Copilot

Дайте ИИ создавать изображения и видео в Higgsfield с вашим собственным API-ключом: портреты SOUL, изображения товаров в Marketing Studio и Ads Studio, видео в Seedance, Kling 3.0 и Cinema Studio и ещё более 80 моделей, с оценкой стоимости перед каждым запуском, проверкой статуса и отменой.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

HIGGSFIELD_API_KEY_ID, HIGGSFIELD_API_KEY_SECRET

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужны аккаунт в Higgsfield Console с кредитами API и API-ключ. Каждая генерация списывается с этого баланса.

1. Войдите на https://console.higgsfield.ai и пополните баланс API (pay as you go). Без кредитов генерации отклоняются с кодом 403.
2. В Console откройте API keys и создайте ключ. Он состоит из двух частей: key ID и secret. Secret показывается только один раз, поэтому скопируйте его сразу.
3. Вставьте key ID в HIGGSFIELD_API_KEY_ID, а secret в HIGGSFIELD_API_KEY_SECRET, каждый отдельно, без двоеточия и без слова Key. Коннектор сам объединяет их в заголовок Authorization: Key <id>:<secret> и отправляет его только на api.higgsfield.ai.
4. Установите коннектор. При установке ключ проверяется запросом списка стилей SOUL, это бесплатно; ту же проверку можно в любой момент повторить через higgsfield_list_soul_styles.

Что он создаёт: изображения в SOUL V2 (фотореалистичные портреты, мода и editorial, при желании в стиле SOUL или с одним из ваших обученных персонажей Soul ID), Marketing Studio (кампании и изображения товаров, правки с использованием до 16 референсных изображений или реклама по пресету) и Ads Studio (бриф и, при желании, фото товара превращаются в рекламные концепции, от 1 до 8). Видео в Seedance 2.5 (из текста, из изображения или по референсам), Kling 3.0 (уровни Standard, Pro или 4K, со встроенным звуком) и Cinema Studio 4.0. Любая другая из более чем 80 моделей, например Wan, MiniMax, Hailuo, Grok Imagine, Recraft или Ideogram, запускается через higgsfield_generate по её endpoint ID со страницы модели на docs.higgsfield.ai.

Что он читает бесплатно: статус и результат запроса, оценки стоимости, стили SOUL, пресеты Marketing Studio и ваших персонажей Soul ID со статусом обучения.

Каждая генерация тратит кредиты, поэтому ИИ сначала оценивает стоимость и спрашивает: перед higgsfield_soul_image, higgsfield_marketing_studio_image, higgsfield_ads_studio, higgsfield_seedance_text_to_video, higgsfield_seedance_image_to_video, higgsfield_seedance_reference_to_video, higgsfield_kling_text_to_video, higgsfield_kling_image_to_video, higgsfield_cinema_studio_video или higgsfield_generate ИИ запускает higgsfield_estimate_cost с той же моделью и теми же входными данными, называет модель и стоимость и ждёт вашего согласия. Он никогда не запускает несколько генераций в цикле, не спросив. Видео стоит намного дороже изображений и дорожает с длительностью, разрешением и уровнем; четыре изображения в одном пакете стоят примерно вчетверо дороже одного. Неудачные запросы и запросы, отклонённые модерацией (nsfw), не оплачиваются. Перед higgsfield_cancel_request ИИ тоже спрашивает.

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

От запроса к результату: генерация сразу отвечает request_id и статусом queued. ИИ проверяет higgsfield_get_request_status каждые 5-10 секунд; изображения готовы за секунды, видео обычно за минуты. Вы получаете ссылки на изображения, видео или аудио, а не файлы. Ссылки доступны не меньше семи дней, поэтому скачайте то, что хотите сохранить. Отменить запрос можно, только пока он в очереди, и тогда кредиты возвращаются; если он уже выполняется, он будет оплачен по завершении. После тайм-аута повтор с тем же idempotency_key возвращает исходный запрос, а не второй, оплачиваемый.

Входные данные это ссылки: референсные изображения, видео и аудио передаются как публичные HTTPS-ссылки. Коннектор не может загружать файлы с вашего компьютера.

Ограничения: главное ограничение это параллельность, то есть число запросов, которые одновременно ждут в очереди или выполняются (часто 4). Ответ 400 о том, что достигнут максимум одновременных запросов, означает, что нужно дождаться завершения одного из них. Лимиты вашего аккаунта показаны в Console.

Частые ошибки: 401 Invalid credentials означает, что key ID или secret неверны, перепутаны местами или отозваны: создайте новый ключ в Console. 403 означает, что не хватает кредитов. 404 означает, что такого id запроса нет или он принадлежит другому аккаунту, либо модель недоступна вашему аккаунту. 422 означает, что поле входных данных отсутствует, написано с ошибкой или вне допустимого диапазона, и в ошибке оно названо. 423 или 503 означает, что модель временно заблокирована или отключена: попробуйте позже или выберите другую модель.

Коннектор не загружает файлы, не принимает вебхуки, не обучает персонажей Soul ID, не использует Agent API и не видит проекты и историю веб-приложения Higgsfield.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Higgsfield.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

Примеры запросов

• «Создай в SOUL фотореалистичный портрет женщины в льняном костюме на крыше в золотой час. Назови цену до того, как начнёшь.»
• «Вот фото наших новых беговых кроссовок: https://example.com/shoe.jpg. Сделай из него 4 рекламные концепции для кампании в Instagram.»
• «Сделай короткое видео в Kling 3.0 Pro, где бариста в замедленной съёмке рисует латте-арт. Сколько это будет стоить?»
• «Оживи это фото товара в короткое видео через Seedance: https://example.com/bottle.jpg. Сначала покажи оценку стоимости.»
• «Моё последнее видео уже готово? Пришли ссылку, чтобы я мог его скачать.»

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse