WhatsApp Business Tools MCP: cómo conectar WhatsApp Business a un agente de IA

El 15 de septiembre de 2026, Meta lanzó el servidor oficial WhatsApp Business Tools MCP. Conecta un agente de IA —Claude Code, Codex, ChatGPT o Cursor— con WhatsApp Business Platform. En lugar de alternar entre Developer Console, Business Manager y la documentación de la API, describes la tarea al agente, y este añade un número, crea una plantilla de mensaje, configura webhooks y envía un mensaje de prueba.

El servidor sigue en fase beta: el acceso se está habilitando gradualmente y el lanzamiento está pensado para desarrollo y pruebas, no para el envío de mensajes a gran escala en producción. A continuación se describen los preparativos y los pasos de conexión para cuatro clientes. Los comandos y ajustes se comprobaron con la documentación oficial de Meta el 18 de septiembre de 2026.

Encontrarás información sobre cómo trabajar con Ailoot en la documentación.

¿Qué es WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) es un estándar abierto para conectar sistemas externos con agentes de IA. Obtén más información en el artículo Servidores MCP para Claude Code: 7 integraciones listas para usar. Las conexiones verificadas con sus comandos de instalación están en el catálogo de MCP.

Antes de este lanzamiento, configurar una integración con WhatsApp era así: abrir Developer Console, crear una aplicación, vincular una empresa, añadir un número de teléfono, verificarlo con un código, generar un token, configurar un webhook, consultar la documentación de la API y, solo entonces, escribir la primera línea de código.

Meta describe así la idea detrás del servidor (traducción del inglés):

Meta ahora tiene dos servidores MCP, y es fácil confundirlos. Meta Social Technologies MCP es una herramienta de desarrollo de uso general: permite buscar en la documentación, encontrar endpoints de Graph API y diagnosticar errores de aplicaciones. WhatsApp Business Tools MCP sirve para trabajar con cuentas de WhatsApp, números de teléfono, plantillas, webhooks y mensajes de prueba. Se complementan, y puedes conectar ambos si lo necesitas.

Agente de inteligencia artificial WhatsApp: qué permite hacer Business Tools MCP#

Las herramientas del servidor se agrupan bajo el prefijo whatsapp_biz_. Según la documentación oficial:

• Resumen: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers: las empresas, cuentas y números de teléfono disponibles para ti.
• Configuración de números de teléfono: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Plantillas: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Mensajes: whatsapp_biz_send_message: texto libre dentro de la ventana de conversación de 24 horas o una plantilla aprobada fuera de ella; el agente confirma contigo quién es el destinatario antes de enviar.
• Webhooks: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Configuración de la cuenta: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token: un enlace para crear un token de usuario del sistema para realizar llamadas directas a Cloud API.

Cuando un cliente escribe primero a la empresa, se abre una ventana de atención al cliente: puedes responder con texto libre durante 24 horas. Cada nuevo mensaje del cliente amplía la ventana. Cuando se cierra, solo puedes contactar al cliente mediante una plantilla aprobada. El agente conoce esta regla y, si el destinatario está fuera de la ventana, sugerirá enviar una plantilla en lugar de un texto normal.

El servidor incorpora controles de acceso. Inicias sesión con tu cuenta de Meta y seleccionas empresas específicas; los tokens no se incluyen en el historial de conversaciones. Cada lectura se realiza en tu contexto, las llamadas quedan registradas y las acciones que modifican algo requieren una persona autenticada; la clave de aplicación del servidor por sí sola no basta.

¿Qué debes comprobar antes de conectarte?#

El servidor actúa en tu nombre y solo trabaja con tus recursos, así que antes de la primera llamada comprueba lo siguiente:

1. Tienes una empresa de Meta en la que eres administrador (el rol MANAGE).
2. Tienes una aplicación de Meta con el escenario WhatsApp Business Messaging habilitado (o el producto WhatsApp en aplicaciones antiguas), y eres administrador de esa aplicación en concreto; los permisos a nivel de empresa no bastan.
3. La empresa ha aceptado las condiciones de WhatsApp Business Cloud API; sin ello, se bloquean el registro de números de teléfono y el envío de mensajes.

Según Meta, a menudo surgen problemas con las condiciones de uso, los métodos de pago y la verificación de la empresa sin una explicación clara. El agente los comprueba de antemano y proporciona un enlace directo para aceptar las condiciones, indicar un método de pago o iniciar la verificación de la empresa.

Agente de inteligencia artificial para WhatsApp: conectar WhatsApp Business Tools MCP#

Si aún no has instalado Claude Code, empieza por la guía Cómo instalar Claude Code desde el sitio web oficial.

1. Añade el servidor

   En el terminal, ejecuta:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   El servidor es remoto, así que no hace falta instalarlo localmente.

2. Inicia sesión a través de Meta

   En una sesión de Claude Code, escribe /mcp y selecciona whatsapp_business_tools. Se abrirá una ventana del navegador para iniciar sesión en tu cuenta de Meta. Si no se abre el navegador, copia el enlace del cliente y ábrelo manualmente.

3. Concede permisos

   En la pantalla de consentimiento, selecciona las empresas y aplicaciones con WhatsApp a las que permites acceder. El servidor solicitará tres permisos: business_management (encontrar las empresas en las que eres administrador), whatsapp_business_management (cuentas, números de teléfono, plantillas y webhooks) y whatsapp_business_messaging (enviar mensajes desde tus números).

