MCP 経由で Higgsfield を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Higgsfield をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Higgsfield + Gemini

ご自身の API キーで、AI に Higgsfield の画像と動画を生成させます。SOUL のポートレート、Marketing Studio と Ads Studio の商品画像、Seedance、Kling 3.0、Cinema Studio の動画、さらに 80 以上のモデルに対応し、毎回の実行前の料金見積もり、ステータス確認、キャンセルもできます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

HIGGSFIELD_API_KEY_ID, HIGGSFIELD_API_KEY_SECRET

ステップ 1 — 認証情報を取得

セットアップは約 3 分です。API クレジットのある Higgsfield Console のアカウントと API キーが必要です。すべての生成はその残高から請求されます。

1. https://console.higgsfield.ai にサインインし、API 残高をチャージします（従量課金）。クレジットがないと、生成は 403 で拒否されます。
2. Console で API keys を開き、キーを作成します。キーは key ID と secret の 2 つの部分からなります。secret は一度しか表示されないので、すぐにコピーしてください。
3. key ID を HIGGSFIELD_API_KEY_ID に、secret を HIGGSFIELD_API_KEY_SECRET に、それぞれ単独で貼り付けます。コロンや Key という語は付けません。コネクタが 2 つを Authorization: Key <id>:<secret> ヘッダーにまとめ、api.higgsfield.ai にだけ送信します。
4. コネクタをインストールします。インストール時に SOUL のスタイル一覧を取得してキーを確認します。これは無料で、higgsfield_list_soul_styles でいつでも同じ確認ができます。

生成できるもの: 画像は SOUL V2（フォトリアルなポートレート、ファッション、エディトリアル。SOUL のスタイルや、学習済みの Soul ID キャラクターも使えます）、Marketing Studio（キャンペーン画像と商品画像、最大 16 枚の参照画像を使った編集、プリセットからの広告）、Ads Studio（ブリーフと任意の商品写真から 1 から 8 個の広告コンセプト）です。動画は Seedance 2.5（テキスト、画像、参照メディアから）、Kling 3.0（Standard、Pro、4K の各ティア、ネイティブ音声付き）、Cinema Studio 4.0 です。Wan、MiniMax、Hailuo、Grok Imagine、Recraft、Ideogram など 80 以上のほかのモデルは、docs.higgsfield.ai のモデルページにあるエンドポイント ID を指定して higgsfield_generate で実行します。

無料で読み取れるもの: リクエストのステータスと出力、料金の見積もり、SOUL のスタイル、Marketing Studio のプリセット、学習状況を含むあなたの Soul ID キャラクターです。

生成のたびにクレジットを消費するため、AI はまず見積もって確認します: 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 を実行する前に、AI は同じモデルと入力で higgsfield_estimate_cost を実行し、どのモデルを使い、いくらかかるかを伝えて、あなたの承認を待ちます。確認なしに複数の生成をループで実行することはありません。動画は画像よりはるかに高く、長さ、解像度、ティアに応じて上がります。1 回のバッチで 4 枚の画像を作ると、1 枚のおよそ 4 倍かかります。失敗したリクエストとモデレーションで拒否されたリクエスト（nsfw）は請求されません。higgsfield_cancel_request の前にも AI は確認します。

インストール時はオフ: なし。有料のツールはすべて料金の見積もりとあなたの確認を経て実行され、キャンセルはまだ開始していないリクエストにしか効きません。

リクエストから結果まで: 生成リクエストには、すぐに request_id とステータス queued が返ります。AI は 5 から 10 秒ごとに higgsfield_get_request_status で確認します。画像は数秒、動画はたいてい数分かかります。受け取るのは画像、動画、音声へのリンクで、ファイルではありません。リンクは少なくとも 7 日間有効なので、残したいものはダウンロードしてください。キャンセルできるのはキューで待機中のリクエストだけで、その場合はクレジットが返金されます。処理が始まったリクエストは完了時に請求されます。タイムアウト後に同じ idempotency_key で再試行すると、2 回目の課金ではなく元のリクエストが返ります。

入力はリンク: 参照用の画像、動画、音声は公開 HTTPS URL で渡します。コネクタはお使いのパソコンからファイルをアップロードできません。

制限: 主な制限は同時実行数、つまり同時にキューで待機中または実行中のリクエストの数です（多くは 4）。同時リクエストの上限に達したという 400 が返ったら、どれかが終わるまで待ちます。アカウントごとの制限は Console に表示されます。

よくあるエラー: 401 Invalid credentials は、key ID または secret が間違っている、入れ替わっている、または失効していることを示します。Console で新しいキーを作成してください。403 はクレジット不足です。404 は、リクエスト ID が存在しないか別のアカウントのものであるか、そのモデルをあなたのアカウントで使えないことを示します。422 は入力フィールドの欠落、綴りの誤り、範囲外の値で、エラーにフィールド名が示されます。423 または 503 はモデルが一時的にブロックまたは無効になっていることを示します。時間をおくか、別のモデルを選んでください。

このコネクタは、ファイルのアップロード、Webhook の受信、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 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Higgsfield のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「SOUL で、ゴールデンアワーの屋上に立つリネンのスーツ姿の女性をフォトリアルなポートレートにしてください。始める前に料金を教えてください。」
• 「新しいランニングシューズの写真です: https://example.com/shoe.jpg。Instagram キャンペーン用の広告コンセプトを 4 つ作ってください。」
• 「バリスタがスローモーションでラテアートを注ぐ短い動画を Kling 3.0 Pro で作ってください。いくらかかりますか？」
• 「この商品写真を Seedance で短い動画にしてください: https://example.com/bottle.jpg。先に見積もりを見せてください。」
• 「最後の動画はもうできましたか？ダウンロードできるようにリンクを送ってください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続