Higgsfield MCP｜連接與使用教學

1. 是甚麼

MCP（Model Context Protocol）讓 AI Agent 直接呼叫 Higgsfield。連接一次，即可在 Claude 或任何 MCP 相容 Agent 中生成圖像、影片、角色與音訊，毋須打開網頁。伺服器 URL：https://mcp.higgsfield.ai/mcp。help-mcp-cli

透過 MCP 可做：所有模型的圖像與影片生成、放大、去背、擴展／改比例、Kling Motion Control、Soul 角色與參考 Elements、音訊（旁白、聲音複製、配音），以及查詢 credits。所有 MCP 生成都存入 higgsfield.ai 的 Assets。help-mcp-cli Claude 亦可瀏覽你的生成歷史，把舊圖／舊片當參考重用。blog:claude-higgsfield-mcp-creative-studio

2. 連接步驟

驗證：新對話問「What is my Higgsfield credit balance?」，Claude 應呼叫 MCP 工具回傳帳戶資料。help-mcp-cli

⚠️ 未核實：社群流傳的 Claude Code 指令 claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp 屬標準 MCP 用法推斷，官方文件只建議 Claude Code 走 CLI + Skills。

3. 逐步製作流程（官方 Claude 教學，含逐字提示）

sequenceDiagram
  participant U as 你
  participant C as Claude
  participant H as Higgsfield MCP
  U->>C: 確認連接（問 credit 餘額）
  U->>C: Step 2 參考圖提示（角色/地點/視覺方向）
  C->>H: 生成圖像（或重用 Assets）
  U->>C: Step 3 音訊提示（VOICE / MUSIC / SFX / MIX）
  C->>H: 生成音訊
  U->>C: Step 4 影片提示（一次描述動作、環境、構圖、光線、節奏）
  C->>H: 自動選模型生成影片
  H-->>U: 片段回到對話 + 存入 Assets

Step 2 參考圖（官方網誌原文，逐字）：blog:claude-higgsfield-mcp-creative-studio

Photorealistic film still of two medieval knights locked in a swordfight on a
snowbound battlefield, shot on location with real steel armour, documentary realism.
COMPOSITION: side-on view, both knights in full body profile facing each other in the
centre of frame, blades crossed and grinding together above their heads, both leaning
in with full body weight, feet braced wide in churned frozen mud, knees bent, medium
wide shot.
LEFT KNIGHT: 15th century steel plate harness with a warm grey mottled patina,
uneven hand-polished surface showing hammer planishing marks, fine radial scratches,
shallow dents and darkened recesses, bright wear-polish on the raised edges of the
pauldrons and elbow cops, visible rivets casting real shadows, rounded bascinet with a
hinged pointed visor and narrow eye slit, deep crimson quilted arming doublet showing
at the armpits and thighs with genuine fabric weave and stitching relief, worn brown
leather straps and tarnished brass buckles, mud spattered up the greaves and sabatons.
RIGHT KNIGHT: heavier steel harness with a darker oxidised finish and cloudy grey
mottling, tall pointed bascinet with a hinged visor, high riveted plate gorget,
fluted vambraces, a faded ochre linen surcoat over the breastplate with real cloth
creases, frayed hem and dirt staining, weathered brown leather belt, a small kite
shield slung on his back with cracked painted heraldry and chipped paint edges,
snow crusted into the joints and articulation gaps.
SWORDS: real forged steel longswords, satin grey blade finish with visible grind
lines, small nicks along the edges, blued crossguards, leather-wrapped grips darkened
with use, a faint scatter of sparks and steel dust at the point of contact.
LOCATION: open snowbound field, churned dark frozen mud with real clod texture and
boot prints in the foreground, patchy crusted snow and dead golden grass, war arrows
stuck upright in the ground at irregular angles with real fletching, tall thin poles
carrying weathered crimson and cream pennants with frayed edges snapping in the wind,
low snow-covered ridges, the faint grey silhouette of a castle curtain wall with
crenellations on the distant horizon.
SNOW AND ATMOSPHERE: light dry snow blowing diagonally across the frame, individual
flakes catching the sun, uneven patchy ground mist drifting in ragged bands rather
than uniform fog, fine snow dust lifted by the wind, faint breath vapour escaping the
visor slits.
LIGHT: low winter sun sitting just above the horizon behind the right knight, strong
backlight blowing out the right side of frame into a bright warm haze, hard rim light
tracing both figures, deep cold blue-grey shadow on the camera-facing side with only
weak bounce from the snow, high dynamic range with genuine highlight rolloff, long
raking shadows across the mud, natural atmospheric flare.
CAMERA: shot on 35mm film with an anamorphic 50mm lens, low camera close to the ground
at knee height, f/2.8, sharp focus on the crossed blades and both figures, slight
falloff at the frame edges, subtle lens breathing and mild chromatic aberration on the
backlit edges, natural halation around the sun, visible film grain, handheld micro
shake, no post sharpening.
REALISM: real physical materials, no cgi smoothness, imperfect surfaces, genuine
weight and inertia in the bodies, historically accurate 15th century harness,
documentary film photography, unretouched, photographic imperfection.
--ar 16:9

