Перейти к содержимому
OmniChannels.ai
Меню

MCP-сервер WhatsApp: подключение ИИ-агентов к WhatsApp и SMS

Как MCP-сервер WhatsApp позволяет Claude, Cursor и другим ИИ-агентам безопасно отправлять WhatsApp и SMS: подключение, ограничители, согласие и сценарии.

Обновлено 9 мин чтения

Автор: OmniChannels.ai Editorial Team · Проверил: BroadNet Messaging Solutions Team

Интеграции

Короткий ответ

MCP-сервер WhatsApp предоставляет операции обмена сообщениями как инструменты, которые ИИ-агент может обнаружить и вызвать через Model Context Protocol. С MCP-сервером OmniChannels.ai по адресу https://mcp.broadnet.me/mcp клиент вроде Claude Code или Cursor аутентифицируется Bearer-токеном и может отправлять SMS и сообщения WhatsApp, просматривать шаблоны и читать отчёты о доставке. Агент действует с правами вашего аккаунта, поэтому ограничители важны.

На этой странице
  1. Что такое MCP-сервер WhatsApp?
  2. Как работает MCP-сервер OmniChannels.ai?
  3. Как подключить Claude, Cursor или другой клиент?
  4. Что ИИ-агент может делать с WhatsApp и SMS?
  5. Как не дать ИИ-агенту написать не тем людям?
  6. Какие правила WhatsApp и SMS по-прежнему действуют?
  7. Пример: команда поддержки добавляет помощника по статусам доставки
  8. Когда MCP — неверный выбор?
  9. Как помогает OmniChannels.ai

Главное

  • MCP (Model Context Protocol) — открытый стандарт, позволяющий ИИ-клиенту перечислять и вызывать инструменты на удалённом сервере; сервер OmniChannels.ai сопоставляет свои инструменты с тем же REST API, которым пользуется ваш код.
  • Один эндпоинт, https://mcp.broadnet.me/mcp по Streamable HTTP, и один заголовок, Authorization: Bearer <token>, подключают Claude Code, Cursor, VS Code, Claude Desktop и другие клиенты.
  • Агент с инструментами отправки может писать реальным людям и тратить реальный баланс, поэтому включайте только нужные инструменты и требуйте подтверждения человеком перед любой отправкой.
  • Правила WhatsApp действуют и для агентов: согласие (opt-in), одобренные шаблоны вне окна обслуживания клиента и правила Sender ID для SMS.
  • Используйте временный ключ при экспериментах, а постоянный — только для проверенного продакшен-агента.

Это руководство для разработчиков и технических руководителей, которые хотят, чтобы ИИ-агент отправлял или отслеживал сообщения WhatsApp и SMS без ручного написания каждой интеграции. В нём объясняется, что такое MCP-сервер WhatsApp, как его подключить, какие ограничители задать до того, как агент начнёт работать с реальными клиентами, и где MCP — неподходящий инструмент.

Что такое MCP-сервер WhatsApp?

MCP-сервер WhatsApp — это сервис, который предоставляет операции обмена сообщениями, например отправку шаблона или чтение отчёта о доставке, как инструменты, которые ИИ-клиент может обнаружить и вызвать. Он работает по Model Context Protocol (MCP) — открытому стандарту подключения ИИ-ассистентов к внешним инструментам и данным.

Без MCP, чтобы дать ассистенту возможность отправлять сообщения, нужно писать отдельную функцию для каждой модели или фреймворка. С MCP клиент подключается к одному URL, спрашивает сервер, какие есть инструменты, и вызывает их, когда этого требует запрос пользователя. Краткое определение дано в статье глоссария о MCP-серверах.

Два момента легко упустить:

  • MCP не обходит правила WhatsApp. Сервер вызывает те же операции WhatsApp Business Platform, что и любая другая интеграция, поэтому шаблоны, согласие (opt-in) и окно обслуживания клиента по-прежнему действуют.
  • Агент безопасен настолько, насколько безопасен его токен. Инструменты действуют с правами, именами отправителей и балансом предоставленного вами ключа.

Как работает MCP-сервер OmniChannels.ai?

Это удалённый MCP-сервер с единственным эндпоинтом, аутентификация — по Bearer-токену. Его инструменты сопоставлены с тем же REST API, который описан в документации для разработчиков, поэтому всё, что может агент, может и ваш собственный код с этим токеном.

Параметр Значение
Эндпоинт https://mcp.broadnet.me/mcp
Транспорт MCP Streamable HTTP
Аутентификация Authorization: Bearer <token> в каждом запросе
Действует на Ваш аккаунт: каналы, имена отправителей, шаблоны и баланс
Типичные области инструментов Отправка по каждому каналу (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), просмотр и отправка шаблонов WhatsApp, чтение отчётов о доставке

Точный список инструментов зависит от версии сервера и вашего аккаунта, поэтому читайте его в своём клиенте, а не в статье блога. Запрос без токена отклоняется на уровне протокола, и это полезная быстрая проверка.

Как подключить Claude, Cursor или другой клиент?

Вы добавляете эндпоинт и заголовок в конфигурацию MCP вашего клиента и храните токен в переменной окружения или секретном поле, чтобы он никогда не попал в репозиторий.

