MiniMax MCP
resmiBerinteraksi dengan API Text-to-Speech, gambar, dan video generasi yang kuat dari MiniMax.
Apa yang bisa Anda lakukan dengan MiniMax MCP?
- Teks ke ucapan — Minta asisten mengubah teks tertulis menjadi audio menggunakan suara yang ditentukan.
- Kloning suara — Kloning suara dari file audio yang Anda berikan, lalu gunakan kembali untuk menghasilkan ucapan.
- Desain suara — Hasilkan suara khusus dari prompt deskriptif dengan audio pratinjau.
- Pembuatan dan pengeditan gambar — Buat gambar dari prompt dengan area 1K/2K/4K, atau edit gambar menggunakan prompt dan hingga 16 gambar referensi.
- Pembuatan video — Hasilkan video dari prompt, dengan opsi durasi dan resolusi, lalu tanyakan hasil tugasnya setelah itu.
Dokumentasi

Server MiniMax Model Context Protocol (MCP) resmi yang memungkinkan interaksi dengan API Text to Speech dan pembuatan video/gambar yang canggih. Server ini memungkinkan klien MCP seperti Claude Desktop, Cursor, Windsurf, OpenAI Agents dan lainnya untuk menghasilkan ucapan, mengkloning suara, membuat video, membuat gambar, dan banyak lagi.
💡 Rekomendasi: MiniMax CLI (mmx-cli) — alat baris perintah resmi kami dengan model terbaru dan fitur tambahan, termasuk teks, visi, dan pencarian. Dapat digunakan sebagai skill agen AI untuk Claude Code, Cursor, OpenClaw, dll.
Dokumentasi
- Dokumentasi 中文
- MiniMax-MCP-JS - Implementasi JavaScript resmi MiniMax MCP
Mulai Cepat dengan Klien MCP
- Dapatkan kunci API Anda dari MiniMax.
- Instal
uv(pengelola paket Python), instal dengancurl -LsSf https://astral.sh/uv/install.sh | shatau lihatuvrepo untuk metode instalasi lainnya. - Penting: Host dan kunci API berbeda-beda menurut wilayah dan harus cocok; jika tidak, Anda akan mengalami kesalahan
Invalid API key.
| Wilayah | Global | Daratan Utama |
|---|---|---|
| MINIMAX_API_KEY | dapatkan dari MiniMax Global | dapatkan dari MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Claude Desktop
Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json untuk menyertakan konfigurasi berikut:
{
"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"
}
}
}
}
⚠️ Peringatan: Kunci API harus cocok dengan host. Jika terjadi kesalahan "API Error: invalid api key", periksa host API Anda:
- Host Global:
https://api.minimax.io - Host Daratan Utama:
https://api.minimaxi.com
Jika Anda menggunakan Windows, Anda harus mengaktifkan "Developer Mode" di Claude Desktop untuk menggunakan server MCP. Klik "Help" pada menu hamburger di kiri atas, lalu pilih "Enable Developer Mode".
Cursor
Buka Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server untuk menambahkan konfigurasi di atas.
Selesai. Kini klien MCP Anda dapat berinteraksi dengan MiniMax melalui alat-alat berikut:
Transportasi
Kami mendukung dua jenis transportasi: stdio dan sse.
| stdio | SSE |
|---|---|
| Jalankan secara lokal | Dapat diterapkan secara lokal atau di cloud |
Komunikasi melalui stdout | Komunikasi melalui network |
Input: Mendukung pemrosesan sumber daya local files atau URL yang valid | Input: Jika diterapkan di cloud, disarankan menggunakan URL sebagai input |
Alat yang Tersedia
| alat | deskripsi |
|---|---|
text_to_audio | Mengubah teks menjadi audio dengan suara yang ditentukan |
list_voices | Menampilkan daftar semua suara yang tersedia |
voice_clone | Mengkloning suara menggunakan berkas audio yang diberikan |
generate_video | Membuat video dari prompt |
text_to_image | Membuat gambar dari prompt. Secara default menggunakan MiniMax-H3-Image (mendukung area 1K/2K/4K dan size); image-01 tetap tersedia melalui model |
image_edit | Mengedit gambar dengan MiniMax-H3-Image menggunakan prompt dan 1-16 gambar referensi |
query_video_generation | Memeriksa hasil tugas pembuatan video |
voice_design | Membuat suara dari prompt menggunakan teks pratinjau |
Catatan Rilis
10 November 2026
🆕 Yang Baru
- Edit Gambar: Alat
image_editbaru — edit gambar dengan MiniMax-H3-Image menggunakan prompt dan 1-16 gambar referensi (URL, URI data,mm_file://, atau jalur lokal) - Pembuatan Gambar H3:
text_to_imagekini secara default menggunakan MiniMax-H3-Image dan mendukungarea(1K/2K/4K) sertasize;image-01tetap tersedia melalui parametermodel
📈 Alat yang Disempurnakan
text_to_image- Secara default menggunakan MiniMax-H3-Image (/v1/images/generations); berikanmodel="image-01"untuk menggunakan model sebelumnya
2 Juli 2025
🆕 Yang Baru
- Desain Suara: Alat
voice_designbaru - buat suara khusus dari prompt deskriptif dengan audio pratinjau - Peningkatan Video: Menambahkan model
MiniMax-Hailuo-02dengan kualitas sangat jernih serta kontrol durasi/resolusi
📈 Alat yang Disempurnakan
voice_design- Membuat suara yang dipersonalisasi dari deskripsi teksgenerate_video- Kini mendukung MiniMax-Hailuo-02 dengan opsi durasi 6 dtk/10 dtk dan resolusi 768P/1080P
FAQ
1. kunci API tidak valid
Pastikan kunci API dan host API Anda sesuai dengan wilayah
| Wilayah | Global | Daratan Utama |
|---|---|---|
| MINIMAX_API_KEY | dapatkan dari MiniMax Global | dapatkan dari MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
2. spawn uvx ENOENT
Pastikan jalur absolutnya dengan menjalankan perintah ini di terminal:
which uvx
Setelah mendapatkan jalur absolut (misalnya, /usr/local/bin/uvx), perbarui konfigurasi agar menggunakan jalur tersebut (misalnya, "command": "/usr/local/bin/uvx").
3. Cara menggunakan generate_video dalam mode async
Tentukan aturan penyelesaian sebelum memulai:
Atau, aturan ini dapat dikonfigurasi di pengaturan IDE Anda (misalnya, Cursor):

Contoh penggunaan
⚠️ Peringatan: Penggunaan alat-alat ini dapat menimbulkan biaya.
1. membacakan segmen berita malam
2. mengkloning suara
3. membuat video
4. membuat gambar
