MiniMax MCP

oficial

Interaja 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

export

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

Início rápido com cliente MCP

  1. Obtenha sua chave de API em MiniMax.
  2. Instale uv (gerenciador de pacotes Python), instale com curl -LsSf https://astral.sh/uv/install.sh | sh ou consulte o uv repositório para ver outros métodos de instalação.
  3. 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ãoGlobalChina continental
MINIMAX_API_KEYobtenha em MiniMax Globalobtenha em MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://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.

stdioSSE
Executado localmentePode ser implantado localmente ou na nuvem
Comunicação por meio de stdoutComunicação por meio de network
Entrada: oferece suporte ao processamento de recursos local files ou URL válidosEntrada: quando implantado na nuvem, recomenda-se usar URL como entrada

Ferramentas disponíveis

ferramentadescrição
text_to_audioConverte texto em áudio usando uma voz especificada
list_voicesLista todas as vozes disponíveis
voice_cloneClona uma voz usando arquivos de áudio fornecidos
generate_videoGera um vídeo a partir de um prompt
text_to_imageGera 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_editEdita uma imagem com MiniMax-H3-Image usando um prompt e de 1 a 16 imagens de referência
query_video_generationConsulta o resultado de uma tarefa de geração de vídeo
voice_designGera 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_image agora usa MiniMax-H3-Image por padrão e oferece suporte a area (1K/2K/4K) e size; image-01 continua disponível por meio do parâmetro model

📈 Ferramentas aprimoradas

  • text_to_image - Usa MiniMax-H3-Image por padrão (/v1/images/generations); passe model="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 texto
  • generate_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ãoGlobalChina continental
MINIMAX_API_KEYobtenha em MiniMax Globalobtenha em MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://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