higgsfield-mcp-server

Remote-MCP-Server, der es Claude ermöglicht, Bilder und Videos über die Higgsfield AI API zu generieren – fotorealistische Fotos (Soul), referenzgeführte Bilder (Popcorn) und Videos (Google Veo 3.1, Kling, ByteDance Seedance) – direkt aus dem Chat.

Verfügbare Tools

Alle Generierungstools sind asynchron: Sie geben sofort eine request_id zurück; rufen Sie higgsfield_check_status auf (Claude erledigt das automatisch), bis der Auftrag completed ist.

Related MCP server: higgsfield-mcp

1. Holen Sie sich Ihre Higgsfield-API-Schlüssel

1. Gehen Sie zu https://cloud.higgsfield.ai und melden Sie sich an.

2. Erstellen Sie einen API-Schlüssel (das haben Sie bereits getan, wenn Sie dies lesen, nachdem Sie Claude um Hilfe gebeten haben) – Sie erhalten eine API Key ID und ein API Key Secret. Kopieren Sie beide, sie werden nur einmal angezeigt.

2. Stellen Sie diesen Server bereit (kostenloser Tarif funktioniert)

Sie benötigen 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 kleinen Server wie diesen keine Kreditkarte benötigen:

Option A: Render.com

1. Übertragen Sie diesen Ordner in ein neues GitHub-Repository (privat ist in Ordnung).

2. Auf https://render.com → New + → Web Service → verbinden Sie dieses Repository.

3. Einstellungen:

   • Runtime: Node

   • Build Command: npm install

   • Start Command: npm start

4. Fügen Sie unter Environment diese drei Variablen hinzu:

   • HF_API_KEY_ID = Ihre Higgsfield-API-Key-ID

   • HF_API_KEY_SECRET = Ihr Higgsfield-API-Key-Secret

   • MCP_ACCESS_TOKEN = eine beliebige lange zufällige Zeichenfolge, die Sie sich ausdenken (z. B. führen Sie openssl rand -hex 32 lokal aus, oder tippen Sie einfach 40+ Zeichen auf der Tastatur) – dies ist das Passwort, mit dem Claude mit Ihrem Server kommuniziert, damit niemand anderes Ihre Higgsfield-Guthaben ausgeben kann.

5. Stellen Sie bereit. Render gibt Ihnen eine URL wie https://higgsfield-mcp-server.onrender.com. Ihr MCP-Endpunkt ist diese URL + /mcp, z. B. https://higgsfield-mcp-server.onrender.com/mcp.

Hinweis: Die kostenlosen Webdienste von Render schlafen nach Inaktivität und benötigen beim nächsten Request ein paar Sekunden zum Aufwachen – für gelegentliche Nutzung in Ordnung.

Option B: Railway.app

Gleiche Idee: Neues Projekt aus diesem GitHub-Repository, setzen Sie dieselben drei Umgebungsvariablen, Railway erkennt npm start automatisch. Sie erhalten eine URL wie https://higgsfield-mcp-server-production.up.railway.app, der Endpunkt ist diese + /mcp.

3. Fügen Sie es Claude als benutzerdefinierten Connector hinzu

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

• Name: Higgsfield

• URL: https://<your-deployed-url>/mcp

• Authentifizierung: Bearer-Token → fügen Sie den MCP_ACCESS_TOKEN-Wert ein, den Sie in Schritt 2 festgelegt haben.

Aktivieren Sie es für Ihren Chat, und Claude kann die oben genannten Tools aufrufen.

Lokale Tests (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 Ihr Higgsfield-Konto und die Abrechnung. Sie leben nur in den Umgebungsvariablen des Hosts – committen Sie sie niemals, setzen Sie sie niemals in die URL.

• MCP_ACCESS_TOKEN verhindert, dass eine zufällige Person, die Ihre Server-URL findet, Inhalte auf Ihre Higgsfield-Guthaben generiert. Behandeln Sie es wie ein Passwort.

• Jeder Generierungsaufruf verbraucht Higgsfield-Guthaben gemäß der Preisgestaltung Ihres Tarifs.