WhatsApp Cloned Voice Messages

Integra WhatsApp y Minimax para enviar mensajes de voz personalizados usando voces clonadas.

GitHubPrueba este MCPPatrocinado

Documentación

Guía Completa: Configuración de MCP en Claude Desktop para Mensajes de Voz de WhatsApp con Voces Clonadas

Resumen

Esta guía completa documenta el proceso completo de configuración de Claude Desktop con servidores MCP (Model Context Protocol) para la integración de WhatsApp y Minimax. El objetivo es permitir el envío de mensajes de voz personalizados utilizando voces clonadas directamente a través de WhatsApp desde Claude Desktop.

Lo Que Lograrás

  • ✅ Configurar Claude Desktop con el servidor MCP de WhatsApp
  • ✅ Integrar el servidor MCP de Minimax para la generación de voz con IA
  • ✅ Clonar tu voz y usarla para la generación de mensajes
  • ✅ Enviar mensajes de audio personalizados directamente a contactos de WhatsApp
  • ✅ Manejar problemas comunes de configuración y solución de problemas

Requisitos Previos

  • Sistema macOS o Linux
  • Claude Desktop instalado
  • Python 3.8+ instalado
  • Git instalado
  • Cuenta de WhatsApp
  • Cuenta de Minimax con acceso a API

Recursos Necesarios

Paso 1: Instalar el Administrador de Paquetes uv

Primero, instala el administrador de paquetes uv que se utilizará para ejecutar los 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 Común: Si uv no se encuentra, asegúrate de que la variable PATH esté configurada correctamente y reinicia tu terminal.

Paso 2: Configurar el Servidor MCP de WhatsApp

2.1 Clonar y Configurar el Repositorio

# 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 Dependencias

# Install Python dependencies using uv
uv sync

Solución de Problemas: Si encuentras problemas de dependencias:

  • Asegúrate de que Python 3.8+ esté instalado
  • Intenta: uv pip install -r requirements.txt
  • Verifica que todas las dependencias del sistema estén satisfechas

2.3 Configuración de Autenticación de WhatsApp

El servidor MCP de WhatsApp requiere autenticación a través de WhatsApp Web. Sigue estos pasos:

  1. Ejecuta el servidor inicialmente para generar el código QR:
uv run main.py
  1. Escanea el código QR con tu aplicación móvil de WhatsApp
  2. Espera la autenticación exitosa
  3. La sesión se guardará para uso futuro

Problemas Comunes:

  • El código QR no aparece: Verifica la configuración del firewall y asegura el acceso al puerto
  • La autenticación falla: Intenta limpiar la caché del navegador y regenerar el código QR
  • La sesión expira: Es posible que debas reautenticarte periódicamente

Paso 3: Configurar el Servidor MCP de Minimax

3.1 Obtener la Clave API de Minimax

  1. Regístrate en la plataforma de IA de Minimax
  2. Navega a la configuración de API
  3. Genera tu clave API
  4. Guarda la clave de forma segura (la necesitarás para la configuración)

3.2 Instalar el Servidor MCP de Minimax

# Install using uvx
uvx install minimax-mcp

Instalación alternativa si uvx falla:

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

Paso 4: Configurar Claude Desktop

4.1 Ubicar la Configuración de Claude Desktop

Encuentra tu archivo de configuración de Claude Desktop:

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

4.2 Crear/Actualizar el Archivo de Configuración

Crea o actualiza el archivo de configuración con el siguiente contenido:

{
  "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: Reemplaza [YOUR_USERNAME] con tu nombre de usuario real y YOUR_MINIMAX_API_KEY_HERE con tu clave API real de Minimax.

4.3 Solución de Problemas de Configuración

Problemas Comunes:

  1. Problemas de Ruta:

    • Asegúrate de que todas las rutas usen rutas absolutas
    • Verifica que uv y uvx estén instalados en ~/.local/bin/
    • Comprueba que la estructura de directorios coincida exactamente

  2. Errores de Sintaxis JSON:

    • Valida la sintaxis JSON usando validadores en línea
    • Asegúrate de que todas las comillas estén correctamente escapadas
    • Verifica que no haya comas finales

  3. Variables de Entorno:

    • Verifica que la clave API sea correcta y esté activa
    • Asegúrate de que la ruta base /tmp exista y sea escribible
    • Comprueba que la URL del host de la API sea accesible

Paso 5: Configuración de Clonación de Voz (Opcional pero Recomendado)

5.1 Preparar la Muestra de Voz

  1. Graba una muestra de audio clara de tu voz (10-30 segundos)
  2. Usa un micrófono de buena calidad
  3. Habla de forma clara y natural
  4. Guarda en formato MP3 o WAV

5.2 Clonar Tu Voz

Una vez que Claude Desktop esté ejecutándose con los servidores MCP:

  1. Pide a Claude que liste las voces disponibles:

    Can you list all available voices in Minimax?

  2. Clona tu voz:

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

  3. Prueba la voz clonada:

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

Paso 6: Reiniciar Claude Desktop

  1. Cierra completamente Claude Desktop
  2. Reinicia la aplicación
  3. Espera a que los servidores MCP se inicialicen
  4. Verifica que ambos servidores estén conectados (deberías ver indicadores MCP en Claude)

Paso 7: Probar la Integración

7.1 Probar la Conexión de WhatsApp

Can you search for contacts in my WhatsApp?

7.2 Probar la Generación de Voz de Minimax

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

7.3 Enviar un Mensaje de Voz de Prueba

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

Ejemplo Completo de Funcionamiento

Este es el proceso exacto que seguimos y que resultó exitoso:

Solicitud 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'"

Ejecución Paso a Paso

  1. Descubrimiento de Voz:

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

  2. Generación de Audio:

    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 por WhatsApp:

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

  4. Corrección de Contenido:

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

Problemas Comunes y Soluciones

Problema 1: Los Servidores MCP No Se Conectan

Síntomas: Claude Desktop no muestra servidores MCP conectados

Soluciones:

  1. Verifica la sintaxis del archivo de configuración
  2. Confirma que todas las rutas sean absolutas y correctas
  3. Asegúrate de que uv y uvx estén correctamente instalados
  4. Reinicia Claude Desktop por completo
  5. Revisa los registros del sistema para ver mensajes de error

Problema 2: La Autenticación de WhatsApp Falla

Síntomas: No se puede conectar a WhatsApp, problemas con el código QR

Soluciones:

  1. Limpia las sesiones de WhatsApp Web en tu teléfono
  2. Asegura una buena conexión a internet
  3. Intenta ejecutar el servidor MCP de WhatsApp manualmente primero
  4. Verifica la configuración del firewall/antivirus

Problema 3: Errores de API de Minimax

Síntomas: La generación de voz falla, errores de API

Soluciones:

  1. Verifica que la clave API sea correcta y esté activa
  2. Comprueba el saldo de créditos de tu cuenta
  3. Asegúrate de que la URL del host de la API sea accesible
  4. Prueba con una ruta base diferente si hay problemas de permisos

Problema 4: La Clonación de Voz No Funciona

Síntomas: No se puede encontrar la voz clonada, la generación falla

Soluciones:

  1. Asegúrate de que la voz se haya clonado correctamente en la plataforma de Minimax
  2. Verifica el formato del ID de voz
  3. Confirma la compatibilidad del formato del archivo de audio
  4. Intenta listar las voces para confirmar la disponibilidad

Problema 5: Fallo en la Entrega del Mensaje de Audio

Síntomas: El audio se genera pero el envío por WhatsApp falla

Soluciones:

  1. Verifica el formato del número de teléfono (sin prefijo +)
  2. Asegúrate de que la sesión de WhatsApp esté activa
  3. Confirma la compatibilidad del formato del archivo de audio
  4. Verifica los permisos y rutas de los archivos

Mejores Prácticas

  1. Copias de Seguridad Regulares: Guarda tu configuración de Claude Desktop
  2. Seguridad de la Clave API: Nunca compartas tu clave API de Minimax
  3. Calidad de Voz: Usa audio de alta calidad para la clonación de voz
  4. Pruebas: Siempre prueba contigo mismo primero antes de enviar a otros
  5. Actualizaciones: Mantén los servidores MCP actualizados regularmente

Comandos de Solución de Problemas

Verificar la instalación de uv:

which uv
uv --version

Verificar la instalación de uvx:

which uvx
uvx --version

Probar MCP de WhatsApp manualmente:

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

Probar MCP de Minimax manualmente:

uvx minimax-mcp -y

Validar la configuración de Claude:

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

Métricas de Éxito

Sabrás que todo funciona cuando:

  • ✅ Claude Desktop muestre ambos servidores MCP conectados
  • ✅ Puedas buscar contactos de WhatsApp
  • ✅ Puedas listar las voces disponibles incluyendo tu voz clonada
  • ✅ Puedas generar audio con tu voz
  • ✅ Puedas enviar mensajes de audio a WhatsApp correctamente

Conclusión

Esta configuración permite potentes capacidades de automatización al combinar la inteligencia de Claude con el alcance de WhatsApp y la tecnología de clonación de voz de Minimax. La clave del éxito es prestar atención cuidadosa a los detalles de configuración y solucionar sistemáticamente cualquier problema que surja.

La integración completa permite comandos en lenguaje natural a Claude que resultan en mensajes de voz personalizados enviados directamente a contactos de WhatsApp, abriendo posibilidades para servicio al cliente automatizado, asistentes personales y distribución de contenido creativo.