中文解說：這是「分段標籤式」圖像提示——總述一句 → COMPOSITION → 每個角色 → SWORDS → LOCATION → SNOW AND ATMOSPHERE → LIGHT → CAMERA → REALISM。每段只講一件事，最後用 REALISM 段排除 CGI 感。

Step 3 音訊（逐字）：

VOICE (0.0–2.6s, then silence): Knight 1 inside a closed helm.
[voice: man, early 30s, deep resonant chest voice, heavy theatrical delivery, muffled and boxy from inside a steel bascinet, close and claustrophobic, audible breath, cold and calm not shouted, slow weighted pacing, English accent]
"They sent their best. [breath] Let them come."
MUSIC (0.0–10.0s, audible throughout): epic medieval battle orchestral, instrumental, no vocals.
War horns, massive low brass, thundering taiko and timpani, snare rolls, low male choir chant,
harsh minor string ostinato. D minor, 88 BPM, drums accelerating.
0–1.2s: lone distant war horn, low sub drone, cymbal swell under the voice.
1.2–2.4s: hard taiko impact on the clash, low strings driving, snare in.
2.4–4.4s: accelerating ostinato, brass stabs on each blade contact, drums doubling, choir low.
4.4–5.4s: full orchestra fortissimo on the simultaneous strike, brass and choir crash, one
monumental drum hit.
5.4–7.2s: drums drop a beat, then two crushing hits on the disarm and kick, choir guttural.
7.2–10.0s: menacing brass swell, lone horn over sustained choir, single heartbeat pulse, unresolved, long reverb tail.
SFX (continuous): howling gale, driving snow, banners snapping, ringing steel with scrapes and sparks, plate clattering, sabatons crunching on snow and mud, sword burying its point, heavy metallic body impact, laboured breathing in the helm.
MIX: voice forward 0–2.6s with music ducked, then music and SFX to full. Wide cinematic
reverb, deep sub-bass, brass forward. No dialogue after 2.6s.

中文解說：音訊提示按時間軸分 VOICE（含 [voice: …] 角色聲線描述與 [breath] 標記）、MUSIC（調性 D minor、88 BPM、逐秒編排）、SFX（持續音效）、MIX（混音優先次序）。

Step 4 影片：官方建議在同一訊息描述動作、環境、構圖、光線、節奏與整體外觀，Claude 可自動選模型。官方示範提示（逐字，含 @image1–3 參考）：

