Higgsfield Katana: Recreate Any Video Edit Shot-for-Shot, Right Inside Claude

Originally posted on Higgsfield.AI

What Is Higgsfield Katana?

Katana is built around reference-based editing rather than text-only prompting. Here's how it works:

• Reference Footage: Upload your own video (3 to 30 seconds) or choose a template from the Katana preset catalog. Katana reads the edit's pacing, cuts, camera motion, and audio sync.
• Asset Mapping: Upload up to five reference photos, such as product angles, character headshots, or apparel.
• Automated Reconstruction: Claude plans the sequencing, cut points, and motion instructions, while Higgsfield's video engines (including models like Seedance) generate the shots.
• Direct Delivery: The finished MP4 appears right in your Claude chat and automatically syncs to your Assets dashboard on higgsfield.ai.

How to Set Up Katana in Claude

Katana runs through a remote MCP server, so there's no terminal, Docker, or API key setup required.

1. Open Connector Settings. In claude.ai or the Claude desktop app, click your profile icon in the bottom-left corner and go to Settings → Connectors.
2. Add a Custom Connector. Click "Add custom connector" and enter Name: Higgsfield, Server URL: https://mcp.higgsfield.ai/mcp.
3. Authorize the Connection. Click "Add", then "Connect". A browser window opens to higgsfield.ai — log in and select "Authorize".
4. Launch Katana. Start a new Claude conversation and type /katana. Claude will load the Katana preset directory or ask you to attach your reference clip and assets.

Best Practices for the Best Output

1. Use Clean, Multi-Angle Asset Photos

Katana accepts up to five asset photos. To help the model separate your subject from the background:

• Use high-resolution photos on neutral or high-contrast backgrounds.
• Provide multiple angles: front, 45-degree, side profile, and a close-up of texture.
• Match your image aspect ratio to the reference video (9:16 for short-form social, 16:9 for landscape).

2. Protect Your Credits

Katana uses your existing Higgsfield subscription credits, with no extra Claude charge. But video generation burns through credits fast. Add a safeguard to your instructions or opening prompt:

3. Fix One Shot, Not the Whole Video

If one cut or transition misses, don't re-render everything. Give time-specific instructions instead:

4. Separate Motion From Style

Be clear about what each input controls:

• The reference video sets cut timing, transition style, and camera motion.
• Your uploaded images set the color palette, product shape, and character identity.

Troubleshooting Guide

Problem	Cause	Fix
"Tool call failed" or MCP timeout	The hosted MCP connection dropped or your authorization expired.	Go to Settings → Connectors, disconnect Higgsfield, and reconnect to re-authorize.
/katana command not recognized	The connector is inactive, or your workspace doesn't allow connectors.	Confirm the connector shows as active. On a Team or Enterprise account, check with your workspace admin that MCP integrations are allowed.
Output aspect ratio is wrong	Katana copies the aspect ratio and frame rate of your reference clip.	Crop your reference video to the format you want (for example, 9:16) before uploading.
Faces or products look distorted	Too few reference angles or busy backgrounds in your asset photos.	Use clean, single-subject photos with even lighting and simple backgrounds.
Render fails with no clear reason	Not enough Higgsfield credits.	Check your balance on the higgsfield.ai dashboard. Claude will show an error if a render needs more credits than you have.
Can't find a high-res download	The in-chat preview is compressed.	Download the full-quality file from the Assets tab on your higgsfield.ai dashboard.

The Takeaway

Katana flips the script on AI video: instead of guessing with text prompts, you start from an edit that already works and swap in your own assets. Set it up once, feed it clean photos, guard your credits, and fix shots one at a time.

What edit will you recreate first?