4. Comprueba la conexión

   Reinicia Claude Code, vuelve a iniciar sesión mediante /mcp y pregunta al agente qué herramientas puede ver en el servidor whatsapp_business_tools. A continuación, haz una lectura segura: «Enumera las empresas que puedo gestionar»; el agente llamará a whatsapp_biz_businesses. Si no aparecen herramientas o recibes un error de inicio de sesión, comprueba la dirección del servidor e inicia sesión de nuevo.

El inicio de sesión OAuth está vinculado al lanzamiento del cliente: después de reiniciar Claude Code, tienes que iniciar sesión otra vez. Puedes revocar el acceso en cualquier momento desde la configuración de facebook.com, en “Business Integrations”.

¿Cómo conectas Codex, ChatGPT y Claude Desktop?#

Codex App. Abre la configuración (el engranaje de la parte inferior izquierda), ve a MCP Servers y selecciona Add servers. Elige Streamable HTTP e introduce:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Haz clic en Authenticate e inicia sesión en el navegador.

ChatGPT. Settings, Plugins, Browse plugins y el icono “+” de la esquina superior derecha. Introduce un nombre, la misma URL y OAuth como tipo de autenticación.

Claude Desktop. Settings, Connectors, Add custom connector. Name: WhatsApp Business Tools; URL: la misma dirección del servidor.

Después de añadirlo a cualquier cliente, sigue la misma secuencia de comprobación: reinicia, vuelve a iniciar sesión, consulta la lista de herramientas y lee de forma segura la lista de empresas.

¿Qué ocurre en la primera sesión: de la lista de empresas al mensaje de prueba?#

Una primera sesión habitual con el servidor conectado:

1. «Enumera las empresas que gestiono»: el agente llama a whatsapp_biz_businesses y tú eliges la que necesitas.
2. «Muéstrame las cuentas de WhatsApp y los números de teléfono de esta empresa»: whatsapp_biz_accounts y whatsapp_biz_phone_numbers, con sus estados.
3. «Añade mi número de prueba a la cuenta»: whatsapp_biz_add_phone_number.
4. «Envía un código de verificación por SMS»: whatsapp_biz_send_verification_code. El código llega a tu teléfono.
5. «Verifica el número con el código 123456»: whatsapp_biz_verify_phone_number, y luego regístralo con whatsapp_biz_register_phone_number.
6. «Crea una plantilla order_update en el idioma preferido de los destinatarios para las notificaciones de pedidos»: whatsapp_biz_create_template; el agente proporcionará un enlace a su estado de aprobación.
7. «Envía un mensaje de prueba a mi número»: whatsapp_biz_send_message; el agente confirmará el destinatario antes de enviarlo.
8. «Configura un webhook en https://example.com/webhook»: whatsapp_biz_configure_webhooks y suscríbete mediante whatsapp_biz_subscribe_webhook.

Después, los mensajes entrantes de los clientes llegarán a la dirección indicada; por lo general, un CRM, un servicio de atención al cliente o un bot los recoge allí. Configuras el procesamiento por separado en esa dirección; el servidor solo se ocupa de la configuración.

¿Qué limitaciones tiene la versión beta?#

Hay cuatro limitaciones del servidor que conviene tener en cuenta.

Estado beta. Meta indica que la interfaz y el conjunto de herramientas pueden cambiar, y que el acceso se está habilitando gradualmente. Si todavía no puedes conectarte al servidor, puede que aún no esté disponible para ti.

Finalidad. El lanzamiento está pensado para desarrollo y pruebas; no está destinado al envío masivo en producción. Para enviar mensajes en producción, necesitarás una integración completa con Cloud API; por ejemplo, mediante un token de usuario del sistema, cuyo enlace proporciona la herramienta whatsapp_biz_system_user_token.

Límites. Cada herramienta tiene límites de solicitudes por usuario. Si superas el límite, la herramienta devuelve un error de límite; espera e inténtalo de nuevo.

Regla de la ventana de 24 horas. Fuera de la ventana de conversación con el cliente, solo puedes enviar plantillas aprobadas.

¿Por qué es importante para una empresa?#

Un caso habitual para una pequeña empresa: los clientes escriben por WhatsApp, y quieres responder rápidamente y enviar notificaciones sobre el estado de los pedidos. Antes, la configuración inicial implicaba trabajar por tu cuenta en varios paneles de Meta o contratar a un desarrollador. Ahora puedes completar esta parte en una conversación con un agente. Aun así, debes configurar por separado el procesamiento de los mensajes entrantes en tu propia dirección; esa es la siguiente tarea tras configurar el webhook.

El servidor también es útil si tu integración ya está en marcha. Las plantillas de mensajes necesitan actualizaciones periódicas: una promoción nueva, un texto de notificación nuevo. Desde el servidor, el agente crea o edita una plantilla y muestra su estado de aprobación sin enviarte al panel.

En la guía Cómo conectar NotebookLM a Claude Code mediante MCP se ilustra con documentación un enfoque similar: un agente se conecta a un sistema externo y trabaja con él según tus indicaciones.

¿Qué sigue?#

Han pasado tres días desde el anuncio del servidor. Puedes empezar con un solo comando e iniciar sesión a través de Meta; luego, puedes pedirle al agente una lista de tus empresas. Después, según lo que necesites: números de teléfono, plantillas, webhooks y mensajes de prueba.

Encontrarás otras formas de conectar un agente a sistemas externos en la colección de servidores MCP para Claude Code: hay otras siete integraciones funcionales para distintas tareas.

Conoce Ailoot.