Коротко
Claude Code подключается к OmniChannels.ai одной командой: claude mcp add --transport http с адресом https://mcp.broadnet.me/mcp и заголовком Authorization: Bearer. После этого он может отправлять тестовые сообщения, показывать список шаблонов WhatsApp и читать отчёты о доставке, а код вашей интеграции пишет по нашей спецификации OpenAPI 3.1. Команда использует общий сервер через файл .mcp.json, а правила разрешений определяют, какие инструменты запускаются без запроса подтверждения.
Что вы можете делать
Пишите код по реальным шаблонам
Claude Code читает ваши одобренные шаблоны WhatsApp через MCP и пишет функцию с точно теми переменными, которые нужны каждому шаблону.
Попробуйте спросить
“Используй инструменты omnichannels, чтобы получить список моих одобренных шаблонов WhatsApp, а затем напиши функцию на TypeScript, которая отправляет order_update с нужными ему полями.”
Создайте обработчик webhook
Укажите Claude Code руководство по webhook, и он напишет эндпоинт, который сохраняет статусы доставки и входящие сообщения и корректно относится к полям, различающимся по каналам.
Попробуйте спросить
“Напиши обработчик webhook на Express, который записывает статусы SUBMITTED, SENT, DELIVERED, READ, FAILED и REJECTED по ID сообщения и логирует неизвестные поля, а не завершается с ошибкой.”
Сгенерируйте типизированный клиент по спецификации
Если спецификация OpenAPI сохранена в вашем репозитории, Claude Code использует точные пути и поля, а не угадывает их.
Попробуйте спросить
“На основе docs/omnichannels-openapi.yaml напиши модуль на Python, который отправляет SMS через POST /sms/sendSms, и перечисли все использованные поля с их типами из спецификации.”
Проверьте сквозной сценарий на своём номере
После вашего подтверждения вызова инструмента Claude Code отправляет тестовое сообщение, а затем проверяет отчёт о доставке, чтобы убедиться, что ваш код работает.
Попробуйте спросить
“Отправь тестовое SMS от OmniDemo на мой номер 447700900123, а затем проверь его отчёт о доставке.”
Отлаживайте неудачные отправки
Инструменты чтения позволяют Claude Code сопоставить отчёты о доставке с вашими логами и проследить сбой до запроса, который его вызвал.
Попробуйте спросить
“Прочитай отчёт о доставке вчерашней кампании, кратко опиши причины сбоев и сверь наш код повторных попыток с руководством по ошибкам.”
Как устроено подключение
Claude Code добавляет удалённые MCP-серверы командой claude mcp add --transport http с заголовком Authorization. Ваша оболочка подставляет токен из переменной окружения при запуске команды. Для команды файл .mcp.json на уровне проекта позволяет каждому разработчику передавать свой токен через ${BROADNET_TOKEN}, а Claude Code просит каждого подтвердить сервер перед использованием.
MCP нужен для действий в вашем аккаунте: отправки тестовых сообщений, чтения шаблонов и отчётов о доставке. Для написания кода интеграции дайте Claude Code нашу спецификацию OpenAPI 3.1 как источник истины по эндпоинтам и полям, а также руководство по webhook, поскольку полезная нагрузка webhook в спецификацию не входит. Правила разрешений, например mcp__omnichannels__get_*, позволяют запускать инструменты чтения без запроса, а инструменты отправки по-прежнему запрашивают подтверждение.
- Команда: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
- Настройка для команды: закоммитьте .mcp.json с Bearer ${BROADNET_TOKEN}, но никогда не сам ключ
- В правилах разрешений инструменты называются mcp__omnichannels__<tool>
- Спецификация OpenAPI 3.1 по адресу /developers/openapi.json — для точных полей запросов
- Одиночное SMS отправляется в JSON; массовые отправки и большинство отправок в других каналах используют multipart/form-data
Настройка
- 1
Запросите доступ к API
Запросите тестовый доступ и получите токен API. Тестовые отправки идут только на ваши собственные подтверждённые номера.
- 2
Получите временный ключ
В панели администратора откройте Integrations, затем MCP Integration, выберите Get temporary key и экспортируйте его как BROADNET_TOKEN.
Руководство: MCP server for AI agents - 3
Добавьте сервер
Выполните claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp с заголовком Authorization или закоммитьте .mcp.json в проект для вашей команды, затем проверьте подключение командой /mcp.
Руководство: Use the MCP server with Claude Code - 4
Настройте правила разрешений
При желании разрешите инструменты чтения, например mcp__omnichannels__get_*, оставьте для всех инструментов отправки режим запроса подтверждения и запретите инструменты, которые не нужны проекту.
Руководство: Use the MCP server with Claude Code - 5
Добавьте спецификацию OpenAPI
Скачайте openapi.yaml в свой репозиторий и поручите Claude Code использовать его для путей эндпоинтов, полей и enum-значений.
Руководство: OpenAPI 3.1 spec - 6
Проверьте на своём номере
Попросите Claude Code отправить тестовое сообщение на ваш подтверждённый номер, а затем прочитать отчёт о доставке.
Документация вендора
Claude Code является товарным знаком своего владельца. OmniChannels.ai не связана с Claude Code и не одобрена компанией Claude Code; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков Claude Code.