SINGLE CONTINUOUS ONE-SHOT, 10.0 seconds, 16:9, anamorphic cinematic, no cuts.
Two armoured knights duel on a snowbound battlefield slope under a vast storm sky with a strong sun break, heavy snow blowing the whole time, red, white and gold banners snapping in the wind — the camera riding the whole exchange in one unbroken flight from a tight close-up to
a low over-the-shoulder finish on the loser crawling backwards.
REFERENCES.
Location (@image1): bleak windswept battlefield slope in a winter storm — churned dark
earth and patchy snow over dead ochre grass in the foreground, rolling snow-covered hills receding to a distant fortified silhouette. Many tattered banners on thin bending poles scattered across the field: crimson red flags with pale device marks, split white pennants, small
gold-yellow pennants — all rippling and cracking in the wind. Broken spear shafts and arrows driven into the ground at angles, a round wooden shield propped against a cairn of stones, scattered debris and cloth scraps. Above: an enormous churning cloud front — dark storm mass on the left breaking into billowing lit cumulus on the right.
MORE SUN: a strong, bright sun break burning through the cloud on the upper right,
throwing hard low-angle golden-white light across the field — the snow crests glowing warm, long raking shadows stretching from the knights and the banner poles, brilliant rim light on steel, visible god rays fanning through the falling snow, warm glow on the ochre grass, and repeated lens flares as the camera swings past the sun.
MORE SNOW: thick, heavy snowfall throughout — dense fat flakes driving diagonally across every frame in gusting sheets, snow streaming off the ground in blowing veils, flakes catching the sunlight and flaring bright against the dark cloud, visibility softening toward the distant hills, snow settling on the pauldrons and helms of both knights and building up as the
fight goes on.
Knight 1 (@image2): full plate harness in bright polished-but-scuffed steel — rounded
bascinet with a pointed apex and hinged conical visor with a narrow eye slit, wide steel gorget, broad rounded pauldrons, a plain etched cross outline on the chest plate, red-and-blue heraldic quilted sleeves at the upper arms, articulated vambraces, mail skirt under a steel fauld, brown
leather belt with brass buckles, greaves and rounded sabatons, gauntleted hands, long straight double-edged sword with a gilt crossguard.
Knight 2 (@image3): full plate harness in darker weathered steel — bascinet with a tall pointed crest and slotted visor, deep gorget, dark green surcoat sleeves embroidered with pale
grey serpentine knotwork, fluted fauld and tassets, brown cloth skirt beneath, articulated vambraces and gauntlets, long pointed sabatons, long straight sword.
CONSTANTS (every frame). Heavy snow drives diagonally and continuously — never stopping, never freezing. Every banner, flag and pennant moves constantly in the wind:
rippling, twisting, snapping taut, poles flexing. Grass bends, snow streams sideways in gusts, cloth scraps flutter. The storm front churns behind the action and the sun break keeps burning through it. All heraldry is invented and generic — no real coats of arms, no readable text, no
recognisable insignia.
0.0–1.2s | CLOSE-UP — KNIGHT 1. Tight close-up on Knight 1's helm, filling the frame
— the pointed apex and hinged visor, the narrow dark eye slit, sunlight raking hard across the polished steel, snowflakes landing and melting on the plate, breath fogging faintly out through the slit. His sword rises into frame in front of him, held vertically, the blade edge catching a
hard flare of sun. Snow drives past the lens. *Cam:* 85mm T2.0, very shallow focus, slow push in with a slight rise, gentle handheld breathing, sun flare bleeding in from the upper right.
1.2–2.4s | PULL TO WIDE — THE CLASH BEGINS. The camera pulls back fast and drifts out into a wide two-shot as Knight 2 strides in from the right and they close; steel rings out as the first blows land — a high cut parried, a shoulder-check, blades scraping apart. Snow
bursts up off the churned earth. *Cam:* 24mm T4, fast backward pull-out, low horizon, banners whipping across both edges of frame, sunlit storm sky filling the upper two-thirds, god rays
through the snowfall.

2.4–4.4s | THE EXCHANGE — CAMERA FLIES BESIDE THE BLADES. Knight 2 winds up a heavy overhead swing; Knight 1 blocks it high with a shower of sparks and immediately answers with a hard diagonal counter-cut, driving Knight 2 back a step. They trade fast: a thrust turned aside, a pommel strike, a low cut blocked at the knee, a shoulder ram. The
camera flies in close alongside them, sweeping past their shoulders and low along the clashing blades — on each heavy impact it snaps in bold and tight on the swords, sunlit steel filling frame at the moment of contact, then flows back out with the movement. *Cam:* 32mm T2.8, fast
lateral flight arcing around them, hard punch-ins on the blade contacts, motion blur through the whips, jolts on impact, sun flaring as the camera crosses the light, never cutting, never stopping.

4.4–5.4s | WIDE — SIMULTANEOUS STRIKE. The camera swings out to a wide two-
shot exactly as both knights swing at the same instant — blades meeting mid-air between

them in a single ringing crash, both bodies torqued into the blow, snow exploding off the ground, banners cracking, sun blazing through the cloud behind them and backlighting the falling snow into a white curtain. *Cam:* 24mm T4, wide and level, brief settle on the collision,
immediately moving again.
5.4–7.2s | IN BEHIND KNIGHT 2 — DISARM AND KICK. The camera rushes forward and
swings tight over Knight 2's shoulder, his snow-dusted pauldron and crested helm filling the
lower frame. Knight 2 winds up and smashes his blade down across Knight 1's guard, ripping the sword clean out of his hands — it spins away, flashing in the sun, and buries its point in the snow. He steps in and drives a hard front kick into Knight 1's chest plate; Knight 1 is thrown
backwards and crashes onto his back with a heavy metallic clatter, snow and earth exploding around him. *Cam:* 35mm T2.8, fast push into a tight over-the-shoulder, following the sword's light for a beat, jolting hard on the disarm and the kick.
7.2–10.0s | ORBIT AROUND KNIGHT 2, LAND BEHIND KNIGHT 1. The camera orbits around Knight 2 in a fast arc — past his back, around his side, past his sword arm, the sun swinging through frame in a hard flare — then flies low across the ground and settles tight behind Knight 1's shoulder in the snow. From this over-the-shoulder position we see what he
sees: Knight 2 standing over him, sword lowered and ready, advancing slowly, rimmed by the sun with banners snapping behind him and snow pouring down. Knight 1 scrambles
backwards on his elbows and heels, crawling away through the snow, gauntlet slipping, breathing hard through the visor. *Cam:* 35→28mm, continuous fast orbit easing into a low over-the-shoulder hold that drifts back with his retreat, handheld shake settling. Final frame holds on Knight 2 towering ahead, backlit, through the driving snow.
OPTICS. Anamorphic lens character, shallow cinematic depth of field, prominent soft oval flares whenever the sun crosses frame, rectilinear geometry, no fisheye. Heavy natural motion blur on the fast flights and swings, focus riding the blades and helms.
LIGHTING. Storm-lit winter afternoon with a strong sun break — hard golden-white key from the upper right at a low angle, rimming helms, pauldrons and blade edges and casting long raking shadows across the snow; soft cool grey fill from the dark cloud mass on the left; deep
cool shadow inside the visors, bright bounce off sunlit snow lifting the underside of the plate. Backlit snowfall glows in sheets, god rays fanning through the flakes. Palette: warm sunlit snow and ochre grass against cold steel and dark storm cloud, crimson and gold banners. Cold
7000K shadows, warm 5000K key.
PHYSICS. The camera never stops or teleports; every flight carries real weight and eases in and out. Armour has genuine mass — plate rings and clatters, momentum shifts through the hips, sabatons dig and slip on packed snow and mud, the disarmed sword tumbles and buries
its point, the fallen knight lands with the full dead weight of the harness. Disturbed snow lifts and settles realistically; accumulated snow shakes off the plate on impacts. Cloth, banners and poles respond to real wind with lag and snap.

