WhatsApp Business Tools MCP: как подключить WhatsApp Business к ИИ-агенту

15 сентября 2026 Meta выпустила официальный MCP-сервер WhatsApp Business Tools. Он подключает ИИ-агента - Claude Code, Codex, ChatGPT или Cursor - к WhatsApp Business Platform. Вместо переходов между Developer Console, Business Manager и справкой по API ты описываешь задачу агенту, а он добавляет номер, создаёт шаблон сообщения, настраивает вебхуки и отправляет тестовое сообщение.

Сервер пока в бете: доступ открывают постепенно, релиз предназначен для разработки и тестирования, не для продакшн-рассылок в масштабе. Ниже - подготовка и подключение в четырёх клиентах. Команды и настройки сверены по официальной документации Meta 18 сентября 2026.

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, чтобы не пропускать новое.

Что такое WhatsApp Business Tools MCP?

MCP (Model Context Protocol) - открытый стандарт подключения внешних систем к ИИ-агентам. Подробнее о нём - в разборе MCP-серверы для Claude Code: 7 готовых связок.

До этого релиза настройка WhatsApp-интеграции выглядела так: открыл Developer Console, создал приложение, привязал бизнес, добавил номер, подтвердил его кодом, сгенерировал токен, настроил вебхук, сверился со справкой по API - и только потом написал первую строчку кода.

Meta формулирует идею сервера так (перевод с английского):

У Meta теперь два MCP-сервера, и их легко перепутать. Meta Social Technologies MCP - общий инструмент разработчика: поиск по документации, обнаружение точек Graph API, диагностика ошибок приложения. WhatsApp Business Tools MCP предназначен для работы с аккаунтами WhatsApp, номерами, шаблонами, вебхуками и тестовыми сообщениями. Они дополняют друг друга, при необходимости можно подключить оба.

Что именно умеет агент после подключения?

Инструменты сервера сгруппированы под префиксом whatsapp_biz_. По официальной документации:

• Обзор: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers - какие бизнесы, аккаунты и номера тебе доступны.
• Подключение номера: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, 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.
• Сообщения: whatsapp_biz_send_message - свободный текст внутри 24-часового окна диалога или одобренный шаблон вне его; перед отправкой агент подтверждает получателя с тобой.
• Вебхуки: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Настройка аккаунта: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token - ссылка на создание токена системного пользователя для прямых вызовов Cloud API.

Когда клиент пишет бизнесу первым, открывается окно клиентской поддержки: 24 часа можно отвечать свободным текстом. Каждое новое сообщение клиента продлевает окно. После его закрытия написать клиенту можно только одобренным шаблоном. Агент знает это правило и, если получатель вне окна, предложит отправить шаблон вместо обычного текста.

В сервер встроены ограничения доступа. Вход идёт через твой аккаунт Meta с выбором конкретных бизнесов, токены не попадают в историю диалога. Каждое чтение выполняется в твоём контексте, вызовы логируются, а действия, которые что-то меняют, требуют аутентифицированного человека; серверного ключа приложения здесь недостаточно.

Подключение MCP - часть работы с агентом. На практикуме за 3 эфира собираешь связку из всех трёх частей методологии: ИИ-клон + Второй мозг + Контекст-инжиниринг.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Что нужно проверить до подключения?

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

1. У тебя есть бизнес в Meta, где ты администратор (роль MANAGE).
2. Есть приложение Meta с включённым сценарием WhatsApp Business Messaging (или продукт WhatsApp в старых приложениях), и у тебя права администратора именно на приложение; прав только на бизнес недостаточно.
3. Для бизнеса приняты условия WhatsApp Business Cloud API - без этого регистрация номера и отправка заблокированы.

По описанию Meta, проблемы с условиями использования, способом оплаты и проверкой бизнеса обычно возникают без явного объяснения причины. Агент проверяет их заранее и даёт прямую ссылку, по которой можно принять условия, указать способ оплаты или начать проверку бизнеса.

Как подключить сервер к Claude Code?

Если Claude Code ещё не установлен, начни с гайда как установить Claude Code с официального сайта.

1. Добавить сервер

   В терминале выполни:

   bash

   Скопировать

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

   Сервер удалённый, устанавливать его локально не нужно.

2. Пройти вход через Meta

   В сессии Claude Code набери /mcp и выбери whatsapp_business_tools. Откроется браузер со входом в аккаунт Meta. Если браузер не открылся, скопируй ссылку из клиента и открой вручную.

3. Выдать разрешения

   На экране согласия выбери бизнесы и приложения с WhatsApp, к которым разрешаешь доступ. Сервер запросит три разрешения: business_management (найти бизнесы, где ты администратор), whatsapp_business_management (аккаунты, номера, шаблоны, вебхуки) и whatsapp_business_messaging (отправка сообщений с твоих номеров).

4. Проверить подключение

   Перезапусти Claude Code, повтори вход через /mcp и спроси агента, какие инструменты он видит у сервера whatsapp_business_tools. Затем выполни безопасное чтение: «Перечисли бизнесы, которыми я могу управлять» - агент вызовет whatsapp_biz_businesses. Если инструментов нет или пришла ошибка входа, проверь адрес сервера и пройди вход заново.

