ai-machine-learning

Higgsfield MCP für Claude Code: Setup in 60 Sekunden (und 5 Stolperstellen)

Geschrieben von Techsy Editorial Team
Aktualisiert Jun 6, 2026
18 Lesezeit
Higgsfield MCP für Claude Code: Setup in 60 Sekunden (und 5 Stolperstellen)

Higgsfield MCP für Claude Code: Setup in 60 Sekunden (und 5 Stolperstellen)

Zuletzt aktualisiert: 6. Juni 2026. Installationsbefehl und OAuth-Ablauf erneut verifiziert. Modell-Roster (GPT Image 2, Soul V2, Veo 3.1, Kling 3.0, Flux 2, Nano Banana Pro, Seedance 2.0) als aktuell bestätigt. Gratis-Kredit-Kontingent (150/Monat) weiterhin korrekt.

Um Higgsfield MCP mit Claude Code zu verwenden, führen Sie claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp im Terminal aus. Claude Code übernimmt die Authentifizierung per Browser-OAuth — keine API-Keys erforderlich. Der Server stellt fünf Tools bereit (generate_image, generate_video, create_character, get_generation_status, list_characters) über sieben Modelle. Das Setup ist bei normaler Verbindung in unter 60 Sekunden abgeschlossen.

Higgsfield hat seinen gehosteten MCP-Server am 30. April 2026 veröffentlicht — acht Tage, bevor ich das hier schreibe. Wer Claude Code installiert hat, kann Higgsfield MCP mit einem einzigen Befehl einbinden, ohne API-Keys, ohne npm-Paket. Am Ende dieses Posts haben Sie den Server in jedem AI-Client eingerichtet, den Sie tatsächlich nutzen, wissen, welches der sieben Modelle für welchen Zweck gedacht ist, und haben ein Prompting-Rezept, das wir für Blog-Hero-Images nutzen.

Auf techsy.io verwenden wir bereits die vier Higgsfield-Agent-Skills — higgsfield-generate, higgsfield-product-photoshoot, higgsfield-soul-id und higgsfield-marketplace-cards — für Cover- und Lifestyle-Bilder und haben den MCP-Server daneben eingebunden, um reichhaltigere In-Conversation-Generierung zu ermöglichen. MCP ist der Punkt, an dem Context Engineering auf der Tool-Ebene sichtbar wird: Statt URLs und Prompts in eine separate Oberfläche einzufügen, wählt das Modell im selben Chat, in dem Sie schreiben, das Modell und die Parameter aus.

Kurzantwort

  • Higgsfield MCP ist ein gehosteter Server unter https://mcp.higgsfield.ai/mcp, der sieben Bild- und Videomodelle für jeden MCP-Client bereitstellt.
  • Installation in Claude Code mit einem Befehl; Authentifizierung läuft über OAuth, keine API-Keys.
  • Funktioniert mit Claude Code, Claude Desktop, Cursor, Windsurf, Cline und OpenCode.
  • Free Tier: 150 Credits/Monat (Stand Mai 2026); darüber hinaus ca. 1 $ = 16 Credits.

Was Higgsfield MCP tatsächlich macht

Higgsfield MCP ist ein gehosteter Model Context Protocol (MCP) Server unter https://mcp.higgsfield.ai/mcp, der jedem MCP-kompatiblen AI-Client (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, OpenCode) Zugriff auf sieben Bild- und Videomodelle über fünf Tools gibt — authentifiziert per OAuth. Keine API-Keys, kein npm install, kein Proxy.

Der Higgsfield MCP Server sitzt zwischen Ihrem AI-Client und einem Roster von 30+ generativen Modellen. Der gehostete Endpoint stellt die sieben bereit, zu denen wir am häufigsten greifen: Soul V2 für Character Consistency, Veo 3.1 und Kling 3.0 für Video, GPT Image 2 für fotografischen Realismus, Flux 2 für Illustration, Nano Banana Pro für schnelle Iterationen und Seedance 2.0 für kurze Clips. Sie können alle davon als verschiedene Modelle innerhalb von Claude Code aufrufen, ohne den Chat zu verlassen.

