CutX — agentická střižna

Architektura

orchestrátor

Claude (Desktop nebo Code)

Drží všechny tři konektory najednou. Rozumí zadání, řídí generování, import i střih. Pravidla workflow mu dodává skill cutx.

▼ ▼ ▼

generování

Higgsfield MCP

Hosted server mcp.higgsfield.ai (OAuth). Text/image → video přes Seedance, Kling, Veo a další. Vrací URL hotových klipů a job_id.

střižna

CutX konektor → Palmier Pro

Lokální MCP uvnitř aplikace (127.0.0.1:19789). 35 toolů: import_media z URL, tracky, klipy, titulky, efekty, export.

lokální most

CutX Tools

Stdio MCP: extract_frame (ffmpeg), http_put (upload na presigned URL), list_project_media. Umožňuje last-frame řetězení bez přenášení videí.

Instalace

00:00:01:00PALMIER PRO

Nainstaluj Palmier Pro

Stáhni DMG z palmier-pro releases, přetáhni do /Applications a spusť. Vyžaduje macOS 26+ na Apple Silicon. MCP server startuje s aplikací.

ověření

curl -s -o /dev/null -w "%{http_code}" -X POST http://127.0.0.1:19789/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}'
200

00:00:02:00FFMPEG

Nainstaluj ffmpeg

Používá ho CutX Tools na extrakci framů.

terminál

brew install ffmpeg

00:00:03:00KONEKTORY

Zabal a nainstaluj konektory do Claude Desktop

Naklonuj jtrjtrjtr/cutx a zabal oba .mcpb bundly:

terminál

# CutX Tools (root repa)
cd cutx/server && npm ci && cd ..
npx -y @anthropic-ai/mcpb pack . ~/Desktop/CutXTools.mcpb

# CutX (proxy na Palmier)
cd connector-palmier/server && npm i mcp-remote && cd ..
npx -y @anthropic-ai/mcpb pack . ~/Desktop/CutX.mcpb

Každý soubor otevři (double-click) → Claude Desktop → Install.

00:00:04:00HIGGSFIELD

Připoj Higgsfield konektor

V Claude Desktop: Settings → Connectors → Browse connectors → Higgsfield → přihlas se přes OAuth. Žádné API klíče.

00:00:05:00SKILL

Nahraj skill

Zazipuj složku skill/cutx/ z repa a nahraj v Settings → Capabilities → Skills. Skill nese pravidla workflow — bez něj Claude nástroje má, ale postup si vymýšlí.

00:00:06:00CLAUDE CODE

Volitelně: Claude Code

terminál

claude mcp add --transport http --scope user cutx http://127.0.0.1:19789/mcp
cp -R skill/cutx ~/.claude/skills/

Pozn.: po každé aktualizaci skillu nebo konektorů je potřeba v Desktopu přenahrát zip/mcpb — neaktualizují se samy.

Workflow

Cesta A · default

Vícezáběrové video

Shot list — video se rozpadne na samostatné záběry.
Paralelní generace — všechny joby do Higgsfieldu naráz; čeká se jen na nejpomalejší klip.
Konzistence přes charaktery / reference, ne přes framy.
import_media URL všech klipů → add_clips → střih, titulky, export.

Cesta B · dlouhý záběr

Souvislý záběr > 15 s

Klip N je po importu už na disku (.palmier/media/).
extract_frame — poslední frame jako JPEG (~200 kB).
Higgsfield media_upload → http_put → media_confirm.
Další segment se start_image = ten frame (+ video_references = job_id pro styl).
add_clips hned za konec N → opakovat do cílové délky.

⛔ Železné pravidlo

Nikdy se nestahuje ani neuploaduje celé video kvůli navázání. Video je lokálně už z importu do střižny; mezi Macem a Higgsfieldem cestuje jen jeden malý JPEG. A generování uvnitř Palmieru se nepoužívá (vyžaduje jejich předplatné) — generuje se výhradně přes Higgsfield.

Gotchas

kde	co si pamatovat
add_clips	Pole se jmenuje `entries` (ne clips); `startFrame` je povinný. `trackIndex` vynech — track se vytvoří automaticky.
manage_tracks	Umí jen `remove` / `reorder` / `set`. Nová timeline nemá žádné tracky; `trackIndex:0` na prázdné timeline selže.
import_media	Stahuje na pozadí — polluj `get_media`, dokud asset nemá metadata. Limit 1 GB, HTTPS URL nebo lokální cesta.
frames	Klip zabírá `[start, end)` v project fps — end je exkluzivní.
soubory	Projekty: `~/Documents/Palmier Pro/*.palmier` (bundle). Klipy uvnitř: `media/imported-<mediaRef>.mp4` — hledej podle mediaRef.
timeline	Rozlišení timeline se přizpůsobí prvnímu klipu — sleduj `notes` v odpovědích.