Вход через OAuth привязан к запуску клиента: после перезапуска Claude Code вход нужно пройти ещё раз. Отозвать доступ можно в любой момент в настройках facebook.com, в разделе «Business Integrations».

Как подключить Codex, ChatGPT и Claude Desktop?

Codex App. Открой настройки (шестерёнка внизу слева), раздел MCP Servers, пункт Add servers. Выбери тип Streamable HTTP и укажи:

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

Нажми Authenticate и пройди вход в браузере.

ChatGPT. Settings, раздел Plugins, Browse plugins, значок «+» в правом верхнем углу. Укажи имя, тот же URL и тип аутентификации OAuth.

Claude Desktop. Settings, Connectors, Add custom connector. Имя - WhatsApp Business Tools, URL - тот же адрес сервера.

После добавления в любом клиенте порядок проверки тот же: перезапуск, повторный вход, список инструментов, безопасное чтение списка бизнесов.

Как проходит первая сессия: от списка бизнесов до тестового сообщения?

Типовая первая сессия с подключённым сервером:

1. «Перечисли бизнесы, которыми я управляю» - агент вызывает whatsapp_biz_businesses, ты выбираешь нужный.
2. «Покажи аккаунты WhatsApp и номера этого бизнеса» - whatsapp_biz_accounts и whatsapp_biz_phone_numbers со статусами.
3. «Добавь номер +7 ... в аккаунт» - whatsapp_biz_add_phone_number.
4. «Отправь код подтверждения по SMS» - whatsapp_biz_send_verification_code. Код приходит тебе на телефон.
5. «Подтверди номер кодом 123456» - whatsapp_biz_verify_phone_number, затем регистрация через whatsapp_biz_register_phone_number.
6. «Создай шаблон order_update на русском для уведомлений о заказе» - whatsapp_biz_create_template, агент даст ссылку на статус одобрения.
7. «Отправь тестовое сообщение на мой номер» - whatsapp_biz_send_message, агент подтвердит получателя перед отправкой.
8. «Настрой вебхук на адрес https://example.com/webhook» - whatsapp_biz_configure_webhooks и подписка через whatsapp_biz_subscribe_webhook.

Дальше входящие сообщения клиентов будут приходить на указанный адрес - туда их обычно забирают CRM, служба поддержки или бот. Саму обработку на этом адресе ты строишь отдельно, сервер отвечает только за настройку.

Какие ограничения у бета-версии?

У сервера четыре ограничения, которые нужно учитывать.

Статус бета. Meta пишет, что интерфейс и набор инструментов могут поменяться, а доступ открывают постепенно: если сервер пока не подключается, возможно, тебе его ещё не предоставили.

Назначение. Релиз сделан для разработки и тестирования; для массовой продакшн-отправки он не предназначен. Для боевых рассылок понадобится полноценная интеграция с Cloud API - например, через токен системного пользователя, ссылку на который даёт инструмент whatsapp_biz_system_user_token.

Лимиты. Запросы ограничены на пользователя по каждому инструменту. При превышении инструмент вернёт ошибку лимита - подожди и повтори.

Правило 24-часового окна. Вне окна клиентского диалога можно отправлять только одобренные шаблоны.

Работает ли это из России?

Meta признана экстремистской организацией и запрещена в РФ, при этом сам WhatsApp под запрет не попал и продолжает работать в России.

Сервер использует вход через аккаунт Meta и требует бизнес-кабинет с правами администратора. Даже при выполнении этих условий доступ к серверу может быть ещё не открыт: Meta предоставляет его постепенно. Возможность создания нового кабинета и ограничения доступа из России не проверялись; конкретных рекомендаций здесь нет. Про доступ и оплату западных ИИ-инструментов из России есть отдельный разбор: чем оплатить инструменты для вайб-кодинга из России.

Зачем это бизнесу?

Типовой сценарий для малого бизнеса: клиенты пишут в WhatsApp, хочется отвечать быстро и отправлять уведомления о статусе заказа. Раньше первичная настройка означала самостоятельную работу в нескольких кабинетах Meta или привлечение разработчика. Теперь этот участок можно пройти в диалоге с агентом. Обработку входящих сообщений на своём адресе ты по-прежнему строишь отдельно - это следующая задача после настройки вебхука.

Сервер полезен и тем, у кого интеграция уже работает. Шаблоны сообщений приходится обновлять регулярно: новая акция, новый текст уведомления. Через сервер агент создаёт или правит шаблон и показывает статус одобрения без перехода в кабинет.

Похожую логику - агент подключается к внешней системе и работает в ней по твоему описанию - мы разбирали на примере документации в гайде как подключить NotebookLM к Claude Code через MCP.

Что дальше?

Серверу три дня от анонса. Начать можно с одной команды и входа через Meta, затем запросить список своих бизнесов у агента. Дальше по потребности: номера, шаблоны, вебхуки, тестовые сообщения.

Другие варианты подключения агента к внешним системам есть в подборке MCP-серверов для Claude Code - там ещё семь рабочих связок под разные задачи.

Полная схема по вайб-кодингу: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира, 2 000 ₽. Записи остаются у тебя.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email