--- title: "Claude Code + OmniChannels.ai: создавайте и тестируйте обмен сообщениями из терминала" description: "Подключите MCP-сервер OmniChannels.ai к Claude Code для тестов отправки и чтения отчётов о доставке. Пишите код для WhatsApp и SMS по спецификации OpenAPI." canonical: "https://omnichannels.ai/ru/integrations/claude-code/" language: "ru" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Claude Code + OmniChannels.ai: создавайте и тестируйте обмен сообщениями из терминала Canonical: https://omnichannels.ai/ru/integrations/claude-code/ Language: ru Publisher: OmniChannels.ai by BroadNet Technologies **Коротко:** Claude Code подключается к OmniChannels.ai одной командой: claude mcp add --transport http с адресом https://mcp.broadnet.me/mcp и заголовком Authorization: Bearer. После этого он может отправлять тестовые сообщения, показывать список шаблонов WhatsApp и читать отчёты о доставке, а код вашей интеграции пишет по нашей спецификации OpenAPI 3.1. Команда использует общий сервер через файл .mcp.json, а правила разрешений определяют, какие инструменты запускаются без запроса подтверждения. Подключение через MCP · Подключение через API и вебхуки ## Что вы можете делать ### Пишите код по реальным шаблонам 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__ - Спецификация OpenAPI 3.1 по адресу /developers/openapi.json — для точных полей запросов - Одиночное SMS отправляется в JSON; массовые отправки и большинство отправок в других каналах используют multipart/form-data ## Настройка 1. **Запросите доступ к API:** Запросите тестовый доступ и получите токен API. Тестовые отправки идут только на ваши собственные подтверждённые номера. 2. **Получите временный ключ:** В панели администратора откройте Integrations, затем MCP Integration, выберите Get temporary key и экспортируйте его как BROADNET_TOKEN. (Руководство: https://omnichannels.ai/developers/mcp/) 3. **Добавьте сервер:** Выполните claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp с заголовком Authorization или закоммитьте .mcp.json в проект для вашей команды, затем проверьте подключение командой /mcp. (Руководство: https://omnichannels.ai/developers/mcp-claude-code/) 4. **Настройте правила разрешений:** При желании разрешите инструменты чтения, например mcp__omnichannels__get_*, оставьте для всех инструментов отправки режим запроса подтверждения и запретите инструменты, которые не нужны проекту. (Руководство: https://omnichannels.ai/developers/mcp-claude-code/) 5. **Добавьте спецификацию OpenAPI:** Скачайте openapi.yaml в свой репозиторий и поручите Claude Code использовать его для путей эндпоинтов, полей и enum-значений. (Руководство: https://omnichannels.ai/developers/openapi/) 6. **Проверьте на своём номере:** Попросите Claude Code отправить тестовое сообщение на ваш подтверждённый номер, а затем прочитать отчёт о доставке. ## Пример сценария Claude Code (Пишет вашу интеграцию и вызывает инструменты по запросу) → MCP и API OmniChannels.ai (MCP-инструменты для тестов; ваш код вызывает REST API) → Ваш тестовый телефон (Тестовое SMS или сообщение в WhatsApp на ваш подтверждённый номер) → Ваш обработчик webhook (Получает статусы доставки и входящие сообщения) ## Вопросы и ответы ### Есть ли официальный плагин OmniChannels.ai для Claude Code? Нет. Claude Code подключается через стандартную поддержку удалённых MCP-серверов, используя наш публичный эндпоинт и ваш токен API, и читает нашу публичную спецификацию OpenAPI как любой другой файл в вашем репозитории. ### Как предоставить доступ к серверу команде, не передавая ключ? Закоммитьте .mcp.json на уровне проекта, где заголовок Authorization использует ${BROADNET_TOKEN}. Каждый разработчик задаёт эту переменную в своей оболочке, а Claude Code просит подтвердить серверпроекта перед использованием. ### Может ли Claude Code отправлять сообщения без запроса? По умолчанию Claude Code спрашивает подтверждение перед использованием инструмента MCP. Сохраните это для инструментов отправки: каждая отправка — реальное сообщение, которое тарифицируется. Разрешайте в правилах только инструменты чтения и сначала проверьте названия инструментов через /mcp, так как они зависят от версии сервера и вашего аккаунта. ### Что использовать в продукте: MCP или REST API? Используйте MCP, чтобы Claude Code мог тестировать и проверять ваш аккаунт во время разработки. Код, который вы выпускаете в продакшен, должен вызывать REST API напрямую с токеном из хранилища секретов, а точные поля нужно брать из спецификации OpenAPI. ## Руководства для разработчиков - https://omnichannels.ai/developers/mcp-claude-code/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/webhooks/ - https://omnichannels.ai/developers/mcp/ ## Документация вендора - [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Claude Code permissions](https://code.claude.com/docs/en/permissions) ## Похожие интеграции - https://omnichannels.ai/ru/integrations/claude/ - https://omnichannels.ai/ru/integrations/cursor/ - https://omnichannels.ai/ru/integrations/vs-code/ - https://omnichannels.ai/ru/integrations/langchain/ Claude Code является товарным знаком своего владельца. OmniChannels.ai не связана с Claude Code и не одобрена компанией Claude Code; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков Claude Code. Обновлено: 2026-10-10