MiniMax MCP
oficialInteraja com as poderosas APIs de Texto-para-Fala, geração de imagem e vídeo da MiniMax.
O que você pode fazer com MiniMax MCP?
- Texto para fala — Peça ao assistente para converter texto escrito em áudio usando uma voz especificada.
- Clonagem de voz — Clone uma voz a partir de arquivos de áudio fornecidos por você e reutilize-a para gerar fala.
- Design de voz — Gere uma voz personalizada a partir de uma descrição, com áudio de prévia.
- Geração e edição de imagens — Crie imagens a partir de prompts em áreas de 1K/2K/4K ou edite uma imagem usando um prompt e até 16 imagens de referência.
- Geração de vídeo — Gere um vídeo a partir de um prompt, com opções de duração e resolução, e consulte o resultado da tarefa depois.
Documentação

Servidor oficial MiniMax Model Context Protocol (MCP) que permite interagir com poderosas APIs de conversão de texto em fala e geração de vídeo/imagens. Este servidor permite que clientes MCP como Claude Desktop, Cursor, Windsurf, OpenAI Agents e outros gerem fala, clonem vozes, gerem vídeos, gerem imagens e muito mais.
💡 Recomendado: MiniMax CLI (mmx-cli) — nossa ferramenta oficial de linha de comando, com os modelos mais recentes e recursos adicionais, incluindo texto, visão e busca. Funciona como uma habilidade de agente de IA para Claude Code, Cursor, OpenClaw etc.
Documentação
- Documentação em chinês
- MiniMax-MCP-JS - Implementação oficial do MiniMax MCP em JavaScript
Início rápido com cliente MCP
- Obtenha sua chave de API em MiniMax.
- Instale
uv(gerenciador de pacotes Python), instale comcurl -LsSf https://astral.sh/uv/install.sh | shou consulte ouvrepositório para ver outros métodos de instalação. - Importante: O host e a chave da API variam conforme a região e devem corresponder; caso contrário, você encontrará um erro
Invalid API key.
| Região | Global | China continental |
|---|---|---|
| MINIMAX_API_KEY | obtenha em MiniMax Global | obtenha em MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
Claude Desktop
Acesse Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir o seguinte:
{
"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"
}
}
}
}
⚠️ Aviso: A chave da API precisa corresponder ao host. Se ocorrer o erro "API Error: invalid api key", verifique seu host da API:
- Host global:
https://api.minimax.io - Host da China continental:
https://api.minimaxi.com
Se estiver usando Windows, será necessário ativar o "Developer Mode" no Claude Desktop para usar o servidor MCP. Clique em "Help" no menu hambúrguer, no canto superior esquerdo, e selecione "Enable Developer Mode".
Cursor
Acesse Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server para adicionar a configuração acima.
Pronto. Seu cliente MCP já pode interagir com o MiniMax usando estas ferramentas:
Transporte
Oferecemos suporte a dois tipos de transporte: stdio e sse.
| stdio | SSE |
|---|---|
| Executado localmente | Pode ser implantado localmente ou na nuvem |
Comunicação por meio de stdout | Comunicação por meio de network |
Entrada: oferece suporte ao processamento de recursos local files ou URL válidos | Entrada: quando implantado na nuvem, recomenda-se usar URL como entrada |
Ferramentas disponíveis
| ferramenta | descrição |
|---|---|
text_to_audio | Converte texto em áudio usando uma voz especificada |
list_voices | Lista todas as vozes disponíveis |
voice_clone | Clona uma voz usando arquivos de áudio fornecidos |
generate_video | Gera um vídeo a partir de um prompt |
text_to_image | Gera uma imagem a partir de um prompt. Usa MiniMax-H3-Image por padrão (compatível com area 1K/2K/4K e size); image-01 continua disponível por meio de model |
image_edit | Edita uma imagem com MiniMax-H3-Image usando um prompt e de 1 a 16 imagens de referência |
query_video_generation | Consulta o resultado de uma tarefa de geração de vídeo |
voice_design | Gera uma voz a partir de um prompt usando texto de prévia |
Notas de versão
10 de novembro de 2026
🆕 Novidades
- Edição de imagem: nova ferramenta
image_edit— edite imagens com MiniMax-H3-Image usando um prompt e de 1 a 16 imagens de referência (URL, URI de dados,mm_file://ou caminho local) - Geração de imagens H3:
text_to_imageagora usa MiniMax-H3-Image por padrão e oferece suporte aarea(1K/2K/4K) esize;image-01continua disponível por meio do parâmetromodel
📈 Ferramentas aprimoradas
text_to_image- Usa MiniMax-H3-Image por padrão (/v1/images/generations); passemodel="image-01"para usar o modelo anterior
2 de julho de 2025
🆕 Novidades
- Design de voz: nova ferramenta
voice_design- crie vozes personalizadas a partir de prompts descritivos com áudio de prévia - Aprimoramento de vídeo: adicionado o modelo
MiniMax-Hailuo-02, com qualidade ultra nítida e controles de duração/resolução
📈 Ferramentas aprimoradas
voice_design- Gera vozes personalizadas a partir de descrições em textogenerate_video- Agora oferece suporte ao MiniMax-Hailuo-02 com opções de duração de 6s/10s e resolução de 768P/1080P
Perguntas frequentes
1. Chave de API inválida
Verifique se sua chave e seu host da API correspondem à região
| Região | Global | China continental |
|---|---|---|
| MINIMAX_API_KEY | obtenha em MiniMax Global | obtenha em MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
2. spawn uvx ENOENT
Confirme o caminho absoluto executando este comando no terminal:
which uvx
Depois de obter o caminho absoluto (por exemplo, /usr/local/bin/uvx), atualize sua configuração para usar esse caminho (por exemplo, "command": "/usr/local/bin/uvx").
3. Como usar generate_video no modo assíncrono
Defina as regras de conclusão antes de começar:
Como alternativa, essas regras podem ser configuradas nas definições do seu IDE (por exemplo, Cursor):

Exemplos de uso
⚠️ Aviso: o uso dessas ferramentas pode gerar custos.
1. transmitir um trecho do noticiário da noite
2. clonar uma voz
3. gerar um vídeo
4. gerar imagens
