WhatsApp Business Tools MCP

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

WhatsApp Business Tools MCP

Для разработчиков, создающих решения на базе WhatsApp Business Platform (Cloud API), — сервер WhatsApp Business Tools MCP позволяет вашему ИИ-агенту и IDE-ассистенту управлять и отлаживать вашу интеграцию с WhatsApp из одного места. Он позволяет агенту находить компании и аккаунты WhatsApp, которыми вы управляете, подключать и регистрировать номера телефонов, создавать и управлять шаблонами сообщений, настраивать вебхуки и отправлять сообщения — действуя от вашего имени в приложениях и компаниях, которыми вы управляете.

Примечание: Сервер WhatsApp Business Tools MCP внедряется постепенно и может быть доступен не всем. Интерфейс и набор инструментов находятся в стадии бета-тестирования и могут меняться.

Обзор

В следующей таблице приведены сведения о сервере:

Атрибут	Значение
Имя сервера	WhatsApp Business Tools
Транспорт	Streamable HTTP
Конечная точка	https://mcp.facebook.com/whatsapp_business_tools
Аутентификация	Вход через аккаунт разработчика Meta (OAuth)
Статус	Бета-версия — интерфейс и набор инструментов могут меняться

Предварительные требования

Сервер работает с вашими собственными ресурсами, поэтому перед использованием большинства инструментов агенту необходимо:

• Доступ администратора к компании, которой вы хотите управлять (роль MANAGE).
• Приложение с поддержкой WhatsApp, администратором которого вы являетесь, подключенное к этой компании — приложение с вариантом использования WhatsApp Business Messaging (или продуктом WhatsApp в более старом приложении). У вас должен быть доступ администратора к приложению, а не только к компании.
• Принятые Условия предоставления услуг WhatsApp Business Cloud API для этой компании. Отправка сообщений и регистрация номеров телефонов заблокированы, пока администратор не примет их.

Если какое-либо предварительное требование отсутствует, инструмент возвращает сообщение об ошибке с указанием действий, которое сообщает, что нужно исправить, и содержит ссылку на страницу, где это можно сделать.

Настройка IDE или клиента агента

Сервер WhatsApp Business Tools MCP является удаленным сервером. Клиенты, поддерживающие удаленные MCP-серверы, могут подключаться к конечной точке напрямую. Для клиентов, поддерживающих только локальные (stdio) серверы, используйте мост mcp-remote, который проксирует удаленный сервер через stdio.

Настройте клиент, используя один из разделов ниже, затем завершите вход через OAuth для аутентификации.

Claude Code и Desktop

Claude Code — выполните следующую команду, чтобы добавить сервер:

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

Затем выполните /mcp в сессии и выберите whatsapp_business_tools для аутентификации.

Claude Desktop — откройте Настройки > Подключения > Добавить пользовательское подключение, затем укажите:

• Имя: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App и ChatGPT

Codex App — откройте Настройки (значок шестеренки в левом нижнем углу) > MCP-серверы > Добавить серверы, выберите Streamable HTTP, затем укажите:

• Имя: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Аутентификация: OAuth

Нажмите Аутентифицировать и завершите вход через OAuth.

ChatGPT — откройте Настройки > Плагины > Обзор плагинов, нажмите + в правом верхнем углу, чтобы добавить новый плагин, затем укажите:

• Имя: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Аутентификация: OAuth

Сохраните плагин и завершите вход через OAuth.

Вход через OAuth

Сервер WhatsApp Business Tools MCP выполняет аутентификацию через ваш аккаунт разработчика Meta с помощью OAuth, поэтому один и тот же процесс входа работает во всех клиентах.

Процесс входа

После добавления сервера в клиент (см. Настройка IDE или клиента агента):

1. Запустите подключение. Многие клиенты автоматически начинают процесс OAuth при добавлении сервера. Другие требуют сначала нажать Подключить или Аутентифицировать.
2. Войдите. Откроется браузер для входа с использованием вашего аккаунта Meta. Если он не открылся автоматически, скопируйте ссылку, которую выводит клиент, и откройте ее вручную.
3. Предоставьте доступ. На экране согласия выберите компании и приложения с поддержкой WhatsApp, к которым серверу нужен доступ.
4. Подтвердите. Вернитесь в клиент и проверьте подключение.

Вам потребуется снова выполнить процесс входа при перезапуске клиента.

Области доступа

Сервер запрашивает следующие разрешения во время согласия:

Область доступа	Доступ
business_management	Поиск компаний, которыми вы управляете и которые выбрали во время согласия, и выполнение действий от их имени.
whatsapp_business_management	Управление аккаунтами WhatsApp Business, номерами телефонов, шаблонами сообщений и вебхуками.
whatsapp_business_messaging	Отправка сообщений с ваших зарегистрированных номеров телефонов.

Вы можете просмотреть или отозвать доступ в любое время на facebook.com > Настройки > Бизнес-интеграции.

