Подключите ИИ-агентов к BroadNet через MCP.

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

Model Context Protocol (MCP) — открытый стандарт, который позволяет ИИ-ассистентам находить и вызывать внешние инструменты. MCP-сервер BroadNet — удалённый сервер: ваш клиент подключается к нему по HTTPS, получает список инструментов и вызывает их от вашего имени.

Инструменты соответствуют тому же API BroadNet, что описан в справочнике API и в спецификации OpenAPI: отправка сообщений, работа с шаблонами WhatsApp, отчёты о доставке. Агент действует с правами выданного ему токена — ровно так же, как ваш собственный код.

Два MCP-сервера: справочный и для отправки сообщений

BroadNet использует два MCP-сервера. Сервер сообщений, описанный на этой странице, действует от имени вашего аккаунта. Справочный сервер публичный: агент может без входа в систему узнать у него о покрытии BroadNet, правилах Sender ID, опубликованных прейскурантных ценах, регулировании и фактах о компании.

Проверьте справочный сервер из терминала: сначала рукопожатие initialize, затем вызов инструмента.

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

Адрес и аутентификация

Для всех аккаунтов один адрес: https://mcp.broadnet.me/mcp. Каждый запрос должен передавать ваш токен BroadNet в заголовке Authorization.

Токен выдаётся в вашем аккаунте BroadNet. В демо он создаётся в портале BroadAdmin в разделе Integrations → MCP Integration кнопкой «Get temporary key»; портал поясняет, что постоянный ключ выдаёт администратор вашего аккаунта или основной аккаунт.

Запрос без этого заголовка отклоняется на уровне протокола — вот реальный ответ сервера на вызов initialize без аутентификации:

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

Подключение MCP-клиента

Большинство MCP-клиентов принимают JSON-конфигурацию с адресом сервера и заголовками запроса. Типичная запись выглядит так:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

Чтобы проверить подключение без клиента, отправьте запрос MCP initialize вручную:

curl -X POST https://mcp.broadnet.me/mcp \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

Что показывает демо

Запись команды продукта показывает весь процесс в пять шагов, в качестве MCP-клиента используется Cursor:

1. 1
   Вход

   Войдите в портал BroadAdmin под своим аккаунтом BroadNet.

2. 2
   Ключ и конфигурация

   Откройте Integrations → MCP Integration, создайте временный ключ и скопируйте готовую конфигурацию клиента.

3. 3
   Добавление сервера в клиент

   В MCP-клиенте добавьте новый MCP-сервер и вставьте конфигурацию в mcp.json — адрес https://mcp.broadnet.me/mcp с заголовком Bearer.

4. 4
   Проверка инструментов

   Клиент подключается и показывает инструменты BroadNet; каждый можно включить или выключить.

5. 5
   Запрос обычным языком

   Пользователь просит агента отправить сообщение WhatsApp на номер. Агент выбирает инструмент отправки WhatsApp, API отвечает HTTP 200 и принимает сообщение, и оно приходит в WhatsApp от бизнес-аккаунта.

На записи клиент показывает 380 инструментов BroadNet, среди них send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send и get_report_delivery. Точный список зависит от версии сервера и вашего аккаунта.

Версия той же записи с голосовым комментарием добавляет обзорный слайд: один MCP-адрес и одинаковые шаги «скопировать и вставить» для любого агента.

Рекомендации по безопасности

• Токен — это право на отправку

  Любой, у кого он есть, может отправлять сообщения от имени вашего аккаунта. Храните его как пароль и никогда — в общих файлах или в репозитории.

• Для экспериментов — временные ключи

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

• Включайте только нужные инструменты

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

• Оставляйте человека в контуре

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

• Отзывайте скомпрометированный токен

  Если токен раскрыт, обратитесь к администратору аккаунта или в поддержку BroadNet, чтобы отозвать его и выпустить новый.

См. также

Вопросы