Перейти к содержанию

Подключение MCP сервера GREEN-API WABA#

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

Данная инструкция поможет подключить MCP-сервер к Claude Desktop с использованием WABA сервиса от GREEN-API.

Вы можете подключить MCP с помощью протокола /mcp или /sse. Протокол /mcp предпочтительнее использовать для подключения.

Содержание#

Минимальные требования#

  1. Учетная запись GREEN-API – зарегистрируйтесь в личном кабинете на одном из тарифов.
  2. WABA инстанс в состоянии authorized в личном кабинете GREEN-API. Подробнее о подключении читайте в разделе Перед началом работы.
  3. Учетная запись Claude – зарегистрируйте аккаунт на платформе.
  4. Установленный Claude Desktop – скачать можно с официального сайта.

Обзор#

Данная интеграция позволяет вам:

  1. Получать WhatsApp сообщения
  2. Отправлять WhatsApp сообщения вашим клиентам — шаблонные в любое время и произвольные внутри сессионного окна
  3. Создавать, редактировать и удалять шаблоны сообщений
  4. Использовать методы WhatsApp Business API от GREEN-API

Пошаговая настройка подключения#

Данный способ подключения реализован через настроенный сервер GREEN-API с использованием OAuth аутентификации по номеру инстанса. Этот метод не требует установки дополнительных пакетов на локальную машину — сервер уже развёрнут и доступен по адресу mcp-waba.green-api.com.

Шаг 1: Добавление кастомного MCP сервера в Claude Desktop#

  1. Запустите приложение Claude Desktop
  2. Откройте настройки: Customize → Connectors
  3. Нажмите на значок + Add connector

add

  • Имя сервера: GREEN-API WABA (или любое другое понятное имя, например GREEN-API MCP WABA Server)
  • URL сервера: https://mcp-waba.green-api.com/mcp
  • Advanced settings: номер инстанса (Минимум нужно ввести один символ, но каждый раз для начала авторизации придётся вводить номер инстанса вручную)
  • OAuth Client Secret: (При настройке соединения рекомендуем оставлять это поле пустым, позже при авторизации в него записывать токен вашего инстанса)

Шаг 2: Подключение аккаунта к MCP серверу#

На вкладке Connectors выберите вкладку GREEN-API WABA и нажмите на кнопку Connect.

Если вы не указали API Token, то в браузере откроется окно авторизации с подсказкой.

login

Вставьте Instance ID и API Token вашего WABA инстанса из личного кабинета GREEN-API

sucess

Дополнительная настройка ограничений

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

restricts

Шаг 3: Проверка подключения#

Создайте новый чат с вашим ИИ агентом. В поле запроса спросите фразу вроде Состояние моего WABA инстанса.

ИИ может спросить вас о дополнительных разрешениях, а затем выведет фразу вроде Ваш инстанс в состоянии ✅ authorized — авторизован и работает нормально!.

Поздравляем, ваш MCP сервер работает нормально.

Отправка сообщения#

В WABA произвольное сообщение можно отправить только внутри 24-часового сессионного окна, которое открывается последним входящим сообщением клиента. Чтобы первым начать диалог, используйте одобренный шаблон сообщения.

С помощью MCP сервера легко можно отправить шаблонное сообщение на WhatsApp номер, для этого напишите фразу вида:

Покажи мои одобренные шаблоны и отправь шаблон order_status клиенту +71234567891 с параметром "заказ №123 отправлен".

Если клиент написал вам в течение последних 24 часов, можно ответить ему произвольным текстом:

Ответь клиенту +71234567891: Здравствуйте! Ваш заказ уже в пути.

Лицензия#

Лицензировано на условиях MIT.

Заключение#

Из данной статьи вы узнали как легко и просто подключить MCP сервер от GREEN-API для работы с WhatsApp Business API в вашем Claude.