【PR】本記事はHiggsfieldからの提供です。

Claude CodeやCodexなどのコーディングエージェントでHiggsfieldを使うなら、2026年8月時点ではCLI + Skillsを選ぶのが分かりやすいです。私は先にMCPを試しましたが、撮影時にはOAuthのredirect_uri不一致で認証に進めず、CLIへ切り替えました。

1. MCP認証で実際に遭遇したエラー

2026年8月9日の検証では、Higgsfield MCPをClaude Codeから接続しようとしたところ、ブラウザ認証で次のエラーが出ました。

{"error":"invalid_request","error_description":"...The 'redirect_uri' parameter does not match any of the OAuth 2.0 Client's pre-registered redirect urls."}

これは当時の私の環境で実際に発生した記録です。OAuthやMCPの実装は更新が速いため、現在も同じ原因・同じ挙動とは限りません。認証エラーが出た場合は、まずHiggsfield公式の最新セットアップを確認してください。

2. 現在の公式案内ではCLIとMCPの役割が分かれている

2026年8月時点のHiggsfield公式ヘルプでは、Claude Code・Cursor・CodexなどのコーディングエージェントにはCLI + Skills、Claude Webなどのチャット型エージェントにはMCPが向くと整理されています。

つまり、Claude CodeでMCP認証に時間を使い続けるより、CLIへ切り替える方が目的に合うケースがあります。

3. CLI + Skillsへ切り替える手順

現在の公式手順は次の3段階です。

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills

higgsfield auth loginを実行するとブラウザが開くので、人がHiggsfieldアカウントで認証します。認証後はClaude CodeやCodexから画像・動画生成を依頼できます。

4. CLIでできること

CLIでは画像・動画生成、モデル確認、参照素材のアップロード、生成履歴、クレジット確認、Soulのキャラクター学習などを扱えます。コマンドやSkillsの詳しい使い方は、別記事にまとめています。

Higgsfield CLIコマンド完全リファレンス

5. Seedance 2.5のIP checkエラーは別記事へ

CLIへ切り替えた後、Seedance 2.5で参照画像を使った際にIP check not finished for input mediaという別のエラーにも遭遇しました。

このエラーはMCPのOAuth認証とは別問題です。検索意図が混ざらないよう、原因の切り分けと当時通った回避手順は専用記事へ分けています。

Seedance 2.5 omni_reference｜IP check not finishedエラー対策

6. MCPとCLIのどちらを選ぶ？

使う環境選び方
Claude Code / Cursor / CodexCLI + Skillsを優先
Claude Webなどチャット型MCPを検討
CLIで生成を自動処理したいCLI + Skills
認証エラーで止まっている公式手順を確認し、目的に合えばCLIへ切り替える

実際にMCPからCLIへ切り替え、画像・動画生成まで行った流れはこちらの動画で確認できます。

まとめ

MCPのOAuthエラーは、少なくとも撮影時の私の環境では実際に発生しました。ただし、現在のHiggsfield公式はコーディングエージェント向けにCLI + Skillsを明確に案内しています。

Claude CodeやCodexで使うなら、認証問題を延々と追う前に、CLIへ切り替える選択肢を確認するのがおすすめです。Seedance 2.5の参照画像エラーなど、生成後のトラブルは別問題として切り分けて対処します。

関連記事：Higgsfield CLIコマンド完全リファレンス / Seedance 2.5のIP checkエラー対策 / Higgsfield Soulでキャラクターを学習させる方法

Higgsfieldをご自身の環境でも試してみたい人はこちらからどうぞ。

本記事はHiggsfieldの提供・依頼により作成しています。