Подключение за пять шагов

  1. Получите ключ. В административном портале откройте Integrations, затем MCP Integration и выберите Get temporary key. Постоянный ключ для продакшен-агента выдаёт администратор вашего аккаунта или главный аккаунт.
  2. Сохраните его как секрет. Например, экспортируйте как BROADNET_TOKEN в вашей оболочке.
  3. Добавьте сервер в клиент. Для Claude Code:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
  --header "Authorization: Bearer $BROADNET_TOKEN"
  1. Проверьте инструменты. В Claude Code команда /mcp показывает сервер и его инструменты. В Cursor, VS Code и Claude Desktop конфигурация находится в собственном файле настроек MCP клиента.
  2. Отключите то, что агенту не нужно, до первого настоящего запроса.

Форматы клиентов меняются между версиями, поэтому точные фрагменты для Cursor, VS Code и Claude Desktop находятся в документации с пошаговыми страницами для Claude Code, Cursor и n8n. Справочником по командам Claude Code служит его собственная документация по MCP.

Чтобы протестировать без клиента, отправьте на эндпоинт запрос MCP initialize с вашим токеном. Полная команда curl приведена в документации.

Что ИИ-агент может делать с WhatsApp и SMS?

Всё, что разрешают подключённые инструменты: отправлять, искать и составлять отчёты. Практическая ценность — в гибких задачах на человеческом языке вокруг обмена сообщениями, а не в высокообъёмных потоках, которые стоит оставить в коде.

Примеры запросов, подходящих агенту:

  • «Отправь SMS от имени OmniDemo на 447700900123 с текстом, что техник приедет в 15:00».
  • «Покажи мои одобренные шаблоны WhatsApp на арабском».
  • «Отправь шаблон WhatsApp order_update на 971500000000 с номером заказа INV-400».
  • «Сколько сообщений в вчерашней кампании со выписками не доставлено и почему?»
  • «Составь черновик карточки RCS для нашего осеннего запуска и покажи мне, прежде чем что-либо отправлять».

Хорошие сценарии примерно в порядке безопасности:

Сценарий Нужные инструменты Риск
Вопросы о доставке от сотрудников поддержки («получил ли клиент SMS?») Только чтение отчётов Низкий
Помощник разработчика, отправляющий тестовые сообщения на ваши номера при создании интеграции Инструменты отправки, только тестовые номера От низкого до среднего
Поиск шаблонов и составление черновиков текста на проверку Инструменты просмотра шаблонов Низкий
Операционный помощник, отправляющий разовые уведомления после одобрения человеком Инструменты отправки плюс подтверждение Средний
Автономный агент, пишущий клиентам Инструменты отправки без подтверждения Высокий; нужен проверенный дизайн

Внутреннему ассистенту, который отвечает на вопросы о доставке, инструменты отправки не нужны вовсе. Удалите их.

Как не дать ИИ-агенту написать не тем людям?

Относитесь к агенту как к новому сотруднику с корпоративным телефоном: ограниченные права, контроль вначале и запись того, что он делал. Меры предосторожности перечислены в документации; вот они с обоснованием.

  1. Минимум прав. Включайте только инструменты, нужные для задачи. Агенту, отвечающему на вопросы о доставке, инструменты отправки не нужны; агенту, отправляющему OTP, не нужны инструменты шаблонов и аккаунта.
  2. Человек в цикле. Настройте клиент так, чтобы он запрашивал подтверждение перед любым инструментом, который отправляет, и всегда перед отправками многим получателям. В Claude Code правила разрешений ссылаются на инструменты MCP как mcp__<server>__<tool>, поэтому можно разрешить инструментам чтения работать свободно, а инструменты отправки по-прежнему будут запрашивать подтверждение.
  3. Временные ключи для экспериментов. Используйте временный ключ при тестировании, а постоянный — только для проверенного продакшен-агента.
  4. Сначала тестовые номера. Направляйте новых агентов на свои подтверждённые номера, пока не убедитесь в их поведении.
  5. Следите за журналами. Просматривайте в отчётах о доставке, что агент отправил, особенно в первые недели.
  6. Быстро отзывайте. Если ключ раскрыт, попросите администратора аккаунта или нашу поддержку отозвать его и выдать новый.
  7. Соблюдайте согласие. Агенты должны следовать тем же правилам согласия (opt-in), Sender ID и каналов, что и любой другой отправитель.

Отдельно стоит упомянуть внедрение инструкций (prompt injection). Если агент читает недоверенный текст, например входящее сообщение клиента или веб-страницу, этот текст может содержать инструкции. Не давайте агенту, читающему недоверенное содержимое, доступ к инструментам отправки без надзора. Разделяйте чтение и отправку на отдельные шаги, а отправку одобряет человек.

Какие правила WhatsApp и SMS по-прежнему действуют?

