WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

Para desarrolladores que crean sobre la Plataforma de WhatsApp Business (Cloud API) — el servidor MCP de WhatsApp Business Tools permite que tu agente de IA y asistente de IDE administren y depuren tu integración de WhatsApp Business desde un solo lugar. Permite que un agente descubra las empresas y cuentas de WhatsApp que administras, incorpore y registre números de teléfono, cree y administre plantillas de mensajes, configure webhooks y envíe mensajes — actuando como tú, en las aplicaciones y empresas que administras.

Nota: El servidor MCP de WhatsApp Business Tools se está implementando gradualmente y puede que aún no esté disponible para todos. La interfaz y el conjunto de herramientas están en versión beta y pueden cambiar.

Descripción general

La siguiente tabla resume los detalles del servidor:

Atributo	Valor
Nombre del servidor	WhatsApp Business Tools
Transporte	HTTP transmisible
Endpoint	https://mcp.facebook.com/whatsapp_business_tools
Autenticación	Inicio de sesión con cuenta de desarrollador de Meta (OAuth)
Estado	Beta: la interfaz y el conjunto de herramientas pueden cambiar

Requisitos previos

El servidor actúa sobre tus propios activos, por lo que antes de que un agente pueda usar la mayoría de las herramientas necesitas:

• Acceso de administrador a una empresa que quieras administrar (el rol MANAGE).
• Una aplicación habilitada para WhatsApp de la que seas administrador, conectada a esa empresa: una aplicación con el caso de uso de Mensajería de WhatsApp Business (o el producto de WhatsApp en una aplicación más antigua). Debes tener acceso de administrador en la aplicación, no solo en la empresa.
• Términos de servicio de la API de WhatsApp Business Cloud aceptados para esa empresa. El envío de mensajes y el registro de números de teléfono están bloqueados hasta que un administrador los acepte.

Si falta algún requisito previo, la herramienta devuelve un error procesable que te indica qué corregir y un enlace a la página donde puedes corregirlo.

Configura tu IDE o cliente de agente

El servidor MCP de WhatsApp Business Tools es un servidor remoto. Los clientes que admiten servidores MCP remotos pueden conectarse al endpoint directamente. Para clientes que solo admiten servidores locales (stdio), usa el puente mcp-remote, que actúa como proxy del servidor remoto a través de stdio.

Configura tu cliente usando una de las secciones a continuación y luego completa el inicio de sesión OAuth para autenticarte.

Claude Code y Desktop

Claude Code — ejecuta el siguiente comando para agregar el servidor:

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

Luego ejecuta /mcp en una sesión y selecciona whatsapp_business_tools para autenticarte.

Claude Desktop — abre Configuración > Conectores > Agregar conector personalizado y luego establece:

• Nombre: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

Aplicación OpenAI Codex y ChatGPT

Aplicación Codex — abre Configuración (el ícono de engranaje, abajo a la izquierda) > Servidores MCP > Agregar servidores, elige HTTP transmisible y luego establece:

• Nombre: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autenticación: OAuth

Haz clic en Autenticar y completa el inicio de sesión OAuth.

ChatGPT — abre Configuración > Complementos > Explorar complementos, haz clic en + en la esquina superior derecha para agregar un nuevo complemento y luego establece:

• Nombre: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autenticación: OAuth

Guarda el complemento y completa el inicio de sesión OAuth.

Inicio de sesión OAuth

El servidor MCP de WhatsApp Business Tools se autentica con tu cuenta de desarrollador de Meta a través de OAuth, por lo que el mismo flujo de inicio de sesión funciona con todos los clientes.

Flujo de inicio de sesión

Después de agregar el servidor a tu cliente (consulta Configura tu IDE o cliente de agente):

1. Inicia la conexión. Muchos clientes comienzan el flujo OAuth automáticamente cuando se agrega el servidor. Otros requieren que hagas clic en Conectar o Autenticar primero.
2. Inicia sesión. Tu navegador se abre para iniciar sesión con tu cuenta de Meta. Si no se abre automáticamente, copia el enlace que tu cliente imprime y ábrelo manualmente.
3. Otorga acceso. En la pantalla de consentimiento, selecciona las empresas y aplicaciones habilitadas para WhatsApp a las que quieres que el servidor acceda.
4. Confirma. Regresa a tu cliente y verifica tu conexión.

Deberás completar el flujo de inicio de sesión nuevamente cuando reinicies el cliente.

Ámbitos

El servidor solicita los siguientes permisos durante el consentimiento:

Ámbito	Acceso
business_management	Descubre y actúa sobre las empresas que administras y que seleccionaste durante el consentimiento.
whatsapp_business_management	Administra cuentas de WhatsApp Business, números de teléfono, plantillas de mensajes y webhooks.
whatsapp_business_messaging	Envía mensajes desde tus números de teléfono registrados.

Puedes revisar o revocar el acceso en cualquier momento en facebook.com > Configuración > Integraciones empresariales.

