Wavix

Wavix MCP Server

Сервер Model Context Protocol, предоставляющий LLM и AI-агентам прямой доступ к телекоммуникационной платформе Wavix — SMS/MMS, голосовые вызовы, 2FA, SIP-транкинг, управление телефонными номерами, регистрация 10DLC, записи разговоров, речевая аналитика и биллинг.

Wavix — это глобальная коммуникационная платформа для отправки SMS, совершения голосовых вызовов и выполнения 2FA-процессов через единый API. Доступен бесплатный пробный период; платное использование осуществляется в соответствии с тарифами Wavix, привязанными к вашей учетной записи.

Самый быстрый способ использовать этот MCP-сервер — размещенная конечная точка https://mcp.wavix.com/mcp — направьте на нее любой MCP-совместимый клиент и аутентифицируйтесь с помощью вашего API-ключа Wavix. Если вам необходимо самостоятельное развертывание (собственная инсталляция Wavix, за брандмауэром, выделенный экземпляр), см. Запустите свой собственный.

Содержание

• Конечная точка
• Установка — в один клик, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Запустите свой собственный (самостоятельное развертывание)
• Примеры
• Инструменты → полный каталог в TOOLS.md
• Ресурсы
• Аутентификация (лучшие практики, если токен скомпрометирован)
• Устранение неполадок
• Совместимость и ограничения
• Поддержка, Участие в разработке, Безопасность, Лицензия

Конечная точка

Поле	Значение
URL	https://mcp.wavix.com/mcp
Транспорт	Streamable HTTP
Аутентификация	Authorization: Bearer <api_key>
Инструменты	см. TOOLS.md
Ресурсы	Документация Wavix + спецификация OpenAPI (автоматически обнаруживаются)

Получите API-ключ Wavix в Консоли Wavix → Администрирование → API-ключи → Создать новый.

Установка

Перед началом работы: получите ваш API-ключ Wavix.

1. Войдите в систему по адресу https://wavix.com.
2. Откройте Администрирование → API-ключи.
3. Нажмите Создать новый (или скопируйте существующий ключ). Держите его под рукой — вы вставите его вместо YOUR_API_KEY ниже.

Установка в один клик

⚠️ Кнопки ниже заполняют конфигурацию MCP вашего редактора токеном-заполнителем YOUR_API_KEY. После завершения установки редактором откройте сгенерированную конфигурацию и замените заполнитель вашим реальным API-ключом перед отправкой любого запроса — в противном случае каждый вызов будет возвращать 401 Unauthorized.

Для последующего удаления: откройте тот же файл конфигурации (~/.cursor/mcp.json, .vscode/mcp.json или эквивалентный для вашего редактора) и удалите запись wavix или удалите коннектор через пользовательский интерфейс MCP / Коннекторы вашего редактора.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Используйте claude mcp list для проверки и /mcp внутри сессии для получения статуса.

Claude Desktop / Claude Web

Настройки → Коннекторы → Добавить пользовательский коннектор:

• Имя: Wavix
• URL: https://mcp.wavix.com/mcp
• Транспорт: Streamable HTTP
• Заголовок аутентификации: Authorization: Bearer <api_key>

Cursor (вручную)

Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json на уровне проекта):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ отображает полный каталог; более ранние версии ограничены 40 инструментами.

VS Code (вручную, GitHub Copilot Chat)

Создайте .vscode/mcp.json в вашем рабочем пространстве (или добавьте тот же объект servers под ключом "mcp" в пользовательском settings.json):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

См. руководство по MCP-серверам VS Code для актуальной схемы.

Codex CLI

Codex CLI поддерживает MCP через stdio. Подключитесь к размещенному серверу через mcp-remote. Отредактируйте ~/.codex/config.toml:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / другие клиенты

Подойдет любой MCP-клиент, поддерживающий транспорт Streamable HTTP с пользовательскими заголовками. Используйте:

• URL: https://mcp.wavix.com/mcp
• Заголовок: Authorization: Bearer <api_key>

Настройка через AI-агента? Направьте вашего агента на llms-install.md — это машиночитаемое руководство по установке, которое предоставляет модели URL, заголовок и конфигурацию для каждого клиента в детерминированном формате, чтобы она не импровизировала значения конечных точек.

Запустите свой собственный

Размещенный сервер работает «из коробки» для большинства пользователей. Разверните самостоятельно, если вам нужно указать на непубличную инсталляцию Wavix, работать за брандмауэром или в вашей собственной инфраструктуре.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Сервер слушает порт 8000 и предоставляет конечную точку MCP по адресу /mcp. Направьте ваш клиент на http://<host>:8000/mcp.

Из исходного кода

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Требуется Python 3.10+.

Конфигурация

Переменная окружения	По умолчанию	Назначение
WAVIX_API_BASE_URL	https://api.wavix.com	Переопределить вышестоящую конечную точку API Wavix (для внутренних развертываний или промежуточных сред)

Для запуска сервера учетные данные Wavix не требуются — они передаются для каждого запроса из заголовка Authorization: Bearer <api_key> MCP-клиента. При самостоятельном развертывании необходимо настроить завершение TLS перед сервером (nginx, Caddy, облачный балансировщик нагрузки) перед его публичным открытием.

