WhatsApp Cloned Voice Messages

Integra WhatsApp e Minimax para enviar mensagens de voz personalizadas usando vozes clonadas.

GitHubExperimente este MCPPatrocinado

Documentação

Guia Completo: Configuração do MCP no Claude Desktop para Mensagens de Voz do WhatsApp com Vozes Clonadas

Visão Geral

Este guia abrangente documenta o processo completo de configuração do Claude Desktop com servidores MCP (Model Context Protocol) para integração com WhatsApp e Minimax. O objetivo é permitir o envio de mensagens de voz personalizadas usando vozes clonadas diretamente pelo WhatsApp a partir do Claude Desktop.

O Que Você Vai Alcançar

  • ✅ Configurar o Claude Desktop com o servidor MCP do WhatsApp
  • ✅ Integrar o servidor MCP da Minimax para geração de voz por IA
  • ✅ Clonar sua voz e usá-la para gerar mensagens
  • ✅ Enviar mensagens de áudio personalizadas diretamente para contatos do WhatsApp
  • ✅ Lidar com problemas comuns de configuração e solução de problemas

Pré-requisitos

  • Sistema macOS ou Linux
  • Claude Desktop instalado
  • Python 3.8+ instalado
  • Git instalado
  • Conta no WhatsApp
  • Conta na Minimax com acesso à API

Recursos Necessários

Passo 1: Instalar o Gerenciador de Pacotes uv