AUDIO. No dialogue, no music. Continuous wind bed with banner cracks, ringing steel on steel, plate clattering, boots crunching snow and mud, laboured breathing inside the helm.
POSITIVE LOCKS. Exactly 10 seconds, one unbroken shot, camera in constant motion.
Opens on a tight close-up of Knight 1's helm with his sword rising vertically into frame. Strong sun break and heavy snowfall present in every frame. The fight is fast, aggressive and continuous with many distinct blows. Bold hard camera punch-ins on the blade impacts. One wide frame catches both knights striking simultaneously. Disarm and kick seen from over Knight 2's shoulder. Finish is a fast orbit around Knight 2 landing over Knight 1's shoulder as he crawls backwards. Every banner moves in the wind throughout. Exactly two figures on the field, no other people. Armour matches @image2 and @image3, location matches @image1.
NEGATIVE. cuts, edits, jump cuts, static camera, still air, motionless banners, frozen flags, snow stopping, light snow, thin sparse snowfall, flat grey overcast with no sun, sunless sky, slow motion, speed ramps, freeze frame, slow lazy swings, telegraphed swings, weightless floating armour, wire-fly, superhero levitation, only two or three blows, long pauses between blows, third person in frame, extras, background soldiers, horses, real historical coats of arms, recognisable heraldry, national flags, readable text, logos, watermark, subtitles, blood, gore, dismemberment, fisheye distortion, oversaturated colour, sunny blue sky, clear weather, morphing armour, changing helmet design, extra limbs, duplicate characters, warped hands, rubbery limbs, floating feet.

中文解說：這是「導演分鏡式」影片提示的極致例子——總規格（一鏡到底、10 秒、16:9、無剪接）→ REFERENCES（每張 @image 綁定一個元素）→ CONSTANTS（每格都必須成立的條件）→ 時間碼分段（每段：鏡頭景別 + 動作 + Cam: 鏡頭焦距/光圈/運動）→ OPTICS / LIGHTING / PHYSICS / AUDIO → POSITIVE LOCKS 與 NEGATIVE。適合 Seedance 2.x、Kling 3.0 等支援多參考與長提示的模型。

Step 5–6：檢查輸出、只描述要改的具體問題讓 Claude 執行編輯；成品同時在 Assets。

官方 5 個提示（意譯）：① 想穩定控制就指名模型；② 一致性重要時用參考圖鎖定角色／產品；③ 具體描述輸出（格式、動作、構圖、風格、節奏、用途）；④ 先檢查一次生成才擴大規模；⑤ 預算重要時先要求顯示 credit 成本並等你批准。blog:claude-higgsfield-mcp-creative-studio

4. 官方 Bundles（higgsfield.ai/mcp）

5. 實用提示

• 指名模型就會用該模型；不指名則由 Agent 選（MCP 可用 30+ 模型）。blog:claude-higgsfield-mcp-creative-studio
• ChatGPT 範本（官方逐字）：

Generate a [length]-second [vertical or horizontal] video of [subject] [action] in [setting]. Camera: [shot size and movement]. Light: [direction and quality]. Mood: [feeling]. Before generating, show me the credit cost and wait for my confirmation.

• 修改時同一對話直接說要改甚麼（官方逐字例）：

Keep the same scene and light. Slow the pull-back so it takes the full ten seconds, and make the croissants a deeper golden brown. Keep the steam rising.

• 先問成本再生成（見上方範本最後一句）；所有生成都以標準價格扣 credits。help-mcp-cli

本頁來源（存取日期 2026-10-08）