higgsfield-mcp-server

Entfernter MCP-Server, mit dem Claude über die Higgsfield AI-API Bilder und Videos generieren kann – fotorealistische Fotos (Soul), referenzgesteuerte Bilder (Popcorn) und Videos (Google Veo 3.1, Kling, ByteDance Seedance) – direkt aus dem Chat.

Verfügbare Tools

Alle Generierungs-Tools arbeiten asynchron: Sie geben sofort eine request_id zurück; rufe higgsfield_check_status auf (Claude macht das automatisch), bis der Auftrag completed ist.

Related MCP server: gemini-nano-banana-mcp

1. Hol dir deine Higgsfield-API-Schlüssel

1. Gehe auf https://cloud.higgsfield.ai und melde dich an.

2. Erstelle einen API-Schlüssel (das hast du bereits getan, wenn du das hier liest, nachdem du Claude um Hilfe gebeten hast) – du erhältst eine API-Key-ID und ein API-Key-Geheimnis. Kopiere beides, es wird nur einmal angezeigt.

2. Diesen Server bereitstellen (kostenloser Tarif reicht)

Du brauchst einen Ort, an dem ein Node-Prozess rund um die Uhr läuft und über HTTPS erreichbar ist. Zwei kostenlose Optionen, die für einen so kleinen Server keine Kreditkarte erfordern:

Option A: Render.com

1. Schiebe diesen Ordner in ein neues GitHub-Repository (privat ist in Ordnung).

2. Auf https://render.com → Neu + → Web Service → verbinde das Repo.

3. Einstellungen:

   • Runtime: Node

   • Build-Befehl: npm install

   • Startbefehl: npm start

4. Füge unter Umgebung diese drei Variablen hinzu:

   • HF_API_KEY_ID = deine Higgsfield-API-Key-ID

   • HF_API_KEY_SECRET = dein Higgsfield-API-Key-Geheimnis

   • MCP_ACCESS_TOKEN = eine beliebige lange Zufallszeichenkette deiner Wahl (z. B. openssl rand -hex 32 lokal ausführen oder einfach 40+ Zeichen auf der Tastatur tippen) – das ist das Passwort, mit dem Claude mit deinem Server spricht, damit sonst niemand deine Higgsfield-Guthaben ausgeben kann.

5. Bereitstellen. Render gibt dir eine URL wie https://higgsfield-mcp-server.onrender.com. Dein MCP-Endpunkt ist diese URL + /mcp, z. B. https://higgsfield-mcp-server.onrender.com/mcp.

Hinweis: Renders kostenlose Webdienste schlafen nach Inaktivität ein und brauchen ein paar Sekunden, um bei der nächsten Anfrage wieder aufzuwachen – für gelegentliche Nutzung in Ordnung.

Option B: Railway.app

Gleiche Idee: neues Projekt aus diesem GitHub-Repo, dieselben drei Umgebungsvariablen setzen, Railway erkennt npm start automatisch. Du erhältst eine URL wie https://higgsfield-mcp-server-production.up.railway.app, der Endpunkt ist diese + /mcp.

3. Als benutzerdefinierten Connector zu Claude hinzufügen

In Claude (claude.ai / Desktop-App) → Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen:

• Name: Higgsfield

• URL: https://<deine-bereitgestellte-url>/mcp

• Authentifizierung: Bearer-Token → füge den MCP_ACCESS_TOKEN-Wert ein, den du in Schritt 2 festgelegt hast.

Aktiviere es für deinen Chat, und Claude kann die obigen Tools aufrufen.

Lokales Testen (optional)

cp .env.example .env   # fill in real values
npm install
npm start

Der Server lauscht auf http://localhost:3000/mcp (oder $PORT).

Sicherheitshinweise

• HF_API_KEY_ID / HF_API_KEY_SECRET gewähren vollen Zugriff auf dein Higgsfield-Konto und die Abrechnung. Sie existieren nur in den Umgebungsvariablen des Hosts – niemals einchecken, niemals in die URL setzen.

• MCP_ACCESS_TOKEN verhindert, dass eine beliebige Person, die deine Server-URL findet, Inhalte auf deine Higgsfield-Kosten generiert. Behandle es wie ein Passwort.

• Jeder Generierungsaufruf verbraucht je nach Tarif Higgsfield-Guthaben.