Primeiro, instale o gerenciador de pacotes uv que será usado para executar os servidores MCP:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Add to PATH (add to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

# Reload shell or run:
source ~/.bashrc  # or ~/.zshrc

Problema Comum: Se uv não for encontrado, certifique-se de que o PATH está configurado corretamente e reinicie o terminal.

Passo 2: Configurar o Servidor MCP do WhatsApp

2.1 Clonar e Configurar o Repositório

# Clone the repository
cd ~/
mkdir -p github_com_lharries_whatsapp-mcp
cd github_com_lharries_whatsapp-mcp
git clone https://github.com/lharries/whatsapp-mcp.git whatsapp-mcp-server
cd whatsapp-mcp-server

2.2 Instalar Dependências

# Install Python dependencies using uv
uv sync

Solução de Problemas: Se você encontrar problemas de dependência:

  • Certifique-se de que o Python 3.8+ está instalado
  • Tente: uv pip install -r requirements.txt
  • Verifique se todas as dependências do sistema estão atendidas

2.3 Configuração de Autenticação do WhatsApp

O servidor MCP do WhatsApp requer autenticação através do WhatsApp Web. Siga estes passos:

  1. Execute o servidor inicialmente para gerar o código QR:
uv run main.py
  1. Escaneie o código QR com o aplicativo móvel do WhatsApp
  2. Aguarde a autenticação bem-sucedida
  3. A sessão será salva para uso futuro

Problemas Comuns:

  • Código QR não aparecendo: Verifique as configurações do firewall e garanta o acesso à porta
  • Falha na autenticação: Tente limpar o cache do navegador e regenerar o código QR
  • Sessão expirada: Você pode precisar reautenticar periodicamente

Passo 3: Configurar o Servidor MCP da Minimax

3.1 Obter a Chave da API Minimax

  1. Cadastre-se na plataforma de IA Minimax
  2. Navegue até as configurações da API
  3. Gere sua chave de API
  4. Salve a chave com segurança (você precisará dela para a configuração)

3.2 Instalar o Servidor MCP da Minimax

# Install using uvx
uvx install minimax-mcp

Instalação alternativa se o uvx falhar:

# Clone repository method
git clone https://github.com/MiniMax-AI/MiniMax-MCP.git
cd MiniMax-MCP
uv sync

Passo 4: Configurar o Claude Desktop

4.1 Localizar a Configuração do Claude Desktop

Encontre o arquivo de configuração do Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json

4.2 Criar/Atualizar o Arquivo de Configuração

Crie ou atualize o arquivo de configuração com o seguinte conteúdo:

{
  "mcpServers": {
    "whatsapp": {
      "command": "/Users/[YOUR_USERNAME]/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/[YOUR_USERNAME]/github_com_lharries_whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    },
    "MiniMax": {
      "command": "/Users/[YOUR_USERNAME]/.local/bin/uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "YOUR_MINIMAX_API_KEY_HERE",
        "MINIMAX_MCP_BASE_PATH": "/tmp",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "local"
      }
    }
  }
}

Importante: Substitua [YOUR_USERNAME] pelo seu nome de usuário real e YOUR_MINIMAX_API_KEY_HERE pela sua chave real da API Minimax.

4.3 Solução de Problemas de Configuração

Problemas Comuns:

  1. Problemas de Caminho:

    • Certifique-se de que todos os caminhos usam caminhos absolutos
    • Verifique se uv e uvx estão instalados em ~/.local/bin/
    • Verifique se a estrutura de diretórios corresponde exatamente

  2. Erros de Sintaxe JSON:

    • Valide a sintaxe JSON usando validadores online
    • Certifique-se de que todas as aspas estão devidamente escapadas
    • Verifique se há vírgulas finais

  3. Variáveis de Ambiente:

    • Verifique se a chave da API está correta e ativa
    • Certifique-se de que o caminho base /tmp existe e é gravável
    • Verifique se a URL do host da API está acessível

Passo 5: Configuração de Clonagem de Voz (Opcional, mas Recomendado)

5.1 Preparar Amostra de Voz

  1. Grave uma amostra de áudio clara da sua voz (10-30 segundos)
  2. Use um microfone de boa qualidade
  3. Fale de forma clara e natural
  4. Salve no formato MP3 ou WAV

5.2 Clonar Sua Voz

Quando o Claude Desktop estiver em execução com os servidores MCP:

  1. Peça ao Claude para listar as vozes disponíveis:

    Can you list all available voices in Minimax?

  2. Clone sua voz:

    Can you clone my voice using this audio file? [upload your voice sample]
Use voice ID: my_custom_voice_[your_name]

  3. Teste a voz clonada:

    Generate a test audio message with my cloned voice saying "Hello, this is a test message"

Passo 6: Reiniciar o Claude Desktop

  1. Feche completamente o Claude Desktop
  2. Reinicie o aplicativo
  3. Aguarde a inicialização dos servidores MCP
  4. Verifique se ambos os servidores estão conectados (você deve ver indicadores MCP no Claude)

Passo 7: Testar a Integração

7.1 Testar a Conexão com o WhatsApp

Can you search for contacts in my WhatsApp?

7.2 Testar a Geração de Voz da Minimax

Can you generate an audio message saying "Hello, this is a test" using my cloned voice?

7.3 Enviar Mensagem de Voz de Teste

Can you send a voice message to [phone number] saying "Hello, this is a test message from Claude" using my cloned voice?

Exemplo Completo de Funcionamento

Aqui está o processo exato que seguimos e que resultou em sucesso:

Solicitação Inicial

User: "Can you send an audio message with my cloned voice to +34959217658 with the message 'Hemos llegado a los 140.000 seguidores en instagram. Que chimba!! Gracias a la divinidad'"

Execução Passo a Passo

  1. Descoberta de Voz:

    Claude listed available voices and found the cloned voice: moss_audio_17d8fcf2-4abf-11f0-b862-46ba4da2d9df

  2. Geração de Áudio:

    Parameters used:
- Text: "Hemos llegado a los 140.000 seguidores en instagram. Que chimba!! Gracias a la divinidad"
- Voice ID: moss_audio_17d8fcf2-4abf-11f0-b862-46ba4da2d9df
- Emotion: happy
- Language: Spanish

  3. Entrega no WhatsApp:

    Sent to: 34959217658 (without + prefix)
Format: Audio message
Result: Success

  4. Correção de Conteúdo:

    User requested change from "140.000 seguidores" to "140 mil seguidores"
Regenerated audio with corrected text
Sent updated message successfully

Problemas Comuns e Soluções

Problema 1: Servidores MCP Não Conectando

Sintomas: O Claude Desktop não mostra servidores MCP conectados

Soluções:

  1. Verifique a sintaxe do arquivo de configuração
  2. Verifique se todos os caminhos são absolutos e corretos
  3. Certifique-se de que uv e uvx estão devidamente instalados
  4. Reinicie completamente o Claude Desktop
  5. Verifique os logs do sistema para mensagens de erro

Problema 2: Falha na Autenticação do WhatsApp

Sintomas: Não é possível conectar ao WhatsApp, problemas com o código QR

Soluções:

  1. Limpe as sessões do WhatsApp Web no seu celular
  2. Garanta uma boa conexão com a internet
  3. Tente executar o servidor MCP do WhatsApp manualmente primeiro
  4. Verifique as configurações de firewall/antivírus

Problema 3: Erros na API Minimax

Sintomas: Falha na geração de voz, erros de API

Soluções:

  1. Verifique se a chave da API está correta e ativa
  2. Verifique o saldo de créditos da conta
  3. Certifique-se de que a URL do host da API está acessível
  4. Tente um caminho base diferente se houver problemas de permissão

Problema 4: Clonagem de Voz Não Funcionando

Sintomas: Não é possível encontrar a voz clonada, falha na geração

Soluções:

  1. Certifique-se de que a voz foi devidamente clonada na plataforma Minimax
  2. Verifique o formato do ID da voz
  3. Verifique a compatibilidade do formato do arquivo de áudio
  4. Tente listar as vozes para confirmar a disponibilidade

Problema 5: Falha na Entrega de Mensagem de Áudio

Sintomas: O áudio é gerado, mas o envio pelo WhatsApp falha

Soluções:

  1. Verifique o formato do número de telefone (sem prefixo +)
  2. Certifique-se de que a sessão do WhatsApp está ativa
  3. Verifique a compatibilidade do formato do arquivo de áudio
  4. Verifique as permissões e caminhos dos arquivos

Melhores Práticas

  1. Backups Regulares: Salve sua configuração do Claude Desktop
  2. Segurança da Chave da API: Nunca compartilhe sua chave da API Minimax
  3. Qualidade de Voz: Use áudio de alta qualidade para clonagem de voz
  4. Testes: Sempre teste primeiro com você mesmo antes de enviar para outras pessoas
  5. Atualizações: Mantenha os servidores MCP atualizados regularmente

Comandos de Solução de Problemas

Verificar instalação do uv:

which uv
uv --version

Verificar instalação do uvx:

which uvx
uvx --version

Testar o MCP do WhatsApp manualmente:

cd ~/github_com_lharries_whatsapp-mcp/whatsapp-mcp-server
uv run main.py

Testar o MCP da Minimax manualmente:

uvx minimax-mcp -y

Validar a configuração do Claude:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

Métricas de Sucesso

Você saberá que tudo está funcionando quando:

  • ✅ O Claude Desktop mostrar ambos os servidores MCP conectados
  • ✅ Você puder pesquisar contatos do WhatsApp
  • ✅ Você puder listar as vozes disponíveis, incluindo sua voz clonada
  • ✅ Você puder gerar áudio com sua voz
  • ✅ Você puder enviar mensagens de áudio para o WhatsApp com sucesso

Conclusão

Esta configuração permite poderosas capacidades de automação ao combinar a inteligência do Claude com o alcance do WhatsApp e a tecnologia de clonagem de voz da Minimax. A chave para o sucesso é atenção cuidadosa aos detalhes de configuração e solução sistemática de problemas que possam surgir.

A integração completa permite comandos em linguagem natural para o Claude que resultam em mensagens de voz personalizadas sendo enviadas diretamente para contatos do WhatsApp, abrindo possibilidades para atendimento ao cliente automatizado, assistentes pessoais e distribuição de conteúdo criativo.