ModellTypAm besten fürCa. Credits/Gen
GPT Image 2BildFotorealismus, Produktfotos~8
Nano Banana ProBildSchnelle, günstige Iterationen~2
Soul V2BildCharacter Consistency (mit create_character)~10
Seedance 2.0VideoKurze Clips mit Bewegung~30
Veo 3.1VideoCinematische Clips, 8–15 s~60
Kling 3.0VideoFließende Bewegung, Character Action~50
Flux 2BildStilisiert, illustrativ~6

Free Tier: 150 Credits/Monat, Stand Mai 2026 und Änderungen vorbehalten.

Die fünf Tools, die der Server bereitstellt, sind die gesamte Oberfläche:

  • generate_image: einmalige Bildgenerierung
  • generate_video: asynchrone Videogenerierung, gibt eine Job-ID zurück
  • create_character: trainiert einen Soul Character für Konsistenz
  • get_generation_status: pollt einen asynchronen Job
  • list_characters: listet trainierte Characters auf

Das war's. Fünf Tools, keine API-Keys, keine Scopes auswendig lernen. Im Vergleich dazu, ein halbes Dutzend Vendor-APIs zusammenzustückeln, sieht man sofort, warum die MCP-Spezifikation so schnell Verbreitung gefunden hat. Für die vollständige Modellübersicht ist Higgsfields offizielle MCP-Seite die maßgebliche Quelle.

Wie füge ich Higgsfield MCP in Claude Code hinzu?

Um Higgsfield MCP in Claude Code zu installieren, führen Sie claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp aus. Claude Code öffnet beim ersten Aufruf einen Browser für OAuth; melden Sie sich bei Ihrem Higgsfield-Konto an, kehren Sie zum Terminal zurück und prüfen Sie mit claude mcp list oder dem Slash-Befehl /mcp. Das ist das gesamte Higgsfield MCP Setup.

Das ist der Teil, den die meisten vorhandenen Tutorials falsch machen. Vor dem 30. April gab es keinen gehosteten Server, und Autoren gingen davon aus, dass man ein npm-Paket installieren und einen HIGGSFIELD_API_KEY in die Shell einfügen müsse. Brauchen Sie nicht. Das gehostete MCP läuft auf Higgsfields Infrastruktur und authentifiziert sich per OAuth im Browser.

Der Installationsbefehl — einfach ins Terminal kopieren:

bash
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

Zwei Flags, die man kennen sollte. --transport http teilt Claude Code mit, dass dies ein HTTP-basierter gehosteter Server ist, kein lokaler stdio-Prozess. --scope user schreibt die Konfiguration nach ~/.claude/mcp.json, sodass der Server in jedem Projekt verfügbar ist, das Sie öffnen. Wenn Sie ihn nur in einem Repo wollen — und ins Git einchecken, damit das Team ihn automatisch bekommt — verwenden Sie stattdessen --scope project. Das schreibt in .mcp.json im Repo-Root.

Verifizierung:

bash
claude mcp list
# Higgsfield   http   ✔ connected

Beim ersten Aufruf eines Higgsfield-Tools startet Claude Code einen lokalen OAuth-Callback auf Port 8080 und öffnet den Browser. Melden Sie sich bei Ihrem Higgsfield-Konto an, kehren Sie zum Terminal zurück — fertig. In jeder Claude Code Session können Sie /mcp ausführen, um das Panel zu sehen. Higgsfield sollte dort mit fünf aufgelisteten Tools erscheinen.

Auf meinem M3 Pro war Install plus OAuth-Runde in 47 Sekunden abgeschlossen. Ihr Netzwerk kann variieren, aber wenn Sie nach zwei Minuten noch warten, springen Sie direkt zum Abschnitt „5 Stolperstellen" weiter unten.

