mctl-alice BETA

Model Context Protocol

BETA

Голосовое управление Яндекс Станцией
и умным домом для AI-ассистентов

mctl-alice соединяет ваших AI-ассистентов (Claude, ChatGPT и другие MCP-клиенты) с умными колонками Яндекс Станция и устройствами умного дома. Произносите произвольные фразы (TTS), симулируйте голосовые команды текстом, управляйте громкостью, музыкой и сценариями.

Endpoint https://alice.mctl.ai/mcp
Подключить ассистента Войти через Яндекс

Возможности

Все ключевые сценарии взаимодействия с голосовым помощником Алиса в виде стандартных инструментов MCP.

Симуляция голосовых команд

Выполнение любых команд текстом ровно так, как если бы вы произнесли их вслух в микрофон колонки: «Включи джаз», «Какая погода завтра», «Выключи свет везде».

Произвольная речь (TTS)

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

Управление громкостью

Точная регулировка громкости от 1 до 10 для конкретной колонки, комнаты или устройства по умолчанию.

Управление медиа-плеером

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

Обнаружение умного дома

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

Сценарии автоматизации

Мгновенный триггер настроенных сценариев умного дома Яндекса по их названию или идентификатору («Доброе утро», «Ушел из дома», «Кино»).

Инструменты MCP

Набор инструментов, регистрируемых сервером mctl-alice. AI-ассистент вызывает их автоматически в диалоге.

Инструмент Назначение Параметры Действие
alice_list_devices Список всех колонок, комнат и умных устройств. only_speakers?: boolean чтение
alice_send_command Выполнение голосовой команды текстом (прямая симуляция речи). command: string, device?: string управление
alice_say_phrase Синтез произвольной речи через колонку (TTS-сообщения). phrase: string, device?: string управление
alice_set_volume Установка громкости от 1 до 10. level: number (1-10), device?: string управление
alice_media_control Управление плеером: play, pause, stop, next, prev. action: string, device?: string управление
alice_trigger_scenario Запуск сценария умного дома по названию или ID. scenario: string сценарий

Примеры запросов к ассистенту

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

Как подключить

Три простых шага для подключения к вашим любимым AI-клиентам.

  1. Шаг 1. Добавьте коннектор в вашего AI-ассистента:
    Используйте публичный эндпоинт: https://alice.mctl.ai/mcp

    • Claude.ai: перейдите в Customize → Connectors → “+” → Add custom connector, вставьте URL https://alice.mctl.ai/mcp (или SSE: https://alice.mctl.ai/sse) и нажмите Add.

    • ChatGPT: откройте Plugins (chatgpt.com/plugins), нажмите «+» и выберите добавление custom MCP-сервера, укажите URL https://alice.mctl.ai/mcp. Сервер поддерживает RFC 8414 & OAuth 2.1 — ChatGPT автоматически проведет вас через авторизацию в Яндексе.

    Другие клиенты, пошаговый сценарий и как отозвать доступ →
  2. Шаг 2. Авторизуйтесь в Яндексе (OAuth):
    При подключении через ChatGPT или Claude.ai окно авторизации Яндекса откроется автоматически. Вы также можете выполнить вход заранее на странице /auth/login. Это свяжет ваш токен управления умным домом с сессией MCP.
  3. Шаг 3 (Опционально). Настройте Quasar Cookie для динамического TTS:
    Официальный API Умного дома Яндекса управляет устройствами и запускает сценарии. Для синтеза речи (TTS) и произвольных текстовых команд подключите неофициальный Quasar API на странице /auth/cookie: он использует вашу веб-сессию Яндекса.

Частые вопросы

Безопасно ли подключать умный дом через mctl-alice?

Вход идёт через OAuth 2.1 с PKCE. Токены Яндекса хранятся зашифрованными (AES-256-GCM), а токены ИИ-клиентов — только в виде хешей. Устройствами умного дома сервис управляет через официальный API Умного дома Яндекса. Синтез речи и текстовые команды на колонках работают через Quasar — неофициальный API веб-интерфейса Яндекса. Он подключается только по вашему желанию и может перестать работать без предупреждения.

Какие модели колонок Яндекс Станция поддерживаются?

Поддерживаются все актуальные модели: Яндекс Станция Макс, Станция Миди, Станция 2, Станция Лайт, Станция Мини, Станция Дуо Макс, а также сторонние устройства с поддержкой голосового помощника Алиса.

В чем разница между IoT API и Quasar API?

API Умного дома Яндекса — официальный и документированный: он показывает устройства, их состояние и сценарии и управляет ими. Quasar — неофициальный внутренний API, которым пользуется веб-интерфейс Яндекса. Для него нужна ваша веб-сессия Яндекса, и через него работают синтез речи (TTS) и текстовые команды. Яндекс не поддерживает Quasar для сторонних сервисов, а сессия даёт доступ шире, чем OAuth, поэтому подключайте его только если вам нужны эти функции.

Можно ли управлять устройствами умного дома других брендов?

Да! Любое устройство (лампочки, розетки, реле, роботы-пылесосы, кондиционеры), привязанное к вашему умному дому в приложении «Дом с Алисой», доступно для симуляции команд и запуска через сценарии.

Больше возможностей с MCTL

Подключите другие инструменты к AI-ассистенту или разверните свои сервисы.

Telegram для AI-ассистентов

Подключите Telegram к Claude и ChatGPT через MCP, чтобы работать с чатами и сообщениями.

Платформа MCTL для разработчиков

Развёртывайте свои сервисы в Kubernetes с GitOps, секретами Vault и MCP-инструментами.

Документация платформы MCTL

Изучите настройку платформы, развёртывание сервисов и интеграции MCP.