Claude Code向けHiggsfield MCP：60秒セットアップ

Q: Higgsfield MCPとは？

Higgsfield MCPは https://mcp.higgsfield.ai/mcp にあるホステッドのModel Context Protocolサーバーで、7つの画像・動画生成モデル（GPT Image 2、Soul V2、Veo 3.1、Kling 3.0、Flux 2を含む）をMCP互換のAIクライアントに公開する。認証はHiggsfieldアカウントによるOAuthで、ホステッドサーバーにはAPIキー不要。

Q: Higgsfield MCPをClaude Codeにインストールするには？

ターミナルで claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp を実行する。初回利用時にClaude CodeがOAuth用にブラウザを開くので、Higgsfieldアカウントでサインインし、ターミナルに戻って claude mcp list かClaude Codeセッション内の /mcp スラッシュコマンドで確認する。通常の回線ならフロー全体は1分を大きく下回る。

Q: Higgsfield MCPはCodexやChatGPT Desktopで動くか？

OpenAIのCodex CLIなら動く。標準のMCPワイヤープロトコルを話すので、同じ mcp.json 設定がそのまま使える。ChatGPTデスクトップは、2026年5月時点では動かない。OpenAIはまだコンシューマー向けChatGPTアプリにMCPサポートを出していない。ホステッドHiggsfield MCPが公開していないSora 2やその他のOpenAIモデルが特に必要なら、コミュニティの統合フォークがそのギャップを埋められる。

Q: 生成をまたいでキャラクターの一貫性を得るには？

被写体の参照画像3〜5枚で createcharacter を使う。このツールは約3〜5分の学習後にキャラクターIDを返す。そのIDを以降の generateimage 呼び出しでSoul V2モデルとともに参照すれば、すべての生成で同じ顔が現れる。これがブログシリーズ、プロダクトマスコット、視覚的な連続性が必要なあらゆるプロジェクトでの主力パターンだ。

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

最終更新：2026年6月6日。 インストールコマンドとOAuthフローを再検証済み。モデル一覧（GPT Image 2、Soul V2、Veo 3.1、Kling 3.0、Flux 2、Nano Banana Pro、Seedance 2.0）も最新であることを確認。無料枠のクレジット付与（月150）も引き続き正確。

Higgsfield MCPをClaude Codeで使うには、ターミナルで claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp を実行する。 Claude CodeはブラウザのOAuth経由で認証を処理するため、APIキーは不要。このサーバーは5つのツール（generate_image、generate_video、create_character、get_generation_status、list_characters）を7つのモデルにわたって公開する。通常の回線ならセットアップは60秒以内で完了する。

Higgsfieldは2026年4月30日、つまりこれを書いている8日前にホステッドMCPサーバーをリリースした。Claude Codeがインストールされていれば、Higgsfield MCPをコマンド1つでワークフローに組み込める。APIキーもnpmパッケージも不要だ。この記事を読み終える頃には、実際に使っているすべてのAIクライアントにサーバーがインストールされ、7つのモデルのうちどれをいつ使えばいいかがわかり、ブログのヒーロー画像で私たちが頼りにしているプロンプトのレシピも手に入っているだろう。

techsy.ioではすでに4つのHiggsfieldエージェントスキル（higgsfield-generate、higgsfield-product-photoshoot、higgsfield-soul-id、higgsfield-marketplace-cards）をカバー画像やライフスタイル画像に使っており、会話の中でよりリッチな生成を行うためにMCPサーバーも並行して組み込んできた。MCPはコンテキストエンジニアリングがツール層で実際に姿を現す方法だ。URLやプロンプトを別のUIに貼り付ける代わりに、モデルがモデルとパラメータを、あなたが文章を書いているのと同じチャット内で選んでくれる。

クイックアンサー

Higgsfield MCPは https://mcp.higgsfield.ai/mcp にあるホステッドサーバーで、7つの画像・動画モデルをあらゆるMCPクライアントに公開する。

Claude Codeにはコマンド1つでインストール。認証はOAuthで、APIキーは不要。

Claude Code、Claude Desktop、Cursor、Windsurf、Cline、OpenCodeで動作する。

無料枠：月150クレジット（2026年5月時点）。それを超えると$1 = 16クレジット。

Higgsfield MCPは実際何をするのか

Higgsfield MCPは https://mcp.higgsfield.ai/mcp にあるホステッドのModel Context Protocol（MCP）サーバーで、MCP互換のAIクライアント（Claude Code、Claude Desktop、Cursor、Windsurf、Cline、OpenCode）ならどこからでも、OAuth認証で7つの画像・動画モデルを5つのツール経由で呼び出せる。APIキー不要、npmインストール不要、プロキシも不要。

Higgsfield MCPサーバーは、あなたのAIクライアントと30以上の生成モデルの間に位置する。ホステッドエンドポイントは、私たちが最もよく使う7つを公開している。キャラクターの一貫性にはSoul V2、動画にはVeo 3.1とKling 3.0、写真的なリアリズムにはGPT Image 2、イラストにはFlux 2、高速イテレーションにはNano Banana Pro、短いクリップにはSeedance 2.0。これらはすべて、チャットを離れることなくClaude Code内の別モデルとして呼び出せる。