Verifica tu conexión

Después de agregar el servidor, confirma que tu agente pueda ver las herramientas:

1. Reinicia el IDE o el cliente de agente.
2. Pide al agente que liste las herramientas que tiene del servidor whatsapp_business_tools.
3. Ejecuta una herramienta de lectura de bajo riesgo. Por ejemplo, pídele que liste las empresas que administras con whatsapp_biz_businesses.

Si el agente informa que no hay herramientas o un error de autenticación, vuelve a verificar la URL del endpoint y confirma que completaste el flujo de inicio de sesión.

Herramientas

El MCP de WhatsApp Business Tools expone herramientas con nombres con el prefijo whatsapp_biz_. La mayoría de las herramientas están limitadas a una empresa que administras, por lo que una sesión típica comienza listando tus empresas y eligiendo una. El conjunto de herramientas está evolucionando durante la versión beta.

Descubrimiento

• whatsapp_biz_businesses — Lista las empresas que administras y que otorgaste durante el consentimiento. Úsala primero para elegir una empresa. Ejemplo: "Lista las empresas que puedo administrar en WhatsApp."
• whatsapp_biz_accounts — Lista las cuentas de WhatsApp (y cuentas de mensajería) bajo una empresa. Ejemplo: "Muestra las cuentas de WhatsApp para la empresa 1234567890."
• whatsapp_biz_phone_numbers — Lista los números de teléfono en una empresa o cuenta de WhatsApp, con estado y estado de incorporación. Ejemplo: "Lista los números de teléfono y su estado para esta empresa."

Incorporación de números de teléfono

• whatsapp_biz_add_phone_number — Agrega un número de teléfono a una cuenta de WhatsApp. Ejemplo: "Agrega el número de teléfono +1 555 010 1234 a mi cuenta de WhatsApp."
• whatsapp_biz_send_verification_code — Envía un código de verificación a un número de teléfono. Ejemplo: "Envía un código de verificación por SMS a este número."
• whatsapp_biz_verify_phone_number — Verifica un número de teléfono con el código recibido. Ejemplo: "Verifica este número con el código 123456."
• whatsapp_biz_register_phone_number — Registra un número verificado para que pueda enviar y recibir. Ejemplo: "Registra este número para mensajería."

Plantillas de mensajes

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Lista e inspecciona plantillas de mensajes en una cuenta. Ejemplo: "Lista las plantillas aprobadas para esta cuenta."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Crea, actualiza y elimina plantillas de mensajes. Ejemplo: "Crea una plantilla de marketing llamada order_update en en_US."

Mensajería

• whatsapp_biz_send_message — Envía un mensaje de texto de formato libre (solo se entrega dentro de la ventana de servicio al cliente de 24 horas) o un mensaje de plantilla aprobado desde un número registrado. Confirma el destino contigo antes de enviar. Ejemplo: "Envía la plantilla order_update al +1 555 010 9999 desde este número."

Webhooks

• whatsapp_biz_configure_webhooks — Establece la URL de devolución de llamada y el token de verificación para el tema de WhatsApp y suscríbete a los campos permitidos. Ejemplo: "Configura webhooks para esta empresa con la devolución de llamada https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Suscribe una cuenta de WhatsApp a los webhooks de tu aplicación para que sus eventos se entreguen. Ejemplo: "Suscribe esta cuenta de WhatsApp a webhooks."

Configuración de cuenta

• whatsapp_biz_configure_payments — Configura un método de pago para que la cuenta pueda enviar mensajes facturables. Ejemplo: "Ayúdame a configurar pagos para esta cuenta."
• whatsapp_biz_verify_business — Verifica e inicia la verificación empresarial. Ejemplo: "¿Cuál es el estado de verificación empresarial y cómo la inicio?"
• whatsapp_biz_system_user_token — Obtén un enlace para generar un token de acceso de usuario del sistema para tu empresa, para que puedas crear una solución de mensajería personalizada que llame directamente a la API de WhatsApp Cloud. La generación del token ocurre de forma segura en Configuración empresarial: la herramienta devuelve un enlace profundo a la página Usuarios del sistema, donde seleccionas un usuario del sistema y generas el token. Para obtener más información, consulta <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Crea un usuario del sistema y genera un token de acceso permanente</a>. Ejemplo: "Dame un enlace para crear un token de acceso de usuario del sistema para esta empresa."

Límites de velocidad

Las solicitudes tienen límite de velocidad por usuario y por herramienta para proteger la plataforma. Si excedes el límite, la herramienta devuelve un error de límite de velocidad; reintenta después de una breve espera.

Comentarios

Si tienes comentarios o quieres ver más herramientas, comparte tus comentarios.

Relacionado

• Descripción general de MCP
• Documentación de la Plataforma de WhatsApp Business

---

Índice completo de documentación para este producto: https://developers.facebook.com/documentation/mcp/llms.txt