# Подключите ИИ-агентов к BroadNet через MCP. - Канонический URL: https://www.broadnet.me/ru/developers/mcp - Язык: ru - Последнее обновление: 2026-10-21 - Издатель: BroadNet (https://www.broadnet.me) - Markdown-версия страницы, созданная из опубликованной страницы. Model Context Protocol· /developers/mcp MCP-сервер BroadNet открывает API обмена сообщениями BroadNet в виде инструментов, которые может вызывать ИИ-агент. Укажите любому MCP-клиенту с поддержкой удалённых серверов один адрес, пройдите аутентификацию токеном BroadNet — и агент сможет отправлять и отслеживать сообщения в вашем аккаунте. **Адрес** https://mcp.broadnet.me/mcp **Транспорт** MCP Streamable HTTP **Аутентификация** Authorization: Bearer **Каналы** WhatsApp, SMS, RCS, Telegram, Push, электронная почта, Messenger, Instagram ## Что такое MCP-сервер Model Context Protocol (MCP) — открытый стандарт, который позволяет ИИ-ассистентам находить и вызывать внешние инструменты. MCP-сервер BroadNet — удалённый сервер: ваш клиент подключается к нему по HTTPS, получает список инструментов и вызывает их от вашего имени. Инструменты соответствуют тому же API BroadNet, что описан в справочнике API и в спецификации OpenAPI: отправка сообщений, работа с шаблонами WhatsApp, отчёты о доставке. Агент действует с правами выданного ему токена — ровно так же, как ваш собственный код. ## Два MCP-сервера: справочный и для отправки сообщений BroadNet использует два MCP-сервера. Сервер сообщений, описанный на этой странице, действует от имени вашего аккаунта. Справочный сервер публичный: агент может без входа в систему узнать у него о покрытии BroadNet, правилах Sender ID, опубликованных прейскурантных ценах, регулировании и фактах о компании. Справочный сервер (публичный) Ответы только для чтения на основе тех же данных, что и на этом сайте. Без аккаунта, без токена, без персональных данных. **Адрес** https://www.broadnet.me/mcp **Аутентификация** Нет **Доступ** Только чтение **Инструменты** search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status **Лимит запросов** 60 запросов в минуту с одного IP Сервер сообщений (ваш аккаунт) Отправляет и отслеживает сообщения с правами вашего токена BroadNet. **Адрес** https://mcp.broadnet.me/mcp **Аутентификация** Authorization: Bearer **Доступ** Действует от имени аккаунта Проверьте справочный сервер из терминала: сначала рукопожатие initialize, затем вызов инструмента. 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"}}}' ``` tools/call (справочный сервер) ``` 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"}}}' ``` Справочный сервер поддерживает MCP 2026-07-28 (метаданные в каждом запросе, server/discover) и более ранние ревизии с initialize вплоть до 2024-11-05. Возвращаемые цены — ориентировочные прейскурантные, а не коммерческое предложение; ответы о регулировании — рекомендации для планирования, а не юридическая консультация. ## Адрес и аутентификация Для всех аккаунтов один адрес: 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 ' header."}} ``` ## Подключение MCP-клиента Большинство MCP-клиентов принимают JSON-конфигурацию с адресом сервера и заголовками запроса. Типичная запись выглядит так: mcp.json ``` { "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } } } ``` Названия полей немного различаются от клиента к клиенту (одни ожидают type "http" или "streamable-http", другие берут заголовки из отдельной настройки). Сверьтесь с документацией MCP вашего клиента и не храните токен в файлах, которые попадают в репозиторий, — используйте переменные окружения, если клиент их поддерживает. Чтобы проверить подключение без клиента, отправьте запрос MCP initialize вручную: рукопожатие 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-адрес и одинаковые шаги «скопировать и вставить» для любого агента. Демонстрационная запись (1 мин 10 с, без звука): войдите в BroadAdmin, подключите Cursor к серверу BroadNet MCP и отправьте сообщение WhatsApp на естественном языке. Озвученная версия (1 мин 20 с, с закадровым голосом) того же процесса, с обзорной карточкой в начале. ## Рекомендации по безопасности - Токен — это право на отправку Любой, у кого он есть, может отправлять сообщения от имени вашего аккаунта. Храните его как пароль и никогда — в общих файлах или в репозитории. - Для экспериментов — временные ключи Пока вы пробуете, используйте временный ключ, а постоянный запрашивайте у администратора аккаунта только для рабочего агента. - Включайте только нужные инструменты MCP-клиенты позволяют отключать отдельные инструменты. Агенту, который только отправляет SMS, не нужны инструменты шаблонов, подключения или аккаунта. - Оставляйте человека в контуре Агенты выполняют инструкции на естественном языке. Настройте клиент так, чтобы он запрашивал подтверждение перед инструментами отправки, особенно на много адресатов. - Отзывайте скомпрометированный токен Если токен раскрыт, обратитесь к администратору аккаунта или в поддержку BroadNet, чтобы отозвать его и выпустить новый. ## См. также [Справочник API REST-методы, которые стоят за инструментами MCP, с аутентификацией Bearer.](https://www.broadnet.me/ru/developers/api) [Спецификация OpenAPI 3.1 Полное машиночитаемое описание API.](https://www.broadnet.me/developers/openapi.yaml) [Быстрый старт Отправьте первое SMS с помощью curl или TypeScript SDK.](https://www.broadnet.me/ru/developers/quickstart) [Руководство: безопасные ИИ-агенты Как агенты отправляют SMS и WhatsApp через MCP и какие ограничения нужно настроить в первую очередь.](https://www.broadnet.me/ru/blog/mcp-server-sms-whatsapp-ai-agents) ## Вопросы ### Какой адрес у MCP-сервера BroadNet? https://mcp.broadnet.me/mcp. Он использует транспорт MCP Streamable HTTP и требует заголовок Authorization: Bearer с вашим токеном BroadNet. ### Какие ИИ-клиенты могут подключиться? Любой MCP-клиент, который умеет подключаться к удалённому серверу по Streamable HTTP и передавать собственный заголовок Authorization. В демонстрационной записи используется Cursor. ### Где взять токен? В вашем аккаунте BroadNet. В портале BroadAdmin раздел Integrations → MCP Integration выдаёт временный ключ; постоянный ключ предоставляет администратор аккаунта или основной аккаунт. ### Может ли агент отправлять реальные сообщения? Да. В демонстрационной записи отправка сообщения агентом WhatsApp возвращает HTTP 200, и сообщение приходит на телефон. Инструменты работают с разрешениями вашего токена точно так же, как и ваши собственные вызовы API, поэтому рассматривайте каждую отправку как реальную: включайте только те инструменты, которые необходимы агенту, и требуйте подтверждения для отправки. ## Разрабатывайте с BroadNet Получите аккаунт и токен, затем подключите агента или вызывайте API напрямую. [Связаться с нами](https://www.broadnet.me/ru/contact) [Раздел для разработчиков](https://www.broadnet.me/ru/developers)