MiniMax MCP Server einrichten

Der MiniMax MCP Server bringt Sprachsynthese, Stimmklonen sowie Bild- und Videogenerierung von MiniMax in einen MCP-fähigen KI-Client. Diese Anleitung führt durch API-Schlüssel-Beschaffung, Installation und die wichtigsten Umgebungsvariablen.

API-Schlüssel und Region festlegen

Erstelle zunächst im Entwickler-Dashboard der MiniMax-Plattform einen API-Schlüssel. Wichtig ist die Wahl der richtigen Region: Der globale Endpunkt lautet https://api.minimax.io, der Mainland-China-Endpunkt https://api.minimaxi.com. API-Schlüssel und Host-Region müssen laut Anbieter zusammenpassen, sonst schlägt die Authentifizierung mit einem „Invalid API key"-Fehler fehl.

uv installieren und den Server starten

Der Server benötigt den Python-Paketmanager uv, der sich per curl -LsSf https://astral.sh/uv/install.sh | sh installieren lässt. Anschließend startet uvx minimax-mcp -y den Server bei Bedarf automatisch, ohne dass eine separate Installation nötig ist. Für Node.js-Umgebungen bietet MiniMax zusätzlich eine eigenständige JavaScript-Variante als separates Repository an.

Client konfigurieren

Trage den Server in der Konfigurationsdatei deines Clients ein. Für Claude Desktop sieht der Eintrag in claude_desktop_config.json so aus: Befehl uvx, Argumente ["minimax-mcp", "-y"], sowie die Umgebungsvariablen MINIMAX_API_KEY (dein API-Schlüssel), MINIMAX_API_HOST (gewählte Region), MINIMAX_MCP_BASE_PATH (lokales Ausgabeverzeichnis für erzeugte Dateien) und optional MINIMAX_API_RESOURCE_MODE (url oder local, Standard ist url). Windows-Nutzerinnen und -Nutzer müssen laut Anbieter zusätzlich den Entwicklermodus in den Claude-Desktop-Einstellungen aktivieren, damit lokale Prozesse gestartet werden dürfen.

Erste Schritte mit Audio, Bild und Video

Teste die Verbindung zunächst mit list_voices, um die verfügbaren Stimmen zu sehen, und erzeuge dann mit text_to_audio eine erste Sprachausgabe. Für individuelle Stimmen kannst du mit voice_clone eine Stimme aus einer Audioprobe ableiten oder mit voice_design eine Stimme rein aus einer Textbeschreibung erzeugen. Bilder entstehen über text_to_image, Videos über generate_video auf Basis des MiniMax-Hailuo-02-Modells; da Videogenerierung länger dauert, prüfst du den Fortschritt mit query_video_generation.

Kosten im Blick behalten

Da laut Anbieter keine dauerhaft kostenlose Nutzung vorgesehen ist und jede Generierung Kosten gemäß der MiniMax-Preisstruktur verursachen kann, lohnt sich ein Blick in die offizielle Preisseite, bevor du den Server in automatisierte oder hochfrequente Workflows einbindest.

FAQ

Brauche ich für den MiniMax MCP Server ein kostenpflichtiges Abo? Ein dauerhaft kostenloses Kontingent ist in der Dokumentation nicht ausgewiesen; laut Anbieter verursacht die Nutzung der Werkzeuge Kosten gemäß der MiniMax-Preisstruktur.

Welchen Host-Endpunkt soll ich verwenden? Nutze api.minimax.io für den globalen Zugang und api.minimaxi.com für Mainland-China-Konten. API-Schlüssel und Host müssen zur selben Region gehören.

Kann ich fremde Stimmen ohne Einwilligung klonen? Das ist technisch möglich, aber ohne Zustimmung der aufgenommenen Person rechtlich und ethisch bedenklich; setze voice_clone nur mit eigenen Aufnahmen oder ausdrücklicher Erlaubnis ein.

Warum dauert die Videoerzeugung länger als eine normale Antwort? Videogenerierung läuft asynchron; generate_video startet den Auftrag, query_video_generation fragt anschließend den Bearbeitungsstatus ab.

Funktioniert der Server auch ohne Python? Für Node.js-Umgebungen bietet MiniMax eine eigenständige JavaScript-Variante als separates Repository an; der hier beschriebene Standardweg nutzt jedoch uv/uvx.