Примеры

Конкретные запросы, которые можно вставить в любой подключенный клиент.

Номера телефонов ниже (+1 310 555 0100, +44 7700 900123) находятся в зарезервированных тестовых диапазонах (NANP 555 и Ofcom 070 09xx) — их можно безопасно копировать дословно, реальные абоненты по ним недоступны.

Отправка транзакционного SMS

Запрос: "Отправь SMS с +13105550100 на +447700900123 с текстом 'Ваш код подтверждения: 4821'."

Агент вызывает sms_and_mms_messages_send с from, to и text. Возвращает идентификатор сообщения и статус доставки.

Запуск 2FA-верификации

Запрос: "Отправь код 2FA-верификации на +13105550100 через SMS. Когда я дам тебе полученный код, проверь, правильный ли он."

Агент вызывает two_fa_verification_create, ждет, пока вы поделитесь кодом, пришедшим по SMS, затем вызывает two_fa_verification_check. Полезно для прототипирования процессов без пароля без написания кода интеграции.

Поиск и покупка телефонного номера

Запрос: "Найди доступный бесплатный номер США с возможностью SMS, добавь его в корзину и оформи заказ."

Агент последовательно вызывает buy_numbers_list (фильтрация по стране и функции), cart_add и cart_checkout. Подтвердите у пользователя перед оформлением заказа — это списывает средства со счета.

Поиск по транскрипциям звонков

Запрос: "Покажи все входящие звонки за вчера длительностью более двух минут, где звонящий упоминал 'возврат'."

Агент использует cdrs_search для поиска по транскрипциям, затем дополняет каждый результат через cdrs_get для получения полных метаданных звонка.

Получение записи и ее транскрибирование

Запрос: "Получи запись звонка abc-123, запроси у Wavix ее транскрибирование и верни транскрипцию."

Агент вызывает call_recording_get (возвращает предварительно подписанный URL для скачивания), cdrs_retranscribe, затем опрашивает cdrs_transcription_get.

Аудит биллинга

Запрос: "Сколько мы потратили на SMS в прошлом месяце? Дай мне ссылку для скачивания последнего счета в PDF."

Агент вызывает billing_transactions_list с фильтрацией по типу и дате, затем billing_invoices_list + billing_invoices_download. Инструмент загрузки возвращает предварительно подписанный URL на PDF, а не сам файл — откройте URL в браузере или передайте его вашему клиенту для получения фактического документа.

Инструменты

122 инструмента, сгенерированных из спецификации Wavix OpenAPI. Аргументы соответствуют параметрам запроса и полям тела.

Группа	#	Охват
SMS и MMS	10	Отправка, список, получение сообщений; идентификаторы отправителей; отказы от подписки
Управление вызовами	9	Начало / ответ / завершение вызовов; воспроизведение аудио; сбор DTMF
Запись вызовов	3	Список, скачивание (предварительно подписанный URL), удаление
Потоковая передача вызовов	2	Запуск / остановка медиапотока
Вебхуки вызовов	3	Список, создание, удаление
CDR	6	Список, экспорт, получение; поиск по транскрипции и повторное транскрибирование
Речевая аналитика	4	Загрузка, транскрибирование, получение исходного файла
2FA	6	Создание / проверка / отмена / повторная отправка верификации; события
Мои номера	7	Список, обновление, освобождение; маршрутизация SMS / голоса; загрузка документов
Покупка	5	Страны, регионы, города; поиск доступных номеров
Корзина	4	Добавление, удаление, получение, оформление заказа
Валидатор номеров	3	Одиночная и массовая проверка
SIP-транки	5	Полный CRUD
10DLC	30	Бренды, кампании, проверка, подтверждения, подписки на события
Профиль	3	Получение / обновление профиля; конфигурация аккаунта
API-ключи	5	Список, создание, активация / деактивация, удаление
Субаккаунты	5	Список, создание, получение, обновление; транзакции
Биллинг	3	Транзакции, счета, скачивание выписки
Голосовые кампании	2	Запуск и получение
Wavix Embeddable (WebRTC)	5	CRUD токенов виджетов
Сокращатель ссылок	2	Создание коротких ссылок; метрики

См. TOOLS.md для полного списка инструментов с краткими описаниями. Авторитетный источник — спецификация Wavix OpenAPI — ваш клиент всегда видит актуальный живой каталог.

Ресурсы

В дополнение к инструментам сервер предоставляет документацию Wavix в виде MCP Ресурсов, чтобы модель могла получать авторитетный контекст по требованию, а не гадать на основе предварительных знаний.

Схема URI	Содержимое
wavix://docs/<path>	Страницы документации с docs.wavix.com (автоматически обнаруживаются через llms.txt).
wavix://api/openapi.yaml	Полная спецификация Wavix OpenAPI 3.0.

Оба источника — docs.wavix.com и спецификация Wavix OpenAPI — общедоступны и могут быть просмотрены напрямую без аутентификации.

Ресурсы извлекаются лениво по resources/read и кэшируются на стороне сервера с TTL в 1 час. Вышестоящий Bearer-токен никогда не передается хостам документации — только на api.wavix.com.