Все. Агент — просто ещё один отправитель.

  • Согласие (opt-in). Политика WhatsApp Business Messaging Policy от Meta требует, чтобы люди дали согласие получать от вас сообщения. Агент, который может написать любому из таблицы, этого не меняет.
  • Шаблоны и окно. Свободные сообщения WhatsApp возможны только внутри окна обслуживания клиента; вне его нужен одобренный шаблон. См. наше руководство по 24-часовому окну обслуживания клиента и документацию WhatsApp API.
  • Стоимость. Meta берёт плату за каждое доставленное сообщение по категории, а агент может быстро создать объём. Ограничивайте, что ему можно отправлять, и моделируйте расходы с помощью нашего калькулятора цен WhatsApp.
  • Sender ID для SMS. Во многих странах для SMS нужно зарегистрированное имя отправителя. Агент использует имена отправителей, одобренные в вашем аккаунте.

Пример: команда поддержки добавляет помощника по статусам доставки

«Souq Rafiq» (условный пример), интернет-магазин из ОАЭ, хочет, чтобы сотрудники поддержки отвечали на вопрос «получил ли клиент наше сообщение?» без открытия дашбордов.

  • Настройка: администратор создаёт временный ключ и подключает Claude Desktop к MCP-серверу для двух руководителей поддержки.
  • Инструменты: включены только инструменты чтения отчётов. Инструменты отправки отключены.
  • Использование: руководитель спрашивает: «Сколько сообщений во вчерашней кампании с выписками не доставлено и почему?» Агент читает отчёт о доставке и обобщает причины по статусам.
  • Проверка: через две недели администратор просматривает отчёты о доставке, убеждается, что ничего не отправлялось, и запрашивает постоянный ключ для небольшого продакшен-помощника.
  • Следующий шаг: чтобы позволить помощнику повторно отправить пропущенное уведомление, команда включает один инструмент отправки с подтверждением и сначала ограничивает его группой тестовых номеров.

Когда MCP — неверный выбор?

Для всего детерминированного и высокообъёмного используйте REST API, спецификацию OpenAPI или SDK.

  • OTP и транзакционные сценарии. Код входа должен приходить из кода, который вы контролируете, а не от модели, которая может перефразировать его. См. быстрый старт REST.
  • Массовые кампании. Используйте инструменты кампаний или эндпоинты массовой отправки с проверенным файлом, а не диалоговый запрос.
  • Диалог с клиентом без присмотра. Агенту для клиентов нужен продуманный сценарий диалога, знания, передача людям и мониторинг. Это продукт ИИ-агентов, а не сессия MCP у разработчика.
  • Ограничения этого руководства. Форматы конфигурации клиентов и список инструментов меняются между версиями. Проверяйте и то и другое в документации и в своём клиенте.

Как помогает OmniChannels.ai

OmniChannels.ai предоставляет MCP-сервер по адресу https://mcp.broadnet.me/mcp наряду с REST API по адресу https://api.broadnet.me с единой моделью Bearer-токена для SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, Email и Push. BroadNet — официальный Meta Business Solution Provider, а её продукт ИИ-агентов поддерживает английский и арабский с передачей человеку-оператору и использованием инструментов через MCP; см. ИИ-агентов. Тестовый доступ ограничен вашими подтверждёнными номерами. Начните с руководства по MCP и обзора для разработчиков.

Часто задаваемые вопросы

Что такое MCP-сервер?

MCP-сервер — программа, которая предоставляет инструменты ИИ-клиентам через Model Context Protocol, открытый стандарт. Клиент подключается, перечисляет инструменты и вызывает их, когда этого требует запрос пользователя. Удалённый MCP-сервер работает на инфраструктуре провайдера, поэтому вы подключаетесь по URL и проходите аутентификацию, а не устанавливаете код.

Может ли Claude отправлять сообщения WhatsApp?

Сам по себе Claude не имеет доступа к WhatsApp, но клиент Claude с поддержкой MCP может вызывать инструменты MCP-сервера для сообщений. Если подключён MCP-сервер OmniChannels.ai, Claude Code или Claude Desktop может отправить одобренный шаблон WhatsApp или SMS из вашего аккаунта с учётом настроек инструментов и правил Meta.

Безопасно ли позволять ИИ-агенту отправлять сообщения?

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

Нужен ли шаблон WhatsApp, чтобы агент мог написать человеку?

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

Заменяет ли MCP-сервер REST API?

Нет. Инструменты сопоставлены с тем же REST API, с тем же токеном и теми же правами. Используйте MCP, когда ИИ-клиент должен сам обнаруживать и вызывать операции, а для детерминированного продакшен-кода, например сценариев OTP и уведомлений о заказах, используйте REST API, спецификацию OpenAPI или SDK.

Как получить ключ MCP?

Войдите в административный портал, откройте Integrations, затем MCP Integration и выберите Get temporary key. Постоянный ключ для продакшен-агента выдаёт администратор вашего аккаунта или главный аккаунт. Тестовый доступ ограничен вашими подтверждёнными номерами, мгновенной саморегистрации нет.

Источники

  1. Model Context Protocol specification (2025-06-18)
  2. Connect Claude Code to tools via MCP — Claude Code documentation
  3. WhatsApp Business Messaging Policy
  4. Pricing on the WhatsApp Business Platform — Meta for Developers

Читайте дальше

Ещё руководства