Conecta tu agente de IA a WhatsApp: MCP en la práctica (Claude, Cursor y n8n)

El trabajo de conectar una IA a WhatsApp siempre fue el mismo: escribir la integración. Definir las funciones, describirle cada parámetro al modelo, tratar la respuesta, mantener eso vivo cuando la API cambia. Media semana de trabajo antes de que salga el primer mensaje.

El MCP corta esa etapa. WAME publica un servidor Model Context Protocol en https://mcp.wame.api.br, y tu agente descubre solo lo que puede hacer.

Qué cambia en la práctica

Sin MCP, escribes algo así para cada capacidad que el agente necesita:

const tools = [{
  name: 'enviar_whatsapp',
  description: 'Envía un mensaje de texto por WhatsApp',
  parameters: {
    type: 'object',
    properties: {
      to: { type: 'string', description: 'Número con código de país' },
      text: { type: 'string' },
    },
    required: ['to', 'text'],
  },
}];
// ...y el handler que realmente llama a la API, y el manejo de errores,
// y lo mismo otra vez para leer conversaciones, enviar archivos, crear grupos…

Con MCP no escribes nada de eso. El servidor ya declara las herramientas, y el agente las lee al conectarse.

Conectar

En Claude Code, un comando:

claude mcp add --transport http wame https://mcp.wame.api.br

En Cursor, Claude Desktop o cualquier cliente con interfaz de MCP, el camino es el mismo: agregar un servidor HTTP y pegar https://mcp.wame.api.br. El cliente pide la autorización de tu instancia y listo.

Después de eso, conversas:

"Fíjate si alguien del equipo comercial quedó sin respuesta hoy y muéstramelo."

Y el agente llama a find_pending_replies y list_chats por su cuenta. Tú no elegiste la herramienta — la eligió él.

Las 21 herramientas

Cubren el ciclo entero de una conversación, no solo el envío:

Conversar

Leer y entender

Operar

Grupos

list_groups, get_group, create_group, update_group, manage_group_participants, leave_group — crear grupo, entrar, salir, agregar y quitar participantes.

Tres canales, el mismo agente

send_message acepta channel. Eso no es un detalle de API: es consecuencia de que WAME entrega WhatsApp, Instagram Direct y Messenger en la misma instancia, con un único formato de webhook.

El agente que responde en WhatsApp responde en el Direct de Instagram sin una línea más. Si ya leíste sobre los tres canales en la misma API, es la misma instancia — ahora accesible por IA.

Dónde sirve de verdad

Triaje de la bandeja de entrada. "¿Qué conversaciones de ayer quedaron sin respuesta y de qué se trata cada una?" El agente lee, resume y devuelve una lista. Nadie abre 40 conversaciones a mano.

Operación asistida. "Mándale el comprobante en PDF al cliente que preguntó por la factura." Encuentra el contacto, ubica el mensaje y envía el archivo.

Apoyo a quien desarrolla. Dentro de Cursor o Claude Code, con el MCP conectado, puedes probar el comportamiento real de la API mientras escribes el código que va a usarla. El agente manda el mensaje de prueba, lee lo que llegó y comparas con lo que tu handler esperaba.

Automatización en flujo. En n8n, el mismo servidor MCP entra como herramienta de un nodo de agente — útil cuando el flujo ya existe y solo quieres darle capacidad de conversar.

Lo que el MCP no es

No reemplaza a la API. Si tu sistema tiene que mandar una confirmación de pedido cuando cambia el estado en la base, eso es una llamada de tu API, no un agente decidiendo. El código determinista sigue siendo la respuesta correcta para un flujo determinista.

No es un bot listo. El MCP le da capacidad al agente; la conversación, el tono y las reglas siguen siendo tu definición. Si lo que quieres es un bot atendiendo clientes, el camino es un chatbot con la API de OpenAI.

No da acceso a lo que no autorizaste. El alcance es la instancia conectada. Y send_template, la única herramienta capaz de alcanzar a mucha gente de una vez, pide confirm antes de disparar — a propósito.

Cómo empezar

1. Crea una instancia — la no oficial conecta por código QR en segundos y sirve perfectamente para probar.
2. Conecta el MCP con el comando de arriba.
3. Pídele algo simple al agente: "¿cuál es el estado de mi instancia?". Si responde, está todo en su lugar.
4. Recién entonces apunta a la instancia de producción.

Conclusión

Integrar IA a WhatsApp dejó de ser un proyecto y pasó a ser una línea de configuración. La ganancia real no es ahorrarse las horas de la integración — es que, cuando la API gana una capacidad nueva, el agente la ve sin que reescribas nada.