Проверка подключения

После добавления сервера убедитесь, что агент видит инструменты:

1. Перезапустите IDE или клиент агента.
2. Попросите агента перечислить инструменты, доступные на сервере whatsapp_business_tools.
3. Выполните инструмент чтения с низким риском. Например, попросите его перечислить компании, которыми вы управляете, с помощью whatsapp_biz_businesses.

Если агент сообщает об отсутствии инструментов или ошибке аутентификации, проверьте URL конечной точки и убедитесь, что вы завершили процесс входа.

Инструменты

Сервер WhatsApp Business Tools MCP предоставляет инструменты с префиксом whatsapp_biz_. Большинство инструментов ограничены компанией, которой вы управляете, поэтому типичная сессия начинается с перечисления ваших компаний и выбора одной из них. Набор инструментов развивается в период бета-тестирования.

Обнаружение

• whatsapp_biz_businesses — Перечисляет компании, которыми вы управляете и которые вы предоставили во время согласия. Используйте этот инструмент первым, чтобы выбрать компанию. Пример: «Перечисли компании, которыми я могу управлять в WhatsApp».
• whatsapp_biz_accounts — Перечисляет аккаунты WhatsApp (и аккаунты обмена сообщениями) в рамках компании. Пример: «Покажи аккаунты WhatsApp для компании 1234567890».
• whatsapp_biz_phone_numbers — Перечисляет номера телефонов компании или аккаунта WhatsApp с указанием статуса и состояния подключения. Пример: «Перечисли номера телефонов и их статус для этой компании».

Подключение номеров телефонов

• whatsapp_biz_add_phone_number — Добавляет номер телефона в аккаунт WhatsApp. Пример: «Добавь номер телефона +1 555 010 1234 в мой аккаунт WhatsApp».
• whatsapp_biz_send_verification_code — Отправляет код подтверждения на номер телефона. Пример: «Отправь код подтверждения по SMS на этот номер».
• whatsapp_biz_verify_phone_number — Подтверждает номер телефона полученным кодом. Пример: «Подтверди этот номер кодом 123456».
• whatsapp_biz_register_phone_number — Регистрирует подтвержденный номер, чтобы он мог отправлять и получать сообщения. Пример: «Зарегистрируй этот номер для обмена сообщениями».

Шаблоны сообщений

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Перечисляет и просматривает шаблоны сообщений в аккаунте. Пример: «Перечисли одобренные шаблоны для этого аккаунта».
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Создает, обновляет и удаляет шаблоны сообщений. Пример: «Создай маркетинговый шаблон с именем order_update на языке en_US».

Обмен сообщениями

• whatsapp_biz_send_message — Отправляет свободный текст (доставляется только в течение 24-часового окна обслуживания клиентов) или одобренное шаблонное сообщение с зарегистрированного номера. Подтверждает получателя перед отправкой. Пример: «Отправь шаблон order_update на номер +1 555 010 9999 с этого номера».

Вебхуки

• whatsapp_biz_configure_webhooks — Устанавливает URL обратного вызова и токен проверки для темы WhatsApp и подписывается на разрешенные поля. Пример: «Настрой вебхуки для этой компании с обратным вызовом https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Подписывает аккаунт WhatsApp на вебхуки вашего приложения, чтобы его события доставлялись. Пример: «Подпиши этот аккаунт WhatsApp на вебхуки».

Настройка аккаунта

• whatsapp_biz_configure_payments — Настраивает способ оплаты, чтобы аккаунт мог отправлять платные сообщения. Пример: «Помоги мне настроить платежи для этого аккаунта».
• whatsapp_biz_verify_business — Проверяет и запускает верификацию компании. Пример: «Каков статус верификации компании и как ее начать?»
• whatsapp_biz_system_user_token — Предоставляет ссылку для генерации токена доступа системного пользователя для вашей компании, чтобы вы могли создать собственное решение для обмена сообщениями, которое напрямую вызывает WhatsApp Cloud API. Генерация токена происходит безопасно в настройках компании — инструмент возвращает глубокую ссылку на страницу Системные пользователи, где вы выбираете системного пользователя и генерируете токен. Чтобы узнать больше, см. Создание системного пользователя и генерация постоянного токена доступа. Пример: «Дай мне ссылку для создания токена доступа системного пользователя для этой компании».

Лимиты запросов

Запросы ограничены по количеству на пользователя на инструмент для защиты платформы. Если вы превысите лимит, инструмент вернет ошибку превышения лимита; повторите попытку после короткой паузы.

Обратная связь

Если у вас есть отзывы или вы хотите увидеть больше инструментов, поделитесь своим мнением.

Связанные материалы

• Обзор MCP
• Документация WhatsApp Business Platform

---

Полный указатель документации по этому продукту: https://developers.facebook.com/documentation/mcp/llms.txt