No install? Use cloud.anythingmcp.com directly.
Sign in, install the WhatsApp Business Cloud API in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → WhatsApp Business, pega el token permanente del System User + el ID de la cuenta de WhatsApp Business, genera una MCP API key — listo. Sin Docker, sin
git clone, sin servidor local que ejecutar. Puedes saltarte los pasos de instalación local y pasar directamente a la sección de configuración del cliente.
WhatsApp Business en el Model Context Protocol
La WhatsApp Business Cloud API es la pasarela alojada oficialmente por Meta para enviar mensajes de WhatsApp por programación — texto, plantillas pre-aprobadas, multimedia, marcadores de ubicación, flujos con botones interactivos y gestión del perfil de empresa. AnythingMCP la expone como servidor MCP para que cualquier agente — Claude, ChatGPT, Copilot, el tuyo propio — la pilote en lenguaje natural.
El adapter de WhatsApp viene integrado. No hay SDK que mantener ni código cliente que escribir: el motor gestiona la autenticación Bearer y produce peticiones que coinciden exactamente con el esquema messaging_product=whatsapp de Meta para cada tipo de mensaje.
Por qué WhatsApp resulta incómodo sin AnythingMCP
| Paso | Lo que exige la WhatsApp Cloud API |
|---|---|
| 1 | Generar un token permanente de System User en Meta Business Suite (≠ del token dev temporal de 24 h) con los permisos whatsapp_business_messaging + whatsapp_business_management |
| 2 | Descubrir el phoneNumberId de cada número emisor dentro de tu WhatsApp Business Account (WABA) |
| 3 | Construir el cuerpo JSON correcto por tipo de mensaje — text/template/image/audio/video/document/location/interactive — cada uno con su esquema y peculiaridades de colocación de campos |
| 4 | Mantenerse en una versión de Graph API aún soportada (v15 ya no existe, v20 caduca en septiembre de 2026; el adapter usa v22.0) |
| 5 | Respetar la ventana de servicio al cliente de 24 horas — fuera de ella solo se pueden enviar plantillas pre-aprobadas |
Eso es todo el perfil de autenticación BEARER_TOKEN + 14 herramientas de message-shape, declarado una vez como JSON en la especificación del adapter. Nada de código cliente que mantener.
Instalación
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
Abre http://localhost:3000/connectors/store, elige WhatsApp Business e introduce:
| Campo | Valor |
|---|---|
WHATSAPP_ACCESS_TOKEN | el token permanente del System User |
WHATSAPP_BUSINESS_ACCOUNT_ID | tu WABA ID (p. ej. 123456789012345) |
Genera una MCP API key en Profile → MCP API Keys y apunta tu agente a http://localhost:4000/mcp.
Herramientas disponibles (14)
| Herramienta | Qué hace |
|---|---|
whatsapp_list_phone_numbers | Descubre el phoneNumberId de cada número de tu WABA |
whatsapp_list_message_templates | Lista las plantillas aprobadas con sus componentes |
whatsapp_get_message_template | Recupera una plantilla por ID |
whatsapp_send_text_message | Envía texto libre (solo dentro de la ventana de 24 h) |
whatsapp_send_template_message | Envía una plantilla pre-aprobada (siempre permitido) |
whatsapp_send_image | Envía JPG/PNG por URL pública o media ID |
whatsapp_send_audio | Envía un audio — OGG-Opus se renderiza como auténtica nota de voz |
whatsapp_send_video | Envía un vídeo MP4/3GPP |
whatsapp_send_document | Envía PDF/DOC/XLS con nombre de archivo opcional |
whatsapp_send_location | Envía una ubicación |
whatsapp_send_interactive_buttons | Envía 1–3 botones de respuesta |
whatsapp_mark_message_as_read | Envía la confirmación de lectura (doble check azul) |
whatsapp_get_business_profile | Lee el perfil de empresa público |
whatsapp_update_business_profile | Actualiza about/dirección/email/sitios web |
La ventana de 24 horas, explicada
WhatsApp aplica una ventana de servicio al cliente: los mensajes de formato libre (texto, multimedia, interactivos, ubicación) solo se permiten en las 24 horas posteriores al último mensaje entrante del usuario hacia tu número. Fuera de esa ventana solo se permiten plantillas pre-aprobadas — las creas en Meta Business Suite, esperas la aprobación, y luego llamas a whatsapp_send_template_message con el nombre de plantilla y el código de idioma.
El adapter no rastrea la ventana por ti. Solo llama a la API; Meta devuelve el error 131047 "Re-engagement message" si intentas enviar texto libre fuera de la ventana. El campo instructions del adapter explica la regla para que tu agente sepa cuándo recurrir a una plantilla.
Multimedia — URL vs upload
WhatsApp acepta multimedia de dos formas: subir primero el binario a /PHONE_NUMBER_ID/media para obtener un media_id, o pasar un link HTTPS público. AnythingMCP recomienda la ruta link porque el motor REST no orquesta la danza multipart upload + send en una sola llamada de herramienta. Aloja el archivo en un CDN o en un bucket con URL firmada y pasa la URL a whatsapp_send_image / audio / video / document. El campo mediaId está disponible como vía de escape si pre-subes el archivo en otro lugar.
Mensajes entrantes — fuera de alcance
Este conector es solo outbound. WhatsApp entrega los mensajes entrantes mediante un webhook que tienes que alojar tú, y la arquitectura actual de AnythingMCP es request/response. Si necesitas un chatbot que responda a los mensajes de los usuarios, ejecuta un pequeño receptor de webhook junto a AnythingMCP y usa este conector para el lado outbound (más whatsapp_mark_message_as_read para las confirmaciones de lectura).