モデル	種類	用途	1生成あたりのクレジット目安
GPT Image 2	画像	写真的リアリズム、プロダクト撮影	約8
Nano Banana Pro	画像	高速・低コストなイテレーション	約2
Soul V2	画像	キャラクターの一貫性（`create_character`と併用）	約10
Seedance 2.0	動画	動きのある短いクリップ	約30
Veo 3.1	動画	8〜15秒のシネマティックなクリップ	約60
Kling 3.0	動画	なめらかな動き、キャラクターのアクション	約50
Flux 2	画像	スタイライズ、イラスト調	約6

無料枠：月150クレジット。2026年5月時点の情報で、変更される可能性がある。

サーバーが公開する5つのツールが、機能のすべてだ。

generate_image：1発の画像生成
generate_video：非同期の動画生成。ジョブIDを返す
create_character：一貫性のためにSoul Characterを学習させる
get_generation_status：非同期ジョブをポーリングする
list_characters：学習済みキャラクターを一覧表示する

それだけだ。5つのツール、APIキー不要、覚えるべきスコープもなし。いくつものベンダーAPIを継ぎ接ぎするのと比べれば、MCP仕様が広まった理由が見えてくる。正式なモデル一覧はHiggsfield公式MCPページが信頼できる情報源だ。

Higgsfield MCPをClaude Codeに追加するには？

Higgsfield MCPをClaude Codeにインストールするには、claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp を実行する。初回利用時にClaude CodeがOAuth用にブラウザを開くので、Higgsfieldアカウントでサインインし、ターミナルに戻って claude mcp list か /mcp スラッシュコマンドで確認する。これでHiggsfield MCPのセットアップはすべて完了だ。

ここが、既存のチュートリアルのほとんどが間違えている部分だ。4月30日より前はホステッドサーバーが存在せず、筆者たちはnpmで何かパッケージをインストールして HIGGSFIELD_API_KEY をシェルに貼り付けるものだと思い込んでいた。実際は違う。ホステッドMCPはHiggsfieldのインフラで動作し、ブラウザのOAuthで認証する。

インストールコマンドはこれだ。ターミナルに貼り付けてほしい。

bash

claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

知っておくべきフラグが2つある。--transport http は、これがローカルのstdioプロセスではなくHTTPベースのホステッドサーバーであることをClaude Codeに伝える。--scope user は設定を ~/.claude/mcp.json に書き込むので、開くすべてのプロジェクトでサーバーが使えるようになる。1つのリポジトリだけで使いたい場合（gitにコミットしてチームにも反映させたい場合）は、代わりに --scope project を使う。これはリポジトリ直下の .mcp.json に書き込まれる。

うまくいったか確認する。

bash

claude mcp list
# Higgsfield   http   ✔ connected

Higgsfieldのツールを初めて呼び出すと、Claude Codeはポート8080でローカルのOAuthコールバックを起動し、ブラウザを開く。Higgsfieldアカウントでサインインしてターミナルに戻れば完了だ。Claude Codeのセッション内ならどこでも /mcp を実行すればパネルが表示される。Higgsfieldが5つのツールとともに表示されるはずだ。

これをタイプしているM3 Proでは、インストールからOAuthの往復まで47秒で完了した。ネットワーク環境によって差はあるが、2分を超えたら、後半の「落とし穴」セクションにすぐ飛んでほしい。

少し脱線するが、同じMCPをClaude Codeスキールの裏にラップしたいなら、robonuggetsの higgsfield-skill リポジトリがまさにそれをやっている。このパターンはClaude Codeスキルのチュートリアルで扱った。また、フックでMCPサーバーを自動化することもでき、たとえばブログのヒーロー画像生成の前に必ず list_characters を自動実行する、といったことが可能だ。正式なセットアップ構文については、Claude Code向けAnthropic公式MCPセットアップドキュメントがトランスポートの種類、スコープフラグ、再認証フローを網羅している。

Claude Codeセッション内の generate_image ツール呼び出し。

Higgsfield MCPをClaude Desktopに追加するには？

Claude Desktopは claude mcp add CLIの代わりにJSON設定ファイル（claude_desktop_config.json）を使う。場所はOSによって異なる。ファイルを編集してhiggsfieldブロックを追加し、Claude Desktopを完全に終了してから再起動する。OAuthは設定読み込み時ではなく、ツールを初めて呼び出したときに実行される。

OS	パス
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

これを書き込む。

json

{
  "mcpServers": {
    "higgsfield": {
      "transport": {
        "type": "http",
        "url": "https://mcp.higgsfield.ai/mcp"
      }
    }
  }
}

Claude Desktopにサーバーは表示されているのにツールが見えない場合、完全に終了していない。macOSでは赤い信号ボタンではなくCmd-Qを使う。ウィンドウを閉じただけでは、古い設定をメモリに抱えたままプロセスが動き続ける。

