MiniMax MCP
resmiMiniMax'in güçlü Metin-konuşma, görüntü ve video üretim API'leriyle etkileşim kurun.
MiniMax MCP ile neler yapabilirsiniz?
- Metinden konuşmaya — Asistandan, yazılı metni belirtilen bir sesi kullanarak sese dönüştürmesini isteyin.
- Ses klonlama — Sağladığınız ses dosyalarından bir sesi klonlayın, ardından konuşma üretiminde yeniden kullanın.
- Ses tasarımı — Önizleme sesiyle birlikte açıklayıcı bir istemden özel bir ses oluşturun.
- Görsel oluşturma ve düzenleme — İstemlerden 1K/2K/4K boyutlarında görseller oluşturun veya bir istem ve en fazla 16 referans görseli kullanarak bir görseli düzenleyin.
- Video oluşturma — Süre ve çözünürlük seçenekleriyle bir istemden video oluşturun ve ardından görev sonucunu sorgulayın.
Dokümantasyon

Güçlü Metinden Konuşmaya ve video/görüntü oluşturma API'leriyle etkileşim kurulmasını sağlayan resmi MiniMax Model Context Protocol (MCP) sunucusu. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents ve diğerleri gibi MCP istemcilerinin konuşma oluşturmasına, sesleri klonlamasına, video ve görüntü oluşturmasına ve daha fazlasını yapmasına olanak tanır.
💡 Önerilen: MiniMax CLI (mmx-cli) — en yeni modelleri ve metin, görsel ve arama özellikleri dahil ek özellikleri sunan resmi komut satırı aracımız. Claude Code, Cursor, OpenClaw vb. için bir yapay zekâ ajanı becerisi olarak çalışır.
Belgeler
- 中文文档
- MiniMax-MCP-JS - MiniMax MCP'nin resmi JavaScript uygulaması
MCP İstemcisiyle Hızlı Başlangıç
- API anahtarınızı MiniMax üzerinden alın.
uv(Python paket yöneticisi) aracını yükleyin,curl -LsSf https://astral.sh/uv/install.sh | shile yükleyin veya ek yükleme yöntemleri içinuvdeposuna bakın.- Önemli: API ana bilgisayarı ve anahtar bölgeye göre değişir ve eşleşmeleri gerekir; aksi takdirde
Invalid API keyhatasıyla karşılaşırsınız.
| Bölge | Global | Mainland |
|---|---|---|
| MINIMAX_API_KEY | MiniMax Global üzerinden alın | MiniMax üzerinden alın |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Claude Desktop
Aşağıdakileri eklemek 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ının ana bilgisayarla eşleşmesi gerekir. "API Error: invalid api key" hatası oluşursa lütfen API ana bilgisayarınızı kontrol edin:
- Global Host:
https://api.minimax.io - Mainland Host:
https://api.minimaxi.com
Windows kullanıyorsanız MCP sunucusunu kullanmak için Claude Desktop'ta "Developer Mode" seçeneğini etkinleştirmeniz gerekir. Sol üstteki hamburger menüsünden "Help" seçeneğine tıklayın ve "Enable Developer Mode" seçeneğini belirleyin.
Cursor
Yukarıdaki yapılandırmayı eklemek için Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server adresine gidin.
Hepsi bu kadar. MCP istemciniz artık bu araçlar aracılığıyla MiniMax ile etkileşim kurabilir:
Aktarım
İki aktarım türünü destekliyoruz: stdio ve sse.
| stdio | SSE |
|---|---|
| Yerel olarak çalıştırılır | Yerel olarak veya bulutta dağıtılabilir |
stdout üzerinden iletişim | network üzerinden iletişim |
Girdi: local files veya geçerli URL kaynaklarını işlemeyi destekler | Girdi: Bulutta dağıtıldığında, girdi için URL kullanılması önerilir |
Kullanılabilir Araçlar
| araç | açıklama |
|---|---|
text_to_audio | Belirtilen bir sesle metni sese dönüştürür |
list_voices | Kullanılabilir tüm sesleri listeler |
voice_clone | Sağlanan ses dosyalarını kullanarak bir sesi klonlar |
generate_video | Bir istemden video oluşturur |
text_to_image | Bir istemden görüntü oluşturur. Varsayılan olarak MiniMax-H3-Image kullanılır (area 1K/2K/4K ve size desteklenir); image-01 hâlâ model aracılığıyla kullanılabilir |
image_edit | Bir istem ve 1-16 referans görüntü kullanarak MiniMax-H3-Image ile görüntü düzenler |
query_video_generation | Video oluşturma görevinin sonucunu sorgular |
voice_design | Önizleme metni kullanarak bir istemden ses oluşturur |
Sürüm Notları
10 Kasım 2026
🆕 Yenilikler
- Görüntü Düzenleme: Yeni
image_editaracı — bir istem ve 1-16 referans görüntü (URL, veri URI'si,mm_file://veya yerel yol) kullanarak MiniMax-H3-Image ile görüntüleri düzenleyin - H3 Görüntü Oluşturma:
text_to_imageartık varsayılan olarak MiniMax-H3-Image kullanıyor vearea(1K/2K/4K) ilesizedesteği sunuyor;image-01,modelparametresi aracılığıyla kullanılmaya devam ediyor
📈 Geliştirilmiş Araçlar
text_to_image- Varsayılan olarak MiniMax-H3-Image kullanır (/v1/images/generations); önceki modeli kullanmak içinmodel="image-01"iletin
2 Temmuz 2025
🆕 Yenilikler
- Ses Tasarımı: Yeni
voice_designaracı - açıklayıcı istemlerden önizleme sesiyle özel sesler oluşturun - Video Geliştirme: Üstün netlikte kalite ve süre/çözünürlük kontrolleri sunan
MiniMax-Hailuo-02modeli eklendi
📈 Geliştirilmiş Araçlar
voice_design- Metin açıklamalarından kişiselleştirilmiş sesler oluştururgenerate_video- Artık 6s/10s süre ve 768P/1080P çözünürlük seçenekleriyle MiniMax-Hailuo-02'yi destekliyor
SSS
1. geçersiz API anahtarı
Lütfen API anahtarınızın ve API ana bilgisayarınızın bölge bakımından eşleştiğinden emin olun
| Bölge | Global | Mainland |
|---|---|---|
| MINIMAX_API_KEY | MiniMax Global üzerinden alın | MiniMax üzerinden alın |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
2. spawn uvx ENOENT
Terminalinizde şu komutu çalıştırarak mutlak yolu doğrulayın:
which uvx
Mutlak yolu öğrendikten sonra (ör. /usr/local/bin/uvx), yapılandırmanızı bu yolu kullanacak şekilde güncelleyin (ör. "command": "/usr/local/bin/uvx").
3. Async modunda generate_video nasıl kullanılır?
Başlamadan önce tamamlanma kurallarını tanımlayın:
Alternatif olarak bu kurallar IDE ayarlarınızda (ör. Cursor) yapılandırılabilir:

Kullanım örnekleri
⚠️ Uyarı: Bu araçların kullanımı ücret doğurabilir.
1. akşam haberlerinin bir bölümünü seslendirme
2. bir sesi klonlama
3. video oluşturma
4. görüntü oluşturma
