# WhatsApp Business MCP: подключение к Claude Code и Codex
> Официальный MCP-сервер Meta для WhatsApp Business: возможности агента, подключение в Claude Code, настройка в Codex и ChatGPT, а также ограничения бета-версии.
Source: https://ailoot.ai/blog/ru/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/ru/whatsapp-business-mcp/
Language: ru
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-917c5b114ef15e4199a7771587d1ccb049ec8027ae099b11210c2fd3705ccaf6
15 сентября 2026 года Meta представила официальный MCP-сервер WhatsApp Business Tools. С его помощью ИИ-агент — Claude Code, Codex, ChatGPT или Cursor — может работать с WhatsApp Business Platform. Вместо того чтобы переключаться между Developer Console, Business Manager и справкой по API, можно описать задачу агенту: он добавит номер, создаст шаблон сообщения, настроит вебхук или отправит тестовое сообщение.
Сервер пока работает в бета-режиме: доступ предоставляют постепенно. Выпуск рассчитан на разработку и тестирование, а не на масштабные рассылки в продакшене. Далее описаны подготовка и подключение в четырёх клиентах. Команды и параметры сверены с официальной документацией Meta по состоянию на 18 сентября 2026 года.
Документация Ailoot находится в [справочном центре](https://ailoot.ai/docs/).
## Что представляет собой WhatsApp Business Tools MCP?
Коротко о главном
Это официальный удалённый MCP-сервер Meta. Он предоставляет ИИ-агенту инструменты для управления WhatsApp Business Platform: бизнес-аккаунтами, номерами, шаблонами сообщений, вебхуками и тестовыми отправками. Для авторизации используется OAuth: ты входишь в свой аккаунт Meta и выбираешь бизнесы, к которым разрешаешь доступ.
MCP (Model Context Protocol) — открытый стандарт, позволяющий подключать внешние системы к ИИ-агентам. Подробнее о протоколе рассказано в материале [«MCP-серверы для Claude Code: 7 готовых связок»](https://ailoot.ai/blog/ru/mcp-servers-claude-code/). Проверенные подключения с командами установки собраны в каталоге MCP.
Раньше настройка интеграции с WhatsApp требовала пройти несколько этапов: открыть Developer Console, создать приложение, связать его с бизнесом, добавить и подтвердить номер кодом, получить токен, настроить вебхук, изучить API — и лишь после этого писать первый код.
Meta описывает назначение сервера так (перевод с английского):
Расскажи, что тебе требуется, — и агент сам разберётся с аккаунтами, номерами, шаблонами и запросами к API.
— Meta для разработчиков, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
У 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 и выбираешь конкретные бизнесы; токены не сохраняются в истории переписки. Все запросы на чтение выполняются от твоего имени и журналируются. Для изменения данных требуется аутентификация человека — одного серверного ключа приложения недостаточно.
## Что проверить перед подключением?
Коротко о главном
Нужно выполнить три условия: иметь роль MANAGE в нужном бизнесе Meta, обладать правами администратора приложения с настроенным сценарием WhatsApp и принять условия WhatsApp Business Cloud API. Если какого-либо требования не хватает, инструмент сообщит об этом и предоставит ссылку на нужный раздел для исправления.
Сервер работает с ресурсами от твоего имени. До первого запроса убедись в следующем:
1. У тебя есть бизнес в Meta, где тебе назначена роль администратора (MANAGE).
2. Создано приложение Meta со сценарием WhatsApp Business Messaging (или продуктом WhatsApp в приложении старого типа). У тебя должны быть права администратора именно на приложение: доступа только к бизнесу недостаточно.
3. Для бизнеса приняты условия WhatsApp Business Cloud API. Иначе регистрация номера и отправка сообщений будут недоступны.
Meta отмечает, что сложности с условиями использования, способом оплаты и проверкой компании нередко возникают без понятного объяснения. Агент может проверить эти требования заранее и дать прямую ссылку, чтобы принять условия, добавить способ оплаты или начать проверку бизнеса.
## Как настроить сервер в Claude Code?
Коротко о главном
Выполни `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`. Затем в сессии введи `/mcp`, выбери сервер и авторизуйся в Meta. После перезапуска клиента авторизацию потребуется пройти снова.
Если Claude Code ещё не установлен, воспользуйся инструкцией [по установке Claude Code с официального сайта](https://ailoot.ai/blog/ru/install-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`. Если инструменты не отображаются или вход завершился ошибкой, проверь URL сервера и повтори авторизацию.
OAuth-вход действует в рамках запуска клиента, поэтому после каждого перезапуска Claude Code нужно авторизоваться заново. Отозвать разрешение можно в любой момент через настройки facebook.com в разделе «Business Integrations».
## Как подключить сервер к Codex, ChatGPT и Claude Desktop?
Коротко о главном
Адрес сервера и OAuth-вход для этих трёх клиентов одинаковы, но добавляются они в разных разделах настроек. В Codex App открой Settings → MCP Servers и добавь Streamable HTTP-сервер. В ChatGPT путь начинается с Settings → Plugins. В Claude Desktop используй Settings → Connectors и добавь пользовательский коннектор.
**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 сервера.
В каждом клиенте проверь результат одинаково: перезапусти приложение, пройди вход снова, проверь список инструментов и запроси перечень бизнесов без изменения данных.
## Как провести первый сеанс: от просмотра бизнесов до тестового сообщения?
Коротко о главном
Последовательность действий: запросить список бизнесов и выбрать нужный, посмотреть его аккаунты и номера, добавить номер, получить код по SMS или звонком, подтвердить номер и зарегистрировать его. Затем можно создать шаблон, отправить тестовое сообщение и настроить вебхук. Код из SMS вводишь ты, а не агент.
Примерный план первого сеанса с подключённым сервером:
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](https://example.com/webhook)» — для этого понадобятся `whatsapp_biz_configure_webhooks` и `whatsapp_biz_subscribe_webhook`.
После настройки на указанный адрес будут поступать сообщения клиентов. Обычно их передают в CRM, службу поддержки или бота. Обработку сообщений на этом адресе нужно настроить отдельно: MCP-сервер отвечает только за конфигурацию.
## Какие ограничения есть у бета-версии?
Коротко о главном
Это бета-версия: состав инструментов может измениться, а доступ предоставляют постепенно. Сервер рассчитан на разработку и тестирование, не на масштабные продакшн-рассылки. Для каждого инструмента действуют пользовательские лимиты запросов, а после перезапуска клиента требуется повторный вход.
При использовании сервера учитывай четыре ограничения.
**Бета-статус.** Meta предупреждает, что интерфейс и список инструментов могут измениться. Доступ открывают постепенно, поэтому невозможность подключиться может означать, что сервер ещё не доступен для твоего аккаунта.
**Назначение.** Выпуск предназначен для разработки и тестирования, а не для массовой отправки сообщений в продакшене. Для рабочих рассылок потребуется полноценная интеграция с Cloud API — например, с токеном системного пользователя, путь к созданию которого показывает `whatsapp_biz_system_user_token`.
**Ограничения запросов.** Для каждого инструмента установлен лимит на пользователя. При его превышении сервер вернёт ошибку; дождись сброса лимита и повтори запрос.
**24-часовое окно.** Когда окно клиентского диалога закрыто, можно отправить только одобренный шаблон.
## Чем сервер полезен бизнесу?
Коротко о главном
Первоначальную настройку интеграции с WhatsApp можно выполнить в диалоге с агентом, который подсказывает порядок действий и помогает понять ошибки платформы. Типичные задачи — поддержка клиентов, уведомления о заказах и записях, а также подготовка шаблонов сообщений.
Представим небольшой бизнес, которому нужно быстро отвечать клиентам в WhatsApp и сообщать им о статусе заказа. Раньше начальная настройка требовала самостоятельно работать в нескольких разделах Meta или обращаться к разработчику. Теперь эти шаги можно пройти вместе с агентом. При этом обработку входящих сообщений на своём сервере всё равно придётся настроить отдельно — это следующий этап после установки вебхука.
Сервер пригодится и компаниям, у которых интеграция уже запущена. Шаблоны нужно периодически обновлять: например, при запуске акции или изменении текста уведомления. Агент может создать или отредактировать шаблон и проверить его статус одобрения, не переходя в панель управления.
Похожий принцип — подключение агента к внешней системе и выполнение задач по текстовому запросу — показан на примере документации в руководстве «Как подключить NotebookLM к Claude Code через MCP».
## Как действовать дальше?
Коротко о главном
Проверь требования, добавь сервер одной командой и пройди авторизацию. Для начала безопасно запроси список бизнесов, которыми можешь управлять. Затем подключи тестовый номер и отправь первое сообщение. Учитывай бета-статус: для продакшн-рассылок нужна полноценная интеграция с Cloud API.
С момента анонса сервера прошло три дня. Для первого знакомства достаточно выполнить команду подключения, войти через Meta и попросить агента показать доступные бизнесы. Потом можно перейти к работе с номерами, шаблонами, вебхуками и тестовыми сообщениями.
Другие способы соединить Claude Code с внешними системами собраны в подборке [MCP-серверов для Claude Code](https://ailoot.ai/blog/ru/mcp-servers-claude-code/): там описаны ещё семь готовых связок для разных задач.
### Источники
- [Meta для разработчиков: анонс WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: документация WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: обзор MCP-серверов для разработчиков](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform: документация](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Познакомиться с [Ailoot](https://ailoot.ai/).
## Вопросы и ответы
### Какая первая проверка подключения безопаснее всего?
После входа OAuth изучите список инструментов и прочитайте доступные вам компании. Это проверяет доступ до добавления номера, создания шаблонов, настройки webhook и отправки тестового сообщения.
### Создаёт ли настройка webhook обработку сообщений?
Нет. MCP-сервер настраивает адрес обратного вызова и подписки. CRM, службу поддержки или бота, принимающего и обрабатывающего сообщения по этому адресу, нужно создать отдельно.
## Ailoot · Компания и портфель её проектов
Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.
Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.
Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.