Аутентификация

Каждый запрос от клиента должен включать:

Authorization: Bearer <api_key>

Сервер пересылает этот заголовок на api.wavix.com для каждого запроса. Токен:

• никогда не логируется,
• никогда не пересылается при кросс-хостовых редиректах (например, на предварительно подписанные URL для скачивания S3),
• никогда не отправляется хостам документации.

Если ваш клиент переходит по предварительно подписанному URL для скачивания, возвращенному call_recording_get, billing_invoices_download, speech_analytics_file_get или ten_dlc_brand_evidence_get, получите его напрямую без заголовка Authorization.

Лучшие практики

• Используйте выделенный API-ключ для MCP. Создайте отдельный API-ключ в https://wavix.com → Администрирование → API-ключи (или через сам инструмент api_keys_create из другого сеанса). Это позволит вам отозвать доступ MCP, не нарушая другие интеграции.

• Периодически меняйте. Относитесь к API-ключу как к любому производственному секрету: меняйте по расписанию и при любом подозрении на утечку.

• Не храните API-ключи в git. Конфигурации MCP-клиентов легко зафиксировать случайно, унеся токен с собой в историю и логи CI. Большинство клиентов поддерживают подстановку ${env:VAR} в значении заголовка — сохраните API-ключ в переменной окружения или связке ключей вашей ОС и ссылайтесь на него из конфигурации. В качестве дополнительной меры предосторожности добавьте общие пути конфигурации клиентов в .gitignore вашего проекта:

  .cursor/mcp.json
  .vscode/mcp.json
  claude_desktop_config.json
  .claude/mcp.json
  .codex/config.toml
  

Если токен скомпрометирован

1. В консоли Wavix немедленно деактивируйте ключ (или вызовите api_keys_deactivate).
2. Создайте замену через api_keys_create или консоль.
3. Обновите конфигурацию клиента и переподключитесь.
4. Проверьте billing_transactions_list и cdrs_list на предмет неожиданной активности.

Устранение неполадок

Симптом	Вероятная причина / решение
401 Unauthorized от любого инструмента	Отсутствует или недействителен заголовок Authorization: Bearer …. Проверьте, активен ли API-ключ в консоли Wavix.
Инструмент возвращает download_url, а не сам файл	Ожидаемое поведение. Эндпоинты для записей, счетов, речевой аналитики и подтверждения 10DLC возвращают предварительно подписанные URL (см. Аутентификация). Загрузите URL напрямую без заголовка Authorization.
Клиент показывает только ~40 инструментов, а не полный каталог	Старые клиенты ограничивают количество инструментов на сервер. Обновитесь (Cursor 2.4+, последние версии VS Code, Claude).
Tool not found для инструмента, перечисленного в этом README	Локальный клиент может кэшировать старый список инструментов. Перезапустите клиент или удалите и снова добавьте сервер.
4xx с массивом errors	Ошибка валидации от API Wavix. Проверьте errors; сверьтесь с соответствующей страницей wavix://docs/* или спецификацией OpenAPI.
Не удается подключиться к серверу	Проверьте DNS и исходящий HTTPS к mcp.wavix.com:443.
Агент неожиданно вызывает деструктивный инструмент	Большинство клиентов могут требовать подтверждения перед вызовом инструментов — включите эту настройку и создайте отдельный MCP API-ключ (см. Рекомендации).

Совместимость и ограничения

• Совместим с любым MCP-клиентом, поддерживающим транспорт Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, пользовательские MCP SDK), и с любым фреймворком агентов, имеющим адаптер MCP-клиента.
• Старые клиенты могут ограничивать количество инструментов на сервер; обновитесь до последней версии, чтобы получить доступ к полному каталогу.
• Ограничения скорости и плата за использование соответствуют вашему тарифному плану Wavix. См. Цены Wavix.

История изменений

Размещенный сервер обновляется непрерывно по мере развития спецификации Wavix OpenAPI; новые инструменты появляются автоматически, а существующие аргументы инструментов могут получать дополнительные поля. Изменения в документации этого репозитория отслеживаются в разделе Релизы. О существенных изменениях поведения, затрагивающих входные данные инструментов или аутентификацию, мы будем публиковать уведомления как там, так и в заметках о выпуске Wavix.

Поддержка

• Документация по продукту: https://docs.wavix.com
• Справочник API: https://docs.wavix.com/api-reference
• Вопросы / обратная связь: [email protected]

Участие в разработке

Этот репозиторий имеет доступный исходный код, но не открыт для внешних contributions. Pull-запросы автоматически закрываются, а Issues и Discussions отключены. Отправляйте отчеты об ошибках, запросы функций и отзывы на [email protected]. Подробнее см. CONTRIBUTING.md.

Если вы нашли ошибку в базовом фреймворке FastMCP, пожалуйста, сообщите о ней в upstream этого проекта.

Безопасность

Чтобы сообщить об уязвимости, напишите на [email protected] с темой Security: <short summary>, а не открывайте публичную issue. Подробнее см. SECURITY.md.

Лицензия

MIT © Wavix