Higgsfield MCPをClaude Codeで使う｜画像・動画生成を自動化
「Claude Code から Higgsfield の画像・動画生成を直接呼び出したい」と考えて検索した方に向けて、本記事では接続方法を整理します。Higgsfield は Soul 2.0 や Kling 3.0 など 30 以上のモデルを束ねる生成プラットフォームで、MCP・CLI・スキルの 3 つの入口が公式・コミュニティから提供されています。それぞれのセットアップ手順と使い分け、料金の考え方までを順番に見ていきます。
Higgsfield は MCP サーバー(mcp.higgsfield.ai)を Claude Code に追加するだけで、API キーなしに 30 以上のモデルで画像(最大 4K)・動画(最大 15 秒)を生成できる。大量生成には公式 CLI、定型ワークフローにはコミュニティ製 19 スキルが向いているとわかる。
Contents (8)
Higgsfield とは — 30 以上の生成モデルを束ねるプラットフォーム
Higgsfield は、画像・動画生成に特化した統合プラットフォームです。公式の MCP ページによると、Soul 2.0、Kling 3.0、Seedance 2.0、Nano Banana Pro、GPT Image 2、Seedream 4.5、Veo 3.1、Cinema Studio 3.0 を含む 30 以上のモデルを 1 つのアカウントで利用できます。
生成仕様は次のとおりです。
- 画像: テキストまたは参照画像から最大 4K 解像度で生成
- 動画: 最大 15 秒、複数のシネマティックスタイルに対応
- キャラクター: Soul 学習により同一人物の一貫した生成が可能
個別モデルの API を契約しなくても、Higgsfield のプランに含まれるクレジットを消費する形でこれらすべてにアクセスできる点が最大の特徴です。
Claude Code から使う 3 つの方法
Higgsfield を Claude Code に接続する入口は 3 つあります。
- MCP サーバー: 公式提供。設定 1 行で接続でき、対話の中で「画像を作って」と頼むだけで生成が走る
- 公式 CLI: npm でインストールするコマンドラインツール。公式 CLI ページは「MCP 経由より高速・低コスト・シンプル」と説明しており、大量生成の自動化に向く
- コミュニティ製スキル: GitHub 公開の 19 スキルパック。UGC 広告など定型パイプラインをコマンド 1 つで再現できる
まず MCP で試し、生成量が増えたら CLI、決まった型の量産にはスキル、という順で導入するのが現実的です。
MCP セットアップ — 1 コマンドで接続
Claude Code への MCP 追加は次の手順で完了します。
- ターミナルで
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcpを実行する - Claude Code を起動し、初回利用時に Higgsfield アカウントでサインインして認証する
- 「Generate an image with Higgsfield」のように自然言語で指示する
API キーの発行・管理は不要で、ブラウザ経由の OAuth 認証だけで接続できます。認証後は単一セッション内で画像生成・動画作成・キャラクター学習まで連続して指示でき、生成物の確認と修正指示を対話のまま繰り返せるのが MCP 方式の強みです。
なお、Claude Code 以外にも Claude の Web 版や Cursor など MCP 対応クライアント全般で同じサーバー URL が使えます。
公式 CLI セットアップ — 大量生成・自動化向け
スクリプトからの呼び出しや数十件単位の量産には公式 CLI が向きます。
npm install -g @higgsfield/cliでインストールするhiggsfield auth loginを実行するとブラウザが開き、数秒で認証が完了する- Claude Code から CLI コマンドを組み合わせたシェルスクリプトを書かせ、バッチ生成を回す
公式ページは CLI を「MCP より高速・低コスト」と位置づけています。MCP はツール呼び出しごとに対話コンテキストを消費しますが、CLI ならループ処理をシェル側に逃がせるため、Claude Code のトークン消費を抑えながら大量生成できます。また npx skills add higgsfield-ai/skills で公式スキル(Generate、Product Photoshoot、Soul ID など)を追加する導線も用意されています。
コミュニティ製 19 スキルパック — UGC 動画まで自動化
さらに踏み込んだ自動化として、AKCodez/higgsfield-claude-skills が 19 個の Claude Code スキルを公開しています。構成は次のとおりです。
- UGC パイプライン系(3 個): キャラクター画像生成から動画完成までの統合ワークフロー
- 動画自動化(1 個): Seedance 2.0 の自動生成
- クリエイティブスタイル(6 個): シネマティック・3D CGI・カートゥーン・コミック・アクション・アニメ風のプロンプト生成
- 商用マーケティング(5 個): モーションデザイン広告・e コマース・360°製品・ソーシャルフック・ブランドストーリー
- 業界別(4 個): ミュージックビデオ・ファッションルックブック・食品飲料・不動産
導入はリポジトリをクローンして各サブフォルダを .claude/skills/ にコピーし、claude mcp add playwright で Playwright MCP を追加するだけです。このパックは Higgsfield の Web 画面を Playwright でブラウザ操作する方式のため、公式 MCP と違ってプロンプト入力から生成開始までを画面上で完全自動化します。たとえば /ugc-video-auto に商品名と形式(TikTok 縦型など)を渡すと、キャラクター生成から動画完成までが一気通貫で処理されます。
料金とクレジットの考え方
Higgsfield MCP・CLI とも追加料金の体系はなく、既存の Higgsfield プランのクレジットをそのまま消費します。消費量は使用するモデルと解像度によって変わるため、次の点を押さえておくと安全です。
- 高解像度(4K)や長尺(15 秒)ほどクレジット消費が大きい
- 量産前に低解像度・短尺でプロンプトを固め、本番生成の失敗を減らす
- バッチ生成は CLI 側でループさせ、Claude Code のトークン消費と分離する
無料アカウントでも接続自体は可能なので、まず小さく試してからプランを検討するのが良いでしょう。
つまずきやすいポイント
実際の導入で引っかかりやすい点を挙げます。
- 認証が通らない: MCP 追加後の初回ツール呼び出しでブラウザ認証が挟まります。ヘッドレス環境では認証済みのマシンでセットアップを済ませてから移す必要があります
- 生成が返ってこない: 動画生成は数秒〜数分かかります。タイムアウトではなく処理中の可能性が高いため、ステータス確認を挟んでください
- コミュニティスキルの安定性: Playwright によるブラウザ操作は Higgsfield 側の UI 変更で壊れることがあります。業務利用なら公式 MCP・CLI を主軸にするのが無難です
まとめ — 用途で入口を使い分ける
Higgsfield と Claude Code の組み合わせは、接続 1 行で 30 以上の生成モデルをコーディング環境に取り込めるのが魅力です。対話しながらの試作は MCP、スクリプト化した量産は CLI、UGC 広告など定型パイプラインはコミュニティスキルと、用途ごとに入口を使い分けてください。詳細は Higgsfield MCP 公式ページ、CLI ページ、スキルパックのリポジトリで確認できます。