Connecting Higgsfield to Claude takes about 30 seconds with no API key or code. In Claude, go to Settings, Connectors, Add custom connector, paste the MCP URL https://mcp.higgsfield.ai/mcp, and authorize with your Higgsfield account. You need an active paid Higgsfield subscription and a Claude account. Once connected, you can generate images, videos, and audio, and use your Soul characters right from the conversation.
What do I need before connecting?
An active paid Higgsfield subscription and a Claude account (claude.ai or Claude Desktop). No API key, no code, no environment variables.
How do I connect in Claude.ai (web)?
Open claude.ai, click your profile icon, and go to Settings → Connectors.
Click Add custom connector.
Paste the MCP server URL: https://mcp.higgsfield.ai/mcp
Click Connect: a Higgsfield authorization window opens.
Sign in to your Higgsfield account and authorize. If you're already logged in on
higgsfield.ai, this step is automatic.
Return to Claude: the Higgsfield connector appears in your active connectors list.
How do I connect in Claude Desktop?
The steps are the same: Settings (top menu, or Cmd+, on Mac) → Connectors → Add custom connector, paste https://mcp.higgsfield.ai/mcp, click Connect, and authorize with your Higgsfield account.
How do I verify the connection is working?
Start a new Claude conversation and ask "What is my Higgsfield credit balance?" or "List my recent Higgsfield generations." Claude will call the MCP tools and return your account data. If it responds without calling any tools, check your Connectors list and reconnect.
What can I generate through MCP?
Operation | Available via MCP |
|---|---|
Image and video generation (all models) | Yes |
Image and video upscaling | Yes |
Background removal (image and video) | Yes |
Expand image (outpaint) and expand video (reframe) | Yes |
Kling 3.0 Motion Control | Yes |
Soul characters and reference Elements | Yes |
Audio: voiceover, voice cloning, voice change, video dubbing | Yes |
Personal Clipper (YouTube videos into short clips) | Yes |
Check credit balance, list generations and uploads | Yes |
Unlimited model access | No |
Free generations | No |
Every generation through MCP deducts credits, regardless of your plan. See What is Higgsfield MCP, and how is it different from the web app?
How do I give Claude the right instructions?
Claude selects a model automatically if you don't name one. You can also specify exactly what to use:
Specify the model. "Generate a video using Seedance of a person walking through a forest at sunrise, realistic motion, camera tracking close."
Use a Soul character. "Generate an image using my Soul character [name] in an editorial fashion setting, studio lighting, neutral background."
Use a reference Element. "Generate an image with my element [name] in a rooftop cafe at golden hour." Elements are reusable references for characters, environments, and props, and you can use several in one prompt.
Audio. "Generate a voiceover for this text in a warm professional tone: [text]."
Check balance before generating. "What is my current Higgsfield credit balance?"
Approve before spending. At the start of a session, say: "Before generating anything, tell me the credit cost and wait for my confirmation."
How do I pass a reference image through MCP?
Claude can't read images attached to the chat itself: reference files reach Higgsfield through a separate upload step that Claude opens for you. Just tell Claude what you want to use, and it picks the right path.
A file on your device. Say something like "I have a photo on my computer I want to use as the character reference." Claude opens the Higgsfield upload window right in the conversation: choose the file there, and it uploads directly to your Higgsfield account. Once the upload is confirmed, describe its role in the prompt: "Use the uploaded image as the character reference and generate a video of them walking through Times Square at night."
An image from the web. Paste the direct image URL into the chat and describe its role: "Import this image and use it as the style reference: [link]." Claude imports it into your Higgsfield uploads and passes it to the generation.
A past generation or a saved character. Nothing to upload: reference a previous Higgsfield generation ("use the portrait I generated earlier as the start frame"), a reference Element by name, or a trained Soul character by name, and Claude passes it to the model directly.
For Kling 3.0 Motion Control, you need two inputs: a character image and a motion reference video. Claude opens the upload window for each, and you describe which is which: "The image is the character, the video is the motion reference."
If Claude asks you to attach a file to the chat instead of opening the upload window, remind it: "Open the Higgsfield upload window for my file."
Where do my MCP generations appear?
All MCP generations land in your Assets at higgsfield.ai, exactly like generations made on the web, tagged with the MCP source so you can filter by it. Results typically appear within 60 seconds of the job completing.
Common issues and fixes
"Authorization with the MCP server failed." The authentication token has expired. Go to Settings → Connectors → Higgsfield, click Disconnect, then reconnect and re-authorize: this refreshes the token.
The connector appears connected, but Claude isn't calling Higgsfield tools. Start a new conversation and mention Higgsfield explicitly. Check whether the connector is toggled on in the current conversation: some Claude interfaces have a per-conversation toggle.
"MCP HTTP exchange failed" in Cursor or another agent. A transient connection error: retry the request. If it persists, disconnect and reconnect the MCP server in your agent's settings.