higgsfield-mcp-server

Higgsfield AI のAPIを通じて、Claudeが画像や動画を生成できるようにするリモートMCPサーバーです。チャットから直接、フォトリアルな写真（Soul）、参照画像を使った画像生成（Popcorn）、動画生成（Google Veo 3.1、Kling、ByteDance Seedance）が可能です。

公開されているツール

すべての生成ツールは非同期です。即座に request_id を返し、ジョブが completed になるまで higgsfield_check_status を呼び出します（Claude が自動的に行います）。

Related MCP server: higgsfield-mcp

1. Higgsfield APIキーを取得する

1. https://cloud.higgsfield.ai にアクセスしてサインインします。

2. APIキーを作成します（Claudeに依頼した後にこのページを読んでいる場合は、すでに作成済みです）。API Key ID と API Key Secret が発行されます。両方をコピーしてください。これらは一度しか表示されません。

2. このサーバーをデプロイする（無料枠で動作します）

Nodeプロセスを24時間365日稼働させ、HTTPSでアクセスできる場所が必要です。このような小規模なサーバーでは、クレジットカード不要の無料オプションが2つあります。

オプションA: Render.com

1. このフォルダを新しいGitHubリポジトリにプッシュします（プライベートで問題ありません）。

2. https://render.com で New + → Web Service → そのリポジトリを接続します。

3. 設定:

   • Runtime: Node

   • Build Command: npm install

   • Start Command: npm start

4. Environment で、次の3つの変数を追加します:

   • HF_API_KEY_ID = あなたの Higgsfield API Key ID

   • HF_API_KEY_SECRET = あなたの Higgsfield API Key Secret

   • MCP_ACCESS_TOKEN = 任意の長いランダム文字列（例: ローカルで openssl rand -hex 32 を実行するか、40文字以上をキーボードで適当に入力）— これはClaudeがサーバーと通信するためのパスワードです。他の誰かがあなたのHiggsfieldクレジットを使えないようにします。

5. デプロイします。Renderは https://higgsfield-mcp-server.onrender.com のようなURLを提供します。MCPエンドポイントはそのURL + /mcp です。例: https://higgsfield-mcp-server.onrender.com/mcp

注: Renderの無料Webサービスは、非アクティブが続くとスリープし、次のリクエストで起動するまで数秒かかります。たまに使う分には問題ありません。

オプションB: Railway.app

同じ考え方です。このGitHubリポジトリから新しいプロジェクトを作成し、同じ3つの環境変数を設定します。Railwayは npm start を自動検出します。https://higgsfield-mcp-server-production.up.railway.app のようなURLが得られ、エンドポイントはそれに /mcp を追加したものになります。

3. Claudeにカスタムコネクタとして追加する

Claude（claude.ai / デスクトップアプリ）で、設定 → コネクタ → カスタムコネクタを追加 を選択します:

• 名前: Higgsfield

• URL: https://<デプロイしたURL>/mcp

• 認証: Bearerトークン → 手順2で設定した MCP_ACCESS_TOKEN の値を貼り付けます。

チャットで有効にすると、Claudeが上記のツールを呼び出せるようになります。

ローカルテスト（任意）

cp .env.example .env   # fill in real values
npm install
npm start

サーバーは http://localhost:3000/mcp（または $PORT）で待ち受けます。

セキュリティに関する注意

• HF_API_KEY_ID / HF_API_KEY_SECRET は、あなたのHiggsfieldアカウントと請求に完全にアクセスできます。これらはホストの環境変数にのみ保存されます。コミットしたり、URLに含めたりしないでください。

• MCP_ACCESS_TOKEN は、あなたのサーバーURLを見つけた第三者があなたのHiggsfieldクレジットでコンテンツを生成するのを防ぎます。パスワードのように扱ってください。

• すべての生成呼び出しは、プランの料金に応じてHiggsfieldクレジットを消費します。