Higgsfield MCPのCursorセットアップ

higgsfield mcp cursorを使うには、~/.cursor/mcp.json を編集し、https://mcp.higgsfield.ai/mcp を指すHTTPトランスポートでhiggsfieldサーバーを追加する。Cursorを再起動すると、Settings → MCP Serversにサーバーが表示され、最初の生成リクエスト時にOAuthで認証される。同じJSONはプロジェクト直下の .cursor/mcp.json としても使える。

Cursorは url フィールドからHTTPトランスポートを自動検出するので、明示的に宣言する必要はない。設定は以下の通り。

json

{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

ファイルを保存してCursorを再起動し、Settings → MCP Serversを開く。緑のドット付きの「higgsfield」が表示されるはずだ。初めてCursorに「Higgsfieldを使ってゴールデンアワーのキツネのヒーロー画像を生成して」と頼むと、ブラウザが開いてOAuthが行われ、サインイン次第生成が実行される。

ヒーロー画像用に常にHiggsfieldを使うCursorルールと組み合わせよう。「blog hero」や「OG image」のリクエストを、デフォルトのアスペクト比付きの generate_image に割り当てるルールを .cursor/rules/blog-images.mdc に入れる。上級者向けのコツ：ユーザースコープのファイルを使う代わりに .cursor/mcp.json をリポジトリ直下にコミットすれば、チーム全員がpullするだけでサーバーが使えるようになる。開発者ごとのセットアップも、「ツールが表示されないのはなぜ？」というSlackのスレッドも不要だ。

Higgsfieldサーバーが登録されたCursorのmcp.json。

Higgsfield MCPをWindsurfやClineにインストールするには？

両方のクライアントがVS Code形式のmcp.jsonを使うので、同じJSONがそのまま使える。Windsurfは ~/.codeium/windsurf/mcp_config.json を読み、Cline（VS Code拡張機能）はSettings UIかワークスペース内の .vscode/mcp.json を使う。

json

{
  "mcpServers": {
    "higgsfield": {
      "type": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

脳裏に焼き付けておくべきClineのコツ：「Auto-approve safe tools」は list_characters と get_generation_status だけに有効化する。generate_video は自動承認しないこと。1回の呼び出しで30〜60クレジットが消費され、ループする自律エージェントが5分で無料枠を使い切ることがある。読み取り系ツールはOK、生成系ツールはNGだ。

日常的に2つのクライアントはどう違うのか気になるなら、Windsurf vs Cursorの比較記事がトレードオフを網羅している。Higgsfieldに関しては、サーバーが登録されてさえいれば体験は同じだ。両クライアントとも同じMCPワイヤープロトコルを話す。

Higgsfield MCPはOpenCodeで動くか？

動く。OpenCode（オープンソースの sst/opencode 製Claude Code代替）も同じMCPワイヤープロトコルを話す。設定はリポジトリ直下の .opencode/mcp.json か、ユーザースコープなら ~/.config/opencode/mcp.json に置く。フィールド名が1つだけClaude Codeと違うので、mcpServers ブロックを盲目的にコピペしないこと。

json

{
  "servers": {
    "higgsfield": {
      "transport": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

フィールドは mcpServers ではなく servers だ。よくある落とし穴である。設定を追加したのにOpenCodeにツールが表示されない場合、原因はほぼこれだ。opencode mcp list で確認できる。claude mcp list と同じ動きをする。OAuthフローも同じで、ブラウザが開き、コールバックがあり、完了だ。

MCP経由でHiggsfieldにプロンプトする最善の方法は？

私たちが見つけた中で最も信頼できるプロンプトのレシピは MCSLA（Model、Composition、Subject、Lighting、Aesthetic）だ。MCSLAシネマティックプロンプトスキルから来ており、曖昧な「ヒーロー画像を作って」を、Higgsfieldのモデルが実際に実行できるブリーフに変えてくれる。5つのフィールド、5行、毎回そうだ。

Model： まず適切なツールを選ぶ。リアリズムならGPT Image 2、繰り返し使うキャラクターならSoul V2、スタイライズならFlux 2。
Composition： ショットを構図する（「ワイドアングルのヒーロー構図、被写体は左三分割、右にネガティブスペース」）。
Subject： 画面内のものを具体的な属性付きで指定する（「黒いセラミックマグ、結露の水滴、風化したオーク材の上」）。
Lighting： 方向と質で指定する（「左上からの温かいリムライト、やわらかいフィル、深いブルーの影」）。
Aesthetic： 最終的なルック（「雑誌のエディトリアル、35mmフィルムの粒子感、SaaSマーケティング向けカラーグレーディング」）。

参照画像のチェインワークフローこそ、MCPが真価を発揮する場面だ。v1を生成し、それからClaudeに「もっとコントラストを強く、クールなパレットでやり直して」のように頼む。チャット履歴が画像URLを保持しているので、次の generate_image 呼び出しはそれを自動的に参照画像として渡す。Web UIを行き来する代わりに、会話の中でイテレーションできる。

higgsfield mcpでキャラクターの一貫性を出すなら、Soul Characterワークフローが決め手だ。

3〜5枚の参照画像で create_character を実行する。
学習に3〜5分待つ。get_generation_status でポーリングする。
返ってきたキャラクターIDを、以降の generate_image 呼び出しで参照する。
結果：ブログシリーズ全体で同じ顔が現れ、ブレがない。

techsy.ioではまさにこのパターンを使っている。Higgsfieldの higgsfield-product-photoshoot スキルと higgsfield-soul-id スキルが、サイト全体のチームメンバーのイラストやマーケットプレイスカードを生成している。MCPサーバーのおかげで、一発もののバリエーションが欲しいときに別のUIに飛ぶ代わりに、Claude Codeの会話の中でイテレーションできる。繰り返し使うキャラクターが必要なとき、同じ人物を10本の記事で使うときには、higgsfield-soul-id が頼るスキルだ。季節もののマーケットプレイスカードなら higgsfield-marketplace-cards の方が速い。

もう1つ：ハウスのスタイルをCLAUDE.mdルールとして保存すれば、同じ5行を何度もタイプすることなく、すべてのプロンプトがブランドに沿ったものになる。出発点となるライブラリが欲しいなら、AKCodezの19スタイルパックがよくある美的プリセットをドロップイン可能なClaude Codeスキルとしてまとめている。

Higgsfield MCPでブログのヒーロー画像をどう生成するか？

higgsfield mcpでブログのヒーロー画像を生成するには、AIクライアントに generate_image を1200×630のアスペクト比、MCSLAブリーフ、GPT Image 2モデルで呼び出すようプロンプトする。返ってきたURLを保存し、WebPに最適化してCMSにアップロードする。MCPが組み込まれていれば、エンドツーエンドで約90秒だ。プロンプトからSanityにアップロードされたWebPまで、ヒーロー画像1枚、別のタブを開く必要なし。

このブログでの実際のワークフローはこうだ。記事ごとの .claude/skills/blog-hero-image スキルの中でヒーロープロンプトを起草する（記事ごとに1つ、バージョン管理済み）。記事の作業中にClaude Codeの中で「この記事のプロセス図ヒーローをGPT Image 2で生成、1200×630、ネイビーの背景、ラベル付きのボックス3つ」と頼む。これで generate_image が呼び出され、HiggsfieldがホステッドURLを返し、scripts/generate_image.py パイプラインが品質85のWebPにダウンサンプルし、scripts/upload_hero_image.py がSanityに送る。

Claude Codeセッション内の典型的なツール呼び出しはこんな感じだ。

text

Tool call: generate_image
  model: "gpt-image-2"
  prompt: "Process diagram, three labeled boxes left-to-right..."
  aspect_ratio: "landscape_16_9"
  quality: "high"

上級者向けのコツ：1200x630 を直接指定しないこと。ほとんどのモデルは landscape_16_9 のような比率指定を好み、正確なピクセル指定は拒否する。最も近い比率で生成し、最後に5%をクロップして正確な寸法に着地させる。失敗リトライごとに1クレジット節約できる。

これらの呼び出しをスクリプトにまとめたい場合（たとえばプロンプトのCSVから10枚のヒーローを生成する場合）、GitHub上の軽量なPython実装が会話の外で同じ呼び出しを再現してくれる。私たちはバッチバックフィルに使っている。

同じアセットをチャネル横断で再利用するには、ブログコンテンツをヒーロー画像ブリーフに変換するコミュニティのCover Image Prompter自動化がブリーフ作成のステップを担う。Social Banner Generatorと組み合わせれば、MCPで生成した1枚のヒーローが、再プロンプトなしで4つのソーシャルバリエーションになる。

MCP経由の generate_image でレンダリングされたブログヒーロー。

Higgsfield MCPはブログ要約の短編動画を生成できるか？

技術的には可能。正直に言えば、条件付きだ。仕組みはVeo 3.1かSeedance 2.0を使った generate_video で、8〜15秒、非同期。呼び出しはジョブIDを返し、URLが出るまで get_generation_status でポーリングする。記事要約クリップで実験中だが、まだすべての記事に載せてはいない。

2つの正直な開示がある。第一に、動画生成は速くない。Veo 3.1は8秒クリップに45〜90秒かかる。Seedance 2.0は30秒程度。レンダリングごとにコーヒーブレイクを覚悟してほしい。そして、密なループでポーリングしているなら、空の processing レスポンスに金を払っているだけだ。ポーリング間隔は1秒ではなく5秒にすること。

第二に、私たちのSanity CMSにはまだ videoBlock ボディタイプがない。これはパイプラインに来る予定のもので、出荷済みではない。今のところ、MCPで生成したMP4をカスタムブロック内のHTML5 <video> タグとして埋め込んでいる。今日これがワンクリックの解決策だとは言わない。

私たちが目指しているユースケースは、12秒の記事要約アニメーションだ。静的ヒーローと同じMCSLAブリーフで「動きのあるプロセス図」としてプロンプトする。同じカラーパレット、同じ構図、ただ動いているだけ。より広い動画制作ワークフローにおけるAIの文脈は、そちらの深掘り記事が編集面をカバーしている。

ホステッドMCPがまだ公開していないモデル（たとえばSora 2）へのアクセスが必要なら、Sora 2 / Veo 3アクセスを追加するコミュニティフォークが一見の価値ありだ。セルフホストのMCPラッパーなので、Higgsfieldのラインナップにないモデルには自分のAPIキーを持ち込むことになる。

トラブルシューティング：30分を無駄にする5つの落とし穴

Higgsfield MCPで最もよくある5つの問題は、OAuthトークンの期限切れ（/mcp パネルから再実行）、「pending」で止まるサーバー（Claude Codeは指数バックオフで5回リトライする）、間違ったスコープフラグ（--scope user と --scope project）、モデルが見つからない（モデル名のタイプミス）、そして非同期ポーリングで止まる動画（get_generation_status を手動で呼ぶか再起動）。それぞれ、知りさえすれば2分以内で直る。

OAuthトークンの期限切れ

症状：/mcp にツールは表示されるが、すべての呼び出しが「unauthorized」を返す。対処法：Claude Codeで /mcp を実行し、Higgsfieldを選び、「Re-authenticate」を選ぶ。ブラウザが再び開くので、サインインし直せば完了だ。トークンには有効期限（通常数週間）があり、事前の警告はない。

サーバーが永遠に「Pending」を表示する

症状：claude mcp list でhiggsfieldの隣に✔ではなく⏳が表示される。対処法：Claude CodeはHTTP/SSEを指数バックオフ（1秒 → 2秒 → 4秒 → 8秒 → 16秒）で5回リトライし、諦める。claude mcp restart higgsfield を実行する。それでもpendingのままなら https://status.higgsfield.ai を確認する。ホステッドMCPはモデルのロールアウト中に一時的に性能低下することがある。

間違ったスコープ（`--scope user` と `--scope project`）

症状：あるリポジトリではサーバーが動くのに、別のリポジトリでは動かない。対処法：--scope user は ~/.claude/mcp.json に書き込む（グローバル、すべてのプロジェクト）。--scope project はカレントディレクトリの .mcp.json に書き込む（gitにコミットされ、チームと共有される）。インストールに2分以上かかっているなら、原因はほぼスコープフラグだ。どちらかを選び、もう片方を消すこと。

モデルが見つからない

症状：Error: model "veo-3" not found。対処法：モデル名は veo-3 ではなく veo-3.1 だ。list_characters を実行してレスポンスメタデータ内の正確なモデル識別子を確認するか、最初のH2の表を確認する。Higgsfieldの名前は大小文字を区別し、バージョン付きなので、Soul と soul-v2 は同じ文字列ではない。

非同期ポーリングで止まる動画

症状：generate_video がジョブIDを返すが、get_generation_status が3分を超えても processing を返し続ける。対処法：VeoとKlingのジョブは90秒以上かかることがあるが、3分を超えたらジョブはサイレントに失敗したか、キューで詰まっている。claude mcp restart higgsfield を実行して再発行する。無料枠アカウントはキューの優先度が低いので、有料ユーザーはこれに遭いにくい。

CIでMCPのタイムアウトに何度も遭うなら、Higgsfield CLIはヘッドレスで動作し、スクリプトとの相性が良い。MCPは対話的なOAuthの往復を必要とするが、CLIは長期有効なAPIトークンを使うので、非対話的なパイプラインにはこちらが向いている。

FAQ

Higgsfield MCPとは？

Higgsfield MCPは https://mcp.higgsfield.ai/mcp にあるホステッドのModel Context Protocolサーバーで、7つの画像・動画生成モデル（GPT Image 2、Soul V2、Veo 3.1、Kling 3.0、Flux 2を含む）をMCP互換のAIクライアントに公開する。認証はHiggsfieldアカウントによるOAuthで、ホステッドサーバーにはAPIキー不要。

Higgsfield MCPは無料か？

月150クレジットの無料枠がある（2026年5月時点）。それを超えると、プリペイドクレジットはおよそ$1 = 16クレジットで、個々の生成はモデルと長さに応じて2〜60クレジットかかる。静止画は約2〜10クレジット、8秒のVeoクリップは約60クレジット。Higgsfieldの有料プランは変動するので、現在の価格帯は課金ページを確認してほしい。

Higgsfield MCPをClaude Codeにインストールするには？

ターミナルで claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp を実行する。初回利用時にClaude CodeがOAuth用にブラウザを開くので、Higgsfieldアカウントでサインインし、ターミナルに戻って claude mcp list かClaude Codeセッション内の /mcp スラッシュコマンドで確認する。通常の回線ならフロー全体は1分を大きく下回る。

Higgsfield MCPはCodexやChatGPT Desktopで動くか？

OpenAIのCodex CLIなら動く。標準のMCPワイヤープロトコルを話すので、同じ mcp.json 設定がそのまま使える。ChatGPTデスクトップは、2026年5月時点では動かない。OpenAIはまだコンシューマー向けChatGPTアプリにMCPサポートを出していない。ホステッドHiggsfield MCPが公開していないSora 2やその他のOpenAIモデルが特に必要なら、コミュニティの統合フォークがそのギャップを埋められる。

Higgsfield MCPとCLI：どちらを使うべきか？

モデルがコンテキストからパラメータを選ぶ対話型のチャット内生成にはMCPを使う。ブログ執筆やデザインのイテレーションワークフローのほとんどはこれだ。ヘッドレスでスクリプト化されたパイプライン、CIジョブ、バッチバックフィルには、対話的なOAuthフローの代わりに長期有効な認証トークンが使えるCLIを使う。MCPをClaudeスキルとしてラップして繰り返しパターンに使うこともできる。

Higgsfield MCPはどのモデルをサポートするか？

ホステッドサーバーは現在7つの主要モデルを公開している。汎用の画像作業にはGPT Image 2とNano Banana Pro、キャラクターの一貫性にはSoul V2、スタイライズ出力にはFlux 2、そして動画にはSeedance 2.0、Veo 3.1、Kling 3.0。Higgsfieldの全ラインナップは30以上のモデルを含み、ホステッドMCPのラインナップはプラットフォームに新モデルが追加されるにつれて時間とともに拡張される。

Higgsfield MCPをCIでヘッドレス実行できるか？

直接はできない。ホステッドMCPは初回認証時に対話的なOAuthの往復を必要とし、CI環境ではこれが動かない。CIにはHiggsfield CLI（@higgsfield/cli）を使う。CIシークレットとして保存できる長期有効なAPIトークンを使う。MCPは対話セッション用、CLIは自動化パイプラインとバッチ生成ジョブ用だ。

生成をまたいでキャラクターの一貫性を得るには？

被写体の参照画像3〜5枚で create_character を使う。このツールは約3〜5分の学習後にキャラクターIDを返す。そのIDを以降の generate_image 呼び出しでSoul V2モデルとともに参照すれば、すべての生成で同じ顔が現れる。これがブログシリーズ、プロダクトマスコット、視覚的な連続性が必要なあらゆるプロジェクトでの主力パターンだ。

Higgsfield MCPはSoraやVeoを直接呼ぶより高いか？

ほとんどの場合、おおよそ同等だ。HiggsfieldはAPI容量を卸で仕入れてクレジットとして再販しているので、生成ごとのコストは元のプロバイダーと大きく離れていない。トレードオフは、統合された課金、いくつものAPIキーの代わりに使えるOAuth、そしてMCPによる対話UXだ。一発もののスクリプトなら直接の方が少し安くなることもあるが、継続的なクリエイティブ作業ならHiggsfieldの方がシンプルな道だ。

Higgsfield MCPはClaude Codeで無料で使えるか？

無料枠は月150クレジットを無償で提供しており、GPT Image 2の静止画なら約15枚、Veo 3.1の動画クリップなら2本分をカバーする。Claude Code自体はMCPツール呼び出しに追加料金を課さない。無料枠を超えると、プリペイドクレジットはおよそ$1で16クレジット。大量にヒーローを生成するチームには有料プランが価値あるが、個人の開発者には無料枠で軽度〜中程度の利用がまかなえる。

Claude CodeのHiggsfield MCPで何が生成できるか？

サーバーは画像生成（1発もの、プロダクト撮影、スタイライズイラスト）、動画生成（Veo 3.1かKling 3.0で最大15秒のシネマティッククリップ）、そして視覚的一貫性のためのキャラクター学習を公開する。実際には、チームはブログのヒーロー画像、OGカード、プロダクトモックアップ、短い記事要約アニメーションに使っており、すべては別のクリエイティブツールではなくClaude Codeのコンテキストエンジニアリングワークフローの中から行われる。

AI機能がロードマップにあるなら、それは私たちの専門領域だ。TechsyのAIインテグレーションチームはLLMシステムをプロトタイプから本番環境まで導く。

まとめ

これが全体のツアーだ。Claude Codeの1行インストール、その他の主要MCPクライアントすべてのJSONスニペット、MCSLAのプロンプトレシピ、一貫性のためのSoul Characterワークフロー、そして見逃すと午後を無駄にする5つの落とし穴。Higgsfieldは開発者向けベストMCPサーバーのまとめの中でも、すぐに役立つ度合いが最も高いエントリーの1つで、サーバー群全体を構築中ならブックマークする価値がある。まだAIクライアントを選んでいる段階なら、Claude Code vs Cursor vs Copilot比較がより広い状況をカバーしている。そしてHiggsfield MCPが再現可能なコンテンツ制作ルーチンにどう組み込まれるかを見たいなら、Claude Codeワークフローガイドがセットアップ全体を示している。

Higgsfield MCPをSanityや好みのCMSと並べてチームのコンテンツパイプラインに組み込む作業を私たちに任せたいなら、無料相談を予約してほしい。

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

最終更新：2026年6月6日。 インストールコマンドとOAuthフローを再検証済み。モデル一覧（GPT Image 2、Soul V2、Veo 3.1、Kling 3.0、Flux 2、Nano Banana Pro、Seedance 2.0）も最新であることを確認。無料枠のクレジット付与（月150）も引き続き正確。

クイックアンサー

Higgsfield MCPは https://mcp.higgsfield.ai/mcp にあるホステッドサーバーで、7つの画像・動画モデルをあらゆるMCPクライアントに公開する。

Claude Codeにはコマンド1つでインストール。認証はOAuthで、APIキーは不要。

Claude Code、Claude Desktop、Cursor、Windsurf、Cline、OpenCodeで動作する。

無料枠：月150クレジット（2026年5月時点）。それを超えると$1 = 16クレジット。

Higgsfield MCPは実際何をするのか

モデル	種類	用途	1生成あたりのクレジット目安
GPT Image 2	画像	写真的リアリズム、プロダクト撮影	約8
Nano Banana Pro	画像	高速・低コストなイテレーション	約2
Soul V2	画像	キャラクターの一貫性（`create_character`と併用）	約10
Seedance 2.0	動画	動きのある短いクリップ	約30
Veo 3.1	動画	8〜15秒のシネマティックなクリップ	約60
Kling 3.0	動画	なめらかな動き、キャラクターのアクション	約50
Flux 2	画像	スタイライズ、イラスト調	約6

無料枠：月150クレジット。2026年5月時点の情報で、変更される可能性がある。

サーバーが公開する5つのツールが、機能のすべてだ。

generate_image：1発の画像生成
generate_video：非同期の動画生成。ジョブIDを返す
create_character：一貫性のためにSoul Characterを学習させる
get_generation_status：非同期ジョブをポーリングする
list_characters：学習済みキャラクターを一覧表示する

Higgsfield MCPをClaude Codeに追加するには？

インストールコマンドはこれだ。ターミナルに貼り付けてほしい。

bash

claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

うまくいったか確認する。

bash

claude mcp list
# Higgsfield   http   ✔ connected

Claude Codeセッション内の generate_image ツール呼び出し。

Higgsfield MCPをClaude Desktopに追加するには？

OS	パス
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

これを書き込む。

json

{
  "mcpServers": {
    "higgsfield": {
      "transport": {
        "type": "http",
        "url": "https://mcp.higgsfield.ai/mcp"
      }
    }
  }
}

Higgsfield MCPのCursorセットアップ

Cursorは url フィールドからHTTPトランスポートを自動検出するので、明示的に宣言する必要はない。設定は以下の通り。

json

{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Higgsfieldサーバーが登録されたCursorのmcp.json。

Higgsfield MCPをWindsurfやClineにインストールするには？

json

{
  "mcpServers": {
    "higgsfield": {
      "type": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Higgsfield MCPはOpenCodeで動くか？

json

{
  "servers": {
    "higgsfield": {
      "transport": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

MCP経由でHiggsfieldにプロンプトする最善の方法は？

Model： まず適切なツールを選ぶ。リアリズムならGPT Image 2、繰り返し使うキャラクターならSoul V2、スタイライズならFlux 2。
Composition： ショットを構図する（「ワイドアングルのヒーロー構図、被写体は左三分割、右にネガティブスペース」）。
Subject： 画面内のものを具体的な属性付きで指定する（「黒いセラミックマグ、結露の水滴、風化したオーク材の上」）。
Lighting： 方向と質で指定する（「左上からの温かいリムライト、やわらかいフィル、深いブルーの影」）。
Aesthetic： 最終的なルック（「雑誌のエディトリアル、35mmフィルムの粒子感、SaaSマーケティング向けカラーグレーディング」）。

higgsfield mcpでキャラクターの一貫性を出すなら、Soul Characterワークフローが決め手だ。

3〜5枚の参照画像で create_character を実行する。
学習に3〜5分待つ。get_generation_status でポーリングする。
返ってきたキャラクターIDを、以降の generate_image 呼び出しで参照する。
結果：ブログシリーズ全体で同じ顔が現れ、ブレがない。

Higgsfield MCPでブログのヒーロー画像をどう生成するか？

Claude Codeセッション内の典型的なツール呼び出しはこんな感じだ。

text

Tool call: generate_image
  model: "gpt-image-2"
  prompt: "Process diagram, three labeled boxes left-to-right..."
  aspect_ratio: "landscape_16_9"
  quality: "high"

MCP経由の generate_image でレンダリングされたブログヒーロー。

Higgsfield MCPはブログ要約の短編動画を生成できるか？

トラブルシューティング：30分を無駄にする5つの落とし穴

OAuthトークンの期限切れ

サーバーが永遠に「Pending」を表示する

間違ったスコープ（`--scope user` と `--scope project`）

モデルが見つからない

非同期ポーリングで止まる動画

FAQ

Higgsfield MCPとは？

Higgsfield MCPは無料か？

Higgsfield MCPをClaude Codeにインストールするには？

Higgsfield MCPはCodexやChatGPT Desktopで動くか？

Higgsfield MCPとCLI：どちらを使うべきか？

Higgsfield MCPはどのモデルをサポートするか？

Higgsfield MCPをCIでヘッドレス実行できるか？

生成をまたいでキャラクターの一貫性を得るには？

Higgsfield MCPはSoraやVeoを直接呼ぶより高いか？

Higgsfield MCPはClaude Codeで無料で使えるか？

Claude CodeのHiggsfield MCPで何が生成できるか？

まとめ

Higgsfield MCPをSanityや好みのCMSと並べてチームのコンテンツパイプラインに組み込む作業を私たちに任せたいなら、無料相談を予約してほしい。

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

Higgsfield MCPは実際何をするのか

Higgsfield MCPをClaude Codeに追加するには？

Higgsfield MCPをClaude Desktopに追加するには？

Higgsfield MCPのCursorセットアップ

Higgsfield MCPをWindsurfやClineにインストールするには？

Higgsfield MCPはOpenCodeで動くか？

MCP経由でHiggsfieldにプロンプトする最善の方法は？

Higgsfield MCPでブログのヒーロー画像をどう生成するか？

Higgsfield MCPはブログ要約の短編動画を生成できるか？

トラブルシューティング：30分を無駄にする5つの落とし穴

OAuthトークンの期限切れ

サーバーが永遠に「Pending」を表示する

間違ったスコープ（--scope user と --scope project）

モデルが見つからない

非同期ポーリングで止まる動画

FAQ

Higgsfield MCPとは？

Higgsfield MCPは無料か？

Higgsfield MCPをClaude Codeにインストールするには？

Higgsfield MCPはCodexやChatGPT Desktopで動くか？

Higgsfield MCPとCLI：どちらを使うべきか？

Higgsfield MCPはどのモデルをサポートするか？

Higgsfield MCPをCIでヘッドレス実行できるか？

生成をまたいでキャラクターの一貫性を得るには？

Higgsfield MCPはSoraやVeoを直接呼ぶより高いか？

Higgsfield MCPはClaude Codeで無料で使えるか？

Claude CodeのHiggsfield MCPで何が生成できるか？

まとめ

その他の記事 ai-machine-learning

Claude Opus 5が登場：Fable 5に迫る知能を半額で

2026年ベストAIウェブスクレイピングAPI 8選（自社エージェントスタックで実測）

コーディングのためのプロンプトエンジニアリング：Claude CodeとCursorで毎日使う7つのパターン（2026年版）

さあ、何かを作ろう。 特別なものへ？

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

Claude Code向けHiggsfield MCP：60秒セットアップ（と5つの落とし穴）

Higgsfield MCPは実際何をするのか

Higgsfield MCPをClaude Codeに追加するには？

Higgsfield MCPをClaude Desktopに追加するには？

Higgsfield MCPのCursorセットアップ

Higgsfield MCPをWindsurfやClineにインストールするには？

Higgsfield MCPはOpenCodeで動くか？

MCP経由でHiggsfieldにプロンプトする最善の方法は？

Higgsfield MCPでブログのヒーロー画像をどう生成するか？

Higgsfield MCPはブログ要約の短編動画を生成できるか？

トラブルシューティング：30分を無駄にする5つの落とし穴

OAuthトークンの期限切れ

サーバーが永遠に「Pending」を表示する

間違ったスコープ（--scope user と --scope project）

モデルが見つからない

非同期ポーリングで止まる動画

FAQ

Higgsfield MCPとは？

Higgsfield MCPは無料か？

Higgsfield MCPをClaude Codeにインストールするには？

Higgsfield MCPはCodexやChatGPT Desktopで動くか？

Higgsfield MCPとCLI：どちらを使うべきか？

Higgsfield MCPはどのモデルをサポートするか？

Higgsfield MCPをCIでヘッドレス実行できるか？

生成をまたいでキャラクターの一貫性を得るには？

Higgsfield MCPはSoraやVeoを直接呼ぶより高いか？

Higgsfield MCPはClaude Codeで無料で使えるか？

Claude CodeのHiggsfield MCPで何が生成できるか？

まとめ

その他の記事 ai-machine-learning

Claude Opus 5が登場：Fable 5に迫る知能を半額で

2026年ベストAIウェブスクレイピングAPI 8選（自社エージェントスタックで実測）

コーディングのためのプロンプトエンジニアリング：Claude CodeとCursorで毎日使う7つのパターン（2026年版）

さあ、何かを作ろう。 特別なものへ？

間違ったスコープ（`--scope user` と `--scope project`）

さあ、何かを作ろう。特別なものへ？

間違ったスコープ（`--scope user` と `--scope project`）

さあ、何かを作ろう。特別なものへ？