Ein kurzer Hinweis: Wer das gleiche MCP lieber als Claude Code Skill verpacken möchte, macht das robonuggets-higgsfield-skill-Repo genau das. Das Muster haben wir in unserem Claude Code Skills-Tutorial beschrieben. Sie können auch MCP-Server über Hooks automatisieren — zum Beispiel automatisch list_characters aufrufen, bevor ein Blog-Hero generiert wird. Die vollständige Setup-Syntax für Claude Code beschreibt Anthropics MCP-Setup-Dokumentation für Transporttypen, Scope-Flags und Re-Auth-Flows.

generate_image-Tool-Aufruf in einer Claude Code Session.
generate_image-Tool-Aufruf in einer Claude Code Session.

Wie füge ich Higgsfield MCP in Claude Desktop hinzu?

Claude Desktop verwendet eine JSON-Konfigurationsdatei (claude_desktop_config.json) statt der claude mcp add CLI. Der Pfad variiert je nach Betriebssystem. Bearbeiten Sie die Datei, fügen Sie den Higgsfield-Block hinzu und starten Sie Claude Desktop vollständig neu. OAuth läuft beim ersten Tool-Aufruf, nicht beim Laden der Konfiguration.

BetriebssystemPfad
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Folgendes eintragen:

json
{
  "mcpServers": {
    "higgsfield": {
      "transport": {
        "type": "http",
        "url": "https://mcp.higgsfield.ai/mcp"
      }
    }
  }
}

Wenn Claude Desktop meldet, dass der Server aufgeführt ist, die Tools aber nicht sichtbar sind, wurde es nicht vollständig beendet. Cmd-Q auf macOS, nicht die rote Ampel-Schaltfläche. Das Schließen des Fensters lässt den Prozess mit der alten Konfiguration im Speicher weiterlaufen.

Higgsfield MCP in Cursor einrichten

Um Higgsfield MCP in Cursor zu verwenden, bearbeiten Sie ~/.cursor/mcp.json und fügen Sie den Higgsfield-Server mit HTTP-Transport hinzu, der auf https://mcp.higgsfield.ai/mcp zeigt. Starten Sie Cursor neu; der Server erscheint unter Settings → MCP Servers und authentifiziert sich per OAuth bei der ersten Generierungsanfrage. Das gleiche JSON funktioniert auch als .cursor/mcp.json im Projekt-Root.

Cursor erkennt HTTP-Transport automatisch am url-Feld, eine explizite Deklaration ist nicht nötig. Die Konfiguration:

