MiniMax MCP

MiniMax Model Context Protocol (MCP) sunucusunun resmi sürümü; güçlü Metin Okuma ve video/görsel üretim API'leriyle etkileşim sağlar. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents gibi MCP istemcilerinin konuşma üretmesine, ses klonlamasına, video üretmesine, görsel üretmesine ve daha fazlasına olanak tanır.

💡 Önerilen: MiniMax CLI (mmx-cli) — en yeni modelleri ve metin, görüntü ve arama dahil ek özellikleri içeren resmi komut satırı aracımız. Claude Code, Cursor, OpenClaw vb. için bir AI ajan becerisi olarak çalışır.

Dokümantasyon

• 中文文档
• MiniMax-MCP-JS - MiniMax MCP'nin resmi JavaScript uygulaması

MCP İstemcisi ile Hızlı Başlangıç

1. API anahtarınızı MiniMax adresinden alın.
2. uv (Python paket yöneticisi) kurun, curl -LsSf https://astral.sh/uv/install.sh | sh ile kurun veya ek kurulum yöntemleri için uv deposuna bakın.
3. Önemli: API ana bilgisayarı ve anahtarı bölgeye göre değişir ve eşleşmelidir; aksi takdirde Invalid API key hatasıyla karşılaşırsınız.

Bölge	Global	Anakara
MINIMAX_API_KEY	MiniMax Global adresinden alın	MiniMax adresinden alın
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Aşağıdakileri dahil etmek için Claude > Settings > Developer > Edit Config > claude_desktop_config.json adresine gidin:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ Uyarı: API anahtarı ana bilgisayarla eşleşmelidir. "API Error: invalid api key" hatası oluşursa, lütfen API ana bilgisayarınızı kontrol edin:

• Global Ana Bilgisayar：https://api.minimax.io
• Anakara Ana Bilgisayar：https://api.minimaxi.com

Windows kullanıyorsanız, MCP sunucusunu kullanmak için Claude Desktop'ta "Geliştirici Modu"nu etkinleştirmeniz gerekecektir. Sol üstteki hamburger menüsünde "Yardım"a tıklayın ve "Geliştirici Modunu Etkinleştir"i seçin.

Cursor

Yukarıdaki yapılandırmayı eklemek için Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server adresine gidin.

İşte bu kadar. MCP istemciniz artık MiniMax ile şu araçlar aracılığıyla etkileşim kurabilir:

Taşıma

İki taşıma türünü destekliyoruz: stdio ve sse.

stdio	SSE
Yerel olarak çalıştırın	Yerel olarak veya bulutta dağıtılabilir
stdout üzerinden iletişim	network üzerinden iletişim
Girdi: local files veya geçerli URL kaynaklarının işlenmesini destekler	Girdi: Bulutta dağıtıldığında, girdi için URL kullanılması önerilir

Kullanılabilir Araçlar

araç	açıklama
text_to_audio	Verilen bir sesle metni sese dönüştürün
list_voices	Kullanılabilir tüm sesleri listeleyin
voice_clone	Sağlanan ses dosyalarını kullanarak bir sesi klonlayın
generate_video	Bir istemden video üretin
text_to_image	Bir istemden görsel üretin
query_video_generation	Video üretim görevinin sonucunu sorgulayın
voice_design	Önizleme metnini kullanarak bir istemden ses üretin

Sürüm Notları

2 Temmuz 2025

🆕 Yenilikler

• Ses Tasarımı: Yeni voice_design aracı - açıklayıcı istemlerden önizleme sesiyle özel sesler oluşturun
• Video Geliştirme: Ultra net kalite ve süre/çözünürlük kontrolleriyle MiniMax-Hailuo-02 modeli eklendi

📈 Geliştirilmiş Araçlar

• voice_design - Metin açıklamalarından kişiselleştirilmiş sesler üretin
• generate_video - Artık 6s/10s süre ve 768P/1080P çözünürlük seçenekleriyle MiniMax-Hailuo-02'yi destekler

SSS

1. geçersiz api anahtarı

Lütfen API anahtarınızın ve API ana bilgisayarınızın bölgesel olarak hizalı olduğundan emin olun

Bölge	Global	Anakara
MINIMAX_API_KEY	MiniMax Global adresinden alın	MiniMax adresinden alın
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Lütfen terminalinizde şu komutu çalıştırarak mutlak yolunu doğrulayın:

which uvx

Mutlak yolu aldıktan sonra (ör. /usr/local/bin/uvx), yapılandırmanızı bu yolu kullanacak şekilde güncelleyin (ör. "command": "/usr/local/bin/uvx").

3. generate_video async modda nasıl kullanılır

Başlamadan önce tamamlama kurallarını tanımlayın: Alternatif olarak, bu kurallar IDE ayarlarınızda (ör. Cursor) yapılandırılabilir:

Örnek kullanım

⚠️ Uyarı: Bu araçları kullanmak maliyet doğurabilir.

1. akşam haberlerinin bir bölümünü yayınlayın

2. bir sesi klonlayın

3. bir video üretin

4. görseller üretin