WhatsApp Business MCP: подключение к Claude Code и Codex

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

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

Документация Ailoot находится в справочном центре.

Что представляет собой WhatsApp Business Tools MCP?#

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

Раньше настройка интеграции с 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 и выбираешь конкретные бизнесы; токены не сохраняются в истории переписки. Все запросы на чтение выполняются от твоего имени и журналируются. Для изменения данных требуется аутентификация человека — одного серверного ключа приложения недостаточно.

Что проверить перед подключением?#

Сервер работает с ресурсами от твоего имени. До первого запроса убедись в следующем:

1. У тебя есть бизнес в Meta, где тебе назначена роль администратора (MANAGE).
2. Создано приложение Meta со сценарием WhatsApp Business Messaging (или продуктом WhatsApp в приложении старого типа). У тебя должны быть права администратора именно на приложение: доступа только к бизнесу недостаточно.
3. Для бизнеса приняты условия WhatsApp Business Cloud API. Иначе регистрация номера и отправка сообщений будут недоступны.

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

Как настроить сервер в Claude Code?#

Если Claude Code ещё не установлен, воспользуйся инструкцией по установке Claude Code с официального сайта.

1. Зарегистрировать сервер

   Введи в терминале команду:

   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. Если инструменты не отображаются или вход завершился ошибкой, проверь URL сервера и повтори авторизацию.

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. «Добавь мой тестовый номер в аккаунт» — будет использован 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, службу поддержки или бота. Обработку сообщений на этом адресе нужно настроить отдельно: MCP-сервер отвечает только за конфигурацию.

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

При использовании сервера учитывай четыре ограничения.

Бета-статус. Meta предупреждает, что интерфейс и список инструментов могут измениться. Доступ открывают постепенно, поэтому невозможность подключиться может означать, что сервер ещё не доступен для твоего аккаунта.

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

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

24-часовое окно. Когда окно клиентского диалога закрыто, можно отправить только одобренный шаблон.

Чем сервер полезен бизнесу?#

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

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

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

Как действовать дальше?#

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

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

Познакомиться с Ailoot.