json
{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Datei speichern, Cursor neu starten, Settings → MCP Servers öffnen. Dort sollte „higgsfield" mit grünem Punkt erscheinen. Das erste Mal, wenn Sie Cursor bitten „Generiere ein Hero-Image eines Fuchses in der goldenen Stunde mit Higgsfield", öffnet der Browser für OAuth und die Generierung läuft, sobald Sie sich angemeldet haben.

Kombinieren Sie das mit einer Cursor Rule, die immer Higgsfield für Hero-Images verwendet. Eine Rule in .cursor/rules/blog-images.mdc, die „blog hero"- oder „OG image"-Anfragen auf generate_image mit Ihrem Standard-Seitenverhältnis mappt, spart viel Tipparbeit. Pro-Tipp: Wenn Sie .cursor/mcp.json im Repo-Root committen statt die User-Scope-Datei zu nutzen, bekommt Ihr gesamtes Team den Server beim nächsten Pull. Kein Setup pro Entwickler, kein Slack-Thread, warum das Tool nicht erscheint.

Cursor mcp.json mit registriertem Higgsfield-Server.
Cursor mcp.json mit registriertem Higgsfield-Server.

Higgsfield MCP in Windsurf oder Cline installieren

Beide Clients verwenden die VS Code-ähnliche mcp.json-Struktur, sodass dasselbe JSON in beiden funktioniert. Windsurf liest ~/.codeium/windsurf/mcp_config.json; Cline (die VS Code Extension) verwendet seine Settings-UI oder .vscode/mcp.json im Workspace.

json
{
  "mcpServers": {
    "higgsfield": {
      "type": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Ein Cline-Tipp, den man sich merken sollte: „Auto-approve safe tools" nur für list_characters und get_generation_status aktivieren. generate_video nie automatisch genehmigen. Jeder Aufruf kostet 30–60 Credits, und ein autonomer Agent in einer Schleife kann den Free Tier in fünf Minuten aufbrauchen. Read-Tools: ja. Generierungs-Tools: nein.

Wie die beiden Clients im Alltag abschneiden? Unser Windsurf vs. Cursor-Vergleich deckt die Abwägungen ab. Für Higgsfield speziell ist die Erfahrung nach der Server-Registrierung identisch. Beide Clients sprechen das gleiche MCP-Wire-Protokoll.

Funktioniert Higgsfield MCP mit OpenCode?

Ja. OpenCode (die Open-Source-Alternative zu Claude Code, sst/opencode) spricht das gleiche MCP-Wire-Protokoll. Die Konfiguration liegt in .opencode/mcp.json im Repo-Root oder ~/.config/opencode/mcp.json für User-Scope. Ein Feldname unterscheidet sich von Claude Code — also bitte nicht blind den mcpServers-Block kopieren.

json
{
  "servers": {
    "higgsfield": {
      "transport": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Das Feld heißt servers, nicht mcpServers. Klassische Stolperstelle. Wenn die Tools nach dem Hinzufügen der Konfiguration in OpenCode nicht erscheinen, liegt es fast immer daran. Mit opencode mcp list prüfen — entspricht claude mcp list. Der OAuth-Ablauf ist identisch: Browser öffnet, Callback, fertig.

Wie prompts man Higgsfield über MCP am besten?

Das zuverlässigste Prompting-Rezept, das wir gefunden haben, ist MCSLA: Model, Composition, Subject, Lighting, Aesthetic. Es stammt aus dem MCSLA cinematic prompt skill und verwandelt ein vages „mach mir ein Hero-Image" in ein Brief, das Higgsfields Modelle tatsächlich umsetzen können. Fünf Felder, fünf Zeilen, jedes Mal.

  1. Model: zuerst das richtige Tool wählen. GPT Image 2 für Realismus, Soul V2 für wiederholende Characters, Flux 2 für stilisierte Arbeiten.
  2. Composition: den Shot rahmen („wide-angle Hero composition, Motiv links-Drittel, Negativraum rechts").
  3. Subject: was im Bild zu sehen ist, mit spezifischen Attributen („eine schwarze Keramiktasse, Kondenswasser perlt, auf verwitterter Eiche").
  4. Lighting: direktional und qualitativ („warmes Rim-Light von oben links, sanftes Fill-Light, tiefe blaue Schatten").
  5. Aesthetic: der finale Look („Magazin-Editorial, 35-mm-Filmkorn, Color-Grading für SaaS-Marketing").

Das Reference-Image-Chaining ist der Moment, in dem das MCP seinen Wert wirklich zeigt. v1 generieren, dann Claude fragen: „Jetzt mit stärkerem Kontrast und kühlerem Farbton." Der Chat-Verlauf behält die Bild-URL, sodass der nächste generate_image-Aufruf sie automatisch als Referenz übergibt. Sie iterieren im selben Gespräch, statt durch ein Web-UI hin und her zu springen.

Für Character Consistency über Higgsfield MCP ist der Soul Character Workflow die erste Wahl:

  1. create_character mit 3–5 Referenzbildern ausführen.
  2. Drei bis fünf Minuten auf das Training warten; mit get_generation_status pollen.
  3. Die zurückgegebene Character-ID in nachfolgenden generate_image-Aufrufen referenzieren.
  4. Ergebnis: dasselbe Gesicht über eine gesamte Blog-Serie, kein Drift.

Dieses Muster verwenden wir genau so auf techsy.io. Higgsfields higgsfield-product-photoshoot Skill plus der higgsfield-soul-id Skill produzieren die Team-Member-Illustrationen und Marketplace Cards auf der gesamten Site. Der MCP-Server erlaubt uns, innerhalb einer Claude Code Conversation zu iterieren, statt für Einzel-Varianten in eine separate UI zu wechseln. Wenn wir wiederholte Character-Arbeit brauchen — dieselbe Person, zehn Posts — ist higgsfield-soul-id der Skill, den wir wählen. Für saisonale Marketplace Cards ist higgsfield-marketplace-cards schneller.

Noch ein letzter Tipp: Speichern Sie Ihren House Style als CLAUDE.md-Rule, damit jeder Prompt on-brand bleibt, ohne die gleichen fünf Zeilen immer wieder einzutippen. Und wenn Sie eine Startbibliothek wollen, verpackt AKCodez's 19 Style Packs gängige Ästhetik-Presets als drop-in Claude Code Skills.

Wie generiert man Blog-Hero-Images mit Higgsfield MCP?

Um Blog-Hero-Images mit Higgsfield MCP zu generieren, weisen Sie Ihren AI-Client an, generate_image mit einem 1200×630-Seitenverhältnis, einem MCSLA-Brief und dem GPT Image 2 Modell aufzurufen. Die zurückgegebene URL speichern, zu WebP optimieren und ins CMS hochladen. Von Prompt bis zum in Sanity hochgeladenen WebP dauert es mit verdrahtetem MCP ca. 90 Sekunden — kein separater Tab nötig.

So läuft das auf diesem Blog ab. Wir entwerfen einen Hero-Prompt im blog-hero-image-Skill des Posts (einer pro Post, versionskontrolliert). Innerhalb von Claude Code, während wir am Post arbeiten: „Generiere ein Prozessdiagramm-Hero für diesen Post mit GPT Image 2, 1200×630, Navy-Hintergrund, drei beschriftete Boxen." Das ruft generate_image auf, Higgsfield gibt eine gehostete URL zurück, unsere scripts/generate_image.py-Pipeline skaliert sie auf WebP bei Qualität 85 herunter, und scripts/upload_hero_image.py schickt sie zu Sanity.

Ein typischer Tool-Aufruf in einer Claude Code Session sieht so aus:

text
Tool call: generate_image
  model: "gpt-image-2"
  prompt: "Process diagram, three labeled boxes left-to-right..."
  aspect_ratio: "landscape_16_9"
  quality: "high"

Pro-Tipp: nicht direkt 1200x630 angeben. Die meisten Modelle bevorzugen Verhältnisbegriffe wie landscape_16_9 und lehnen genaue Pixel-Angaben ab. Im nächsten Verhältnis generieren und am Ende 5 % beschneiden, um auf die exakten Abmessungen zu kommen. Das spart einen Credit pro fehlgeschlagenem Retry.

Wer diese Aufrufe in einem Skript verpacken möchte (zehn Heroes aus einer CSV mit Prompts generieren), findet auf GitHub eine leichtgewichtige Python-Implementierung, die dieselben Aufrufe außerhalb der Conversation spiegelt. Wir nutzen sie für Batch-Backfills.

Für die Wiederverwendung desselben Assets über Kanäle hinweg übernimmt unsere Community-Automatisierung Cover Image Prompter, die Blog-Inhalte in Hero-Image-Briefs umwandelt, den Brief-Writing-Schritt. Kombiniert mit dem Social Banner Generator wird ein MCP-generiertes Hero zu vier Social-Varianten — ohne neu zu prompten.

Ein Blog-Hero, gerendert über generate_image via MCP.
Ein Blog-Hero, gerendert über generate_image via MCP.

Kann Higgsfield MCP kurze Videos für Blog-Zusammenfassungen generieren?

Technisch ja. Ehrlich gesagt: mit Einschränkungen. Der Mechanismus ist generate_video mit Veo 3.1 oder Seedance 2.0, 8–15 Sekunden, asynchron. Der Aufruf gibt eine Job-ID zurück, und man pollt mit get_generation_status, bis die URL erscheint. Wir experimentieren damit für Post-Summary-Clips, setzen es aber noch nicht auf jedem Post ein.

Zwei ehrliche Hinweise. Erstens ist die Videogenerierung nicht schnell. Veo 3.1 braucht 45–90 Sekunden für einen 8-Sekunden-Clip; Seedance 2.0 liegt näher an 30 Sekunden. Pro Render eine Kaffeepause einplanen. Und wer in einer engen Schleife pollt, zahlt nur für leere processing-Antworten. Poll-Intervall auf 5 Sekunden setzen, nicht 1.

Zweitens hat unser Sanity CMS noch keinen videoBlock Body-Typ. Das kommt noch in unserer Pipeline, ist aber noch nicht ausgerollt. Im Moment betten wir MCP-generierte MP4s als HTML5-<video>-Tags in einem Custom Block ein. Das ist heute keine One-Click-Lösung, und das wollen wir nicht so darstellen.

Der Use Case, auf den wir hinarbeiten: eine 12-Sekunden-Post-Summary-Animation, geprompt als „process diagram in motion" mit demselben MCSLA-Brief wie das statische Hero. Gleiche Farbpalette, gleiche Komposition, nur animiert. Den größeren Kontext zu KI in Video-Produktions-Workflows deckt unser Deep-Dive dort auf der redaktionellen Seite ab.

Wer Zugang zu Modellen braucht, die das gehostete MCP noch nicht bereitstellt (z. B. Sora 2), ist der Community-Fork, der Sora 2 / Veo 3 Zugang hinzufügt, einen Blick wert. Es ist ein selbst-gehosteter MCP-Wrapper, für den man eigene API-Keys für die Modelle mitbringt, die nicht im Higgsfield-Roster sind.

Troubleshooting: 5 Stolperstellen, die Sie 30 Minuten kosten

Die fünf häufigsten Probleme mit Higgsfield MCP: OAuth-Token abgelaufen (erneut über /mcp-Panel authentifizieren), Server steckt auf „pending" (Claude Code versucht es fünfmal mit exponentiellem Backoff), falsches Scope-Flag (--scope user vs. --scope project), Modell nicht gefunden (Tippfehler im Modellnamen), Video steckt beim asynchronen Polling (manuell get_generation_status aufrufen oder neu starten). Jeder Fix dauert unter zwei Minuten, wenn man ihn kennt.

OAuth-Token abgelaufen

Symptom: Tools erscheinen in /mcp, aber jeder Aufruf gibt „unauthorized" zurück. Fix: In Claude Code /mcp ausführen, Higgsfield auswählen, „Re-authenticate" wählen. Browser öffnet sich, wieder anmelden, fertig. Tokens haben eine begrenzte Lebensdauer (meist ein paar Wochen) und es gibt keine proaktive Warnung.

Server bleibt auf „Pending" stecken

Symptom: claude mcp list zeigt ⏳ neben Higgsfield statt ✔. Fix: Claude Code versucht HTTP/SSE mit exponentiellem Backoff (1 s → 2 s → 4 s → 8 s → 16 s) und gibt nach fünf Versuchen auf. claude mcp restart higgsfield ausführen. Wenn es noch immer „pending" zeigt, https://status.higgsfield.ai prüfen. Das gehostete MCP ist gelegentlich während Modell-Rollouts beeinträchtigt.

Falsches Scope-Flag (--scope user vs. --scope project)

Symptom: Server funktioniert in einem Repo, aber nicht in einem anderen. Fix: --scope user schreibt in ~/.claude/mcp.json (global, jedes Projekt). --scope project schreibt in .mcp.json im aktuellen Verzeichnis (wird in Git eingecheckt, mit dem Team geteilt). Wenn man nach zwei Minuten Installation noch wartet, ist es fast immer das Scope-Flag. Eines wählen und das andere löschen.

Modell nicht gefunden

Symptom: Error: model "veo-3" not found. Fix: Der Modellname ist veo-3.1, nicht veo-3. list_characters ausführen, um genaue Modell-Identifier in den Response-Metadaten zu sehen, oder die Tabelle im ersten H2-Abschnitt prüfen. Higgsfield-Namen sind case-sensitive und versionsgestempelt — Soul und soul-v2 sind nicht derselbe String.

Video steckt beim asynchronen Polling

Symptom: generate_video gibt eine Job-ID zurück, aber get_generation_status liefert nach über drei Minuten weiter processing. Fix: Veo- und Kling-Jobs können 90+ Sekunden dauern, aber nach drei Minuten ist der Job entweder lautlos fehlgeschlagen oder in der Queue stecken geblieben. claude mcp restart higgsfield ausführen und neu starten. Free-Tier-Konten haben niedrigere Queue-Priorität, sodass bezahlte Nutzer dieses Problem seltener haben.

Wer in CI immer wieder MCP-Timeouts hat: Die Higgsfield CLI läuft headless und ist skriptfreundlicher. Das MCP braucht einen interaktiven OAuth-Roundtrip; die CLI nutzt langlebige API-Tokens — das ist für nicht-konversationelle Pipelines die richtige Wahl.

FAQ

Was ist Higgsfield MCP?

Higgsfield MCP ist ein gehosteter Model Context Protocol Server unter https://mcp.higgsfield.ai/mcp, der sieben Bild- und Videogenerierungsmodelle (darunter GPT Image 2, Soul V2, Veo 3.1, Kling 3.0 und Flux 2) für jeden MCP-kompatiblen AI-Client bereitstellt. Die Authentifizierung läuft über OAuth per Higgsfield-Konto; für den gehosteten Server werden keine API-Keys benötigt.

Ist Higgsfield MCP kostenlos?

Ja, es gibt einen Free Tier mit 150 Credits pro Monat, Stand Mai 2026. Darüber hinaus kosten Prepaid-Credits ca. 1 $ = 16 Credits, und einzelne Generierungen kosten je nach Modell und Länge 2–60 Credits. Ein Standbild kostet ca. 2–10 Credits; ein 8-Sekunden-Veo-Clip ca. 60. Die bezahlten Pläne von Higgsfield können sich ändern — auf deren Abrechnungsseite nach aktuellen Preisstufen schauen.

Wie installiere ich Higgsfield MCP in Claude Code?

Im Terminal claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp ausführen. Claude Code öffnet beim ersten Aufruf einen Browser für OAuth; im Higgsfield-Konto anmelden, zum Terminal zurückkehren und mit claude mcp list oder dem Slash-Befehl /mcp in einer Claude Code Session prüfen. Der gesamte Ablauf dauert bei normaler Verbindung deutlich unter einer Minute.

Funktioniert Higgsfield MCP mit Codex oder ChatGPT Desktop?

OpenAIs Codex CLI: ja — es spricht das Standard-MCP-Wire-Protokoll, sodass die gleiche mcp.json-Konfiguration dort funktioniert. ChatGPT Desktop: nein, Stand Mai 2026. OpenAI hat MCP-Unterstützung in der Consumer-ChatGPT-App noch nicht ausgerollt. Wer speziell Sora 2 oder andere OpenAI-Modelle braucht, die das gehostete Higgsfield MCP nicht bereitstellt, kann die Community Unified Fork nutzen.

Higgsfield MCP vs. CLI: Was sollte man verwenden?

Das MCP für konversationelle, In-Chat-Generierung verwenden, bei der das Modell Parameter aus dem Kontext wählt — das ist der Großteil der Blog-Writing- und Design-Iteration-Workflows. Die CLI für headless, geskriptete Pipelines, CI-Jobs oder Batch-Backfills, bei denen man langlebige Auth-Tokens statt eines interaktiven OAuth-Flows braucht. Das MCP lässt sich auch als Claude Skill verpacken für wiederkehrende Muster.

Welche Modelle unterstützt Higgsfield MCP?

Der gehostete Server bietet aktuell sieben primäre Modelle: GPT Image 2 und Nano Banana Pro für allgemeine Bildarbeit, Soul V2 für Character Consistency, Flux 2 für stilisierten Output sowie Seedance 2.0, Veo 3.1 und Kling 3.0 für Video. Higgsfields vollständiger Roster umfasst 30+ Modelle, und das gehostete MCP-Roster wächst, wenn neue Modelle über die Plattform ausgerollt werden.

Kann ich Higgsfield MCP headless in CI betreiben?

Nicht direkt. Das gehostete MCP erfordert beim ersten Auth-Vorgang einen interaktiven OAuth-Roundtrip, der in einer CI-Umgebung nicht funktioniert. Für CI die Higgsfield CLI (@higgsfield/cli) nutzen, die langlebige API-Tokens verwendet, die man als CI-Secret speichern kann. Das MCP ist für interaktive Sessions; die CLI ist für Automatisierungspipelines und Batch-Generierungsjobs.

Wie erhalte ich Character Consistency über Generierungen hinweg?

create_character mit 3–5 Referenzbildern des Motivs verwenden. Das Tool gibt nach ca. 3–5 Minuten Training eine Character-ID zurück. Diese ID in nachfolgenden generate_image-Aufrufen mit dem Soul V2 Modell referenzieren — dann erscheint dasselbe Gesicht in jeder Generierung. Das ist das Arbeitspferd-Muster für Blog-Serien, Produkt-Maskottchen und alle Projekte, die visuelle Kontinuität brauchen.

Kostet Higgsfield MCP mehr als Sora oder Veo direkt anzusprechen?

In den meisten Fällen vergleichbar. Higgsfield kauft API-Kapazität im Großhandel ein und verkauft sie als Credits, sodass die Kosten pro Generierung in der Nähe der Anbieterpreise liegen. Der Trade-off: konsolidierte Abrechnung, OAuth statt eines Dutzends API-Keys und konversationelle UX über MCP. Für Einzel-Skripte spart man möglicherweise etwas beim Direktzugang; für laufende kreative Arbeit ist Higgsfield der einfachere Weg.

Ist Higgsfield MCP mit Claude Code kostenlos nutzbar?

Ja, der Free Tier bietet 150 Credits pro Monat ohne Kosten — das entspricht etwa 15 Standbildern mit GPT Image 2 oder zwei Veo-3.1-Videoclips. Claude Code selbst berechnet keine zusätzlichen Gebühren für MCP-Tool-Aufrufe. Über das kostenlose Kontingent hinaus kosten Prepaid-Credits ca. 1 $ für 16 Credits. Für Teams, die in größerem Umfang Hero-Bilder generieren, lohnt sich der bezahlte Plan; für einzelne Entwickler deckt der Free Tier leichte bis moderate Nutzung ab.

Was kann man mit Higgsfield MCP in Claude Code generieren?

Der Server bietet Bildgenerierung (Einzelaufnahmen, Produktfotoshootings, stilisierte Illustrationen), Videogenerierung (cinematische Clips bis zu 15 Sekunden mit Veo 3.1 oder Kling 3.0) und Character-Training für visuelle Konsistenz. In der Praxis nutzen Teams es für Blog-Hero-Images, OG-Cards, Produkt-Mockups und kurze Post-Summary-Animationen — alles direkt aus dem Claude Code Workflow heraus, ohne ein separates Kreativ-Tool zu öffnen.

Wenn KI-Funktionen auf Ihrer Roadmap stehen, ist das unsere Spezialität: Das KI-Integrationsteam von Techsy bringt LLM-Systeme vom Prototyp in die Produktion.

Zusammenfassung

Das war die vollständige Tour: Ein-Zeilen-Install für Claude Code, JSON-Snippets für jeden anderen wichtigen MCP-Client, das MCSLA-Prompting-Rezept, den Soul Character Workflow für Konsistenz und die fünf Stolperstellen, die Ihren Nachmittag kosten, wenn Sie sie nicht kennen. Wenn Sie noch bei der Wahl Ihres AI-Clients sind, deckt unser Claude Code vs. Cursor vs. Copilot Vergleich die breitere Übersicht ab.

Wenn Sie lieber möchten, dass wir Higgsfield MCP in die Content-Pipeline Ihres Teams integrieren — neben Sanity oder Ihrem CMS der Wahl — holen Sie sich eine kostenlose Beratung.

Tags

higgsfield mcpclaude codemcp serverki-bildgenerierungki-videogenerierung

Diesen Artikel teilen

Ihr Projekt starten

Bereit, etwas Außergewöhnliches zu bauen?

Machen wir aus Ihrer Vision ein fertiges Produkt. Unser Team baut mit Ihnen Software, die spürbar etwas bewegt.