Эта страница переведена с помощью Cloud Translation API.

Сервер Google Home MCP

Ранний доступ

Сервер Google Home Model Context Protocol (MCP) позволяет инструментам разработки на основе искусственного интеллекта и виртуальным помощникам напрямую взаимодействовать с системами умного дома. Предоставляя доступ к стандартным инструментам MCP и интерфейсам RPC, сервер позволяет большим языковым моделям (LLM) проверять структуру дома, отслеживать состояние устройств, выполнять действия управления и анализировать историю событий.

! Внимание!
Подключение реального дома к ИИ-агенту позволяет этому агенту управлять устройствами от вашего имени. Home MCP устанавливает ограничения на количество запросов и обеспечивает защиту, например, запрещает выполнение конфиденциальных действий, таких как разблокировка дверей. Однако, в зависимости от вашего агента, подключение его к Home MCP может привести к неожиданному или даже нежелательному поведению. Внимательно изучите политику разработчика и условия предоставления услуг .
Если вы решите подключить устройство Google Home, используемое другими членами семьи, к Home MCP, вам следует сообщить им, что ваш агент может управлять устройствами и получать доступ к данным домашней сети. В качестве альтернативы вы можете создать дополнительную домашнюю сеть и настроить устройства для разработки и тестирования.
Доступ вашего агента к Home MCP может быть отозван в любое время через Google Home app (GHA) или на странице «Мои учетные записи».

Обзор

Сервер MCP выступает в качестве посредника между инфраструктурой умного дома и приложениями искусственного интеллекта. Сервер Home MCP предоставляет исполняемые инструменты, позволяющие клиентам ИИ запрашивать телеметрию умного дома в режиме реального времени и отдавать команды.

Основные возможности

Сервер Home MCP предоставляет ряд основных функциональных возможностей:

Обнаружение структур: Получение доступных домов и строений с помощью list_homes .
Обнаружение ресурсов: отображение списка устройств, схем расположения, характеристик, атрибутов и схем команд с помощью list_home_resources .
Мониторинг состояния: Проверяйте состояние подключения устройства в режиме реального времени и состояния его характеристик с помощью list_home_states .
Управление устройствами: Выполнение параметризованных команд действий на целевых устройствах с помощью run_home_actions .
Исторический анализ: Запрос изменений состояния и журналов событий за определенные временные диапазоны с помощью list_home_history .

Предварительные требования

Перед настройкой сервера Home MCP убедитесь, что у вас есть следующее:

Активная система «умного дома» в Google Home с подключенными устройствами.
Действующая подписка Google Home Premium Advanced .
Доступ к проекту Google Cloud .
Совместимый с MCP клиент или приложение для искусственного интеллекта, например, Google Antigravity, Claude Cowork или OpenClaw.

Настройте сервер MCP.

Для настройки сервера MCP необходимо создать проект Google Cloud , получить разрешение на доступ, включить Home API и сгенерировать учетные данные OAuth.

Создайте проект в Google Cloud.

Если у вас еще нет учетной записи Google Cloud , вам необходимо ее создать:

Откройте консоль Google Cloud .
Создайте новый проект Google Cloud .

Для получения более подробной информации см. статью «Создание проектов» в документации Google Cloud .

Включите API Home

В меню навигации консоли Google Cloud выберите API и сервисы > Включенные API и сервисы .
Найдите Home API и нажмите «Включить» .

Настройте согласие и учетные данные OAuth.

Настройте экран подтверждения OAuth:
1. Открыть API и сервисы > Экран согласия OAuth .
2. Выберите «Внешняя аудитория», нажмите «Начать» и заполните необходимую информацию о приложении и контактный адрес электронной почты.
Создайте идентификатор клиента OAuth:
1. Открыть API и сервисы > Учетные данные .
2. Нажмите «+ Создать учетные данные» и выберите идентификатор клиента OAuth .
3. Установите тип приложения на «Веб-приложение» .
4. Добавьте авторизованные URI перенаправления, соответствующие вашим целевым клиентам ИИ:
  - Google Antigravity: https://antigravity.google/oauth-callback
  - Клод Коворк: https://claude.ai/api/mcp/auth_callback
  - OpenClaw: URI перенаправления, указанный вашей локальной установкой OpenClaw.
5. Нажмите «Создать» и скопируйте свой идентификатор клиента (Client ID ) и секретный ключ клиента (Client Secret ) в безопасное место.
Опубликуйте свое приложение:
1. Откройте Google Auth Platform > Аудитория .
2. В разделе «Статус публикации» нажмите «Опубликовать приложение» .

Настройте свой ИИ-клиент

Вы можете настроить несколько сред разработки ИИ для подключения к серверу Home MCP с использованием аутентификации OAuth. Введите здесь свой идентификатор клиента OAuth и секретный ключ клиента, а затем следуйте инструкциям по настройке.

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

Автоматическая настройка с помощью подсказки.

Если ваш ИИ-помощник поддерживает управление конфигурациями инструментов MCP непосредственно из чата, вы можете поручить ему настроить сервер, вставив следующую подсказку:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://preprod-home.sandbox.googleapis.com/mcp
- Transport: sse
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

Ручная настройка

Выберите предпочитаемый инструмент ИИ для получения инструкций по ручной настройке.

Антигравитация

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

Откройте меню конфигурации приложения: Настройки > Расширенные настройки > Настройки > Открыть MCP Config .

Добавьте запись home_mcp в объект конфигурации mcpServers :

{
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Полная аутентификация: перейдите в Настройки > Расширенные настройки > Настройки > home_mcp > Аутентификация .
Пройдите процедуру получения разрешений Google Home в веб-браузере, выберите структуру своего дома и скопируйте код авторизации обратно в Antigravity.

Для получения более подробной информации см. документацию Google Antigravity .

Клод

Настройте Claude Cowork для подключения к вашему собственному домашнему серверу MCP:

Откройте коннекторы Клода .
Нажмите + и выберите «Добавить пользовательский коннектор» .
Введите URL-адрес сервера: https://home.googleapis.com/mcp .
Нажмите «Расширенные настройки» и введите свой идентификатор клиента (Client ID) и секретный ключ клиента (Client Secret ).
Нажмите «Добавить» и завершите процесс авторизации OAuth в своем браузере.
В чате Cowork нажмите кнопку «+» в левом нижнем углу, выберите «Коннекторы » и включите параметр home_mcp .

Для получения более подробной информации см. документацию по платформе Claude .

OpenClaw

Настройте OpenClaw для подключения к удаленному транспортному каналу SSE с использованием аутентификации OAuth:

Подготовьте JSON-блок конфигурационного патча:

{
  "mcp": {
    "servers": {
      "home_mcp": {
        "url": "https://home.googleapis.com/mcp",
        "transport": "sse",
        "auth": "oauth",
        "oauth": {
          "scope": "https://www.googleapis.com/auth/home.platform.v2",
          "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
        },
        "env": {
          "CLIENT_ID": "YOUR_CLIENT_ID",
          "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
        }
      }
    }
  }
}

Примените патч конфигурации в терминале:
```
openclaw config patch --stdin
```
Перезапустите шлюз OpenClaw:
```
openclaw gateway restart
```
Запустите процесс аутентификации:
```
openclaw mcp login home_mcp
```
Перейдите по сгенерированному URL-адресу авторизации, чтобы войти в систему и предоставить доступ.

Для получения более подробной информации см. документацию OpenClaw .

Согласие на использование знакомого лица

Для доступа к данным о знакомых лицах в панели управления Home MCP пользователям необходимо отдельно дать явное согласие на использование этой функции.

Предварительные требования

Пользователь, дающий согласие, должен быть администратором структуры Google Home .
В пользовательской системе должна быть как минимум одна совместимая камера или дверной звонок Google Nest , а также активная подписка Google Home Premium с включенной функцией распознавания знакомых лиц для каждой камеры или дверного звонка .
Для работы вашего приложения необходимо создать идентификатор клиента OAuth 2.0 в Google Cloud . См. раздел «Настройка клиента ИИ для создания клиента OAuth 2.0», если вы еще этого не сделали.

Ссылки для согласия

Для предоставления доступа вашему приложению необходимо перейти по ссылке согласия, персонализированной с использованием вашего идентификатора клиента OAuth 2.0 и идентификатора Home структуры. Получить ссылку согласия можно двумя способами.

Получив ссылку, перейдите по ней и дайте согласие.

Агент создает ссылку

Если ваш агент уже подключен к Home MCP, он сможет автоматически определить идентификатор вашей структуры Home и сгенерировать готовую к использованию ссылку.

Обновите следующие параметры непосредственно на этой странице, затем скопируйте и вставьте настроенный запрос в чат вашего агента.

CLIENT_ID — Ваш идентификатор клиента OAuth 2.0 из Google Cloud . Например, `123456789-xyz.apps.googleusercontent.com`.
STRUCTURE_NAME — Название целевой структуры Home .

Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

Вы создаёте ссылку

Обновите следующие параметры непосредственно на этой странице, затем откройте настроенную ссылку в веб-браузере.

CLIENT_ID — Ваш идентификатор клиента OAuth 2.0 из Google Cloud . Например, `123456789-xyz.apps.googleusercontent.com`.
STRUCTURE_ID — UUID целевой структуры Home . Самый простой способ получить его — спросить у своего агента в панели управления Home MCP: «Сообщите мне идентификатор структуры (UUID) для [Название структуры]».

https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Проверьте подключение и работоспособность.

После настройки и аутентификации клиента проверьте подключение к серверу:

Запустите своего ИИ-помощника или рабочую сессию.
Проверьте активные подключения к MCP-серверу (в Antigravity выполните команду /mcp или проверьте списки инструментов).
Убедитесь, что home_mcp указан в списке активных инструментов.
Отправьте своему ассистенту несколько тестовых запросов, чтобы проверить различные возможности:
- Обнаружение сущностей: How many lights do I have in my house?
- Мониторинг состояния в режиме реального времени: Is my home secured?
- Управление устройством: Turn off all the outside lights.
- Анализ исторических событий: What happened while I was out?
Предоставляйте пользователю разрешения на выполнение инструментов по его запросу. Искусственный интеллект сможет получать данные о состоянии в реальном времени, и все ответы будут основаны на телеметрии вашего дома.

Поддерживать

Для получения поддержки по разработке Home MCP перейдите в сообщество Smart Home for Developers Help Community. Там вы можете задать вопрос и получить помощь, или просмотреть ранее заданные вопросы, чтобы узнать, был ли ваш вопрос уже отвечен.

Чтобы сообщить об ошибке в MCP или запросить добавление новой функции, перейдите в наш общедоступный трекер проблем .

Известные проблемы

Тестирование характеристик — Чтобы обеспечить максимально широкий набор функций для ваших агентов, мы включили некоторые характеристики, помеченные как экспериментальные. Вы можете столкнуться со сценариями, когда эти экспериментальные характеристики работают не так, как ожидается. В этом случае, пожалуйста, используйте общедоступный трекер проблем для сообщения об ошибке.
Задержка — Иногда при использовании Home MCP может наблюдаться задержка, превышающая ожидаемую. Мы активно работаем над оптимизацией. Ожидайте улучшения задержки в будущих релизах.

Вскоре

Автоматизация — Создание и управление автоматизацией с помощью Home MCP в настоящее время не поддерживается. Мы работаем над этой функцией и планируем добавить поддержку автоматизации в одном из будущих релизов.

Сервер Google Home MCP Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

warning ! Внимание!

Обзор

Основные возможности

Предварительные требования

Настройте сервер MCP.

Создайте проект в Google Cloud.

Включите API Home

Настройте согласие и учетные данные OAuth.

Настройте свой ИИ-клиент

Автоматическая настройка с помощью подсказки.

Ручная настройка

Антигравитация

Клод

OpenClaw

Согласие на использование знакомого лица

Предварительные требования

Ссылки для согласия

Агент создает ссылку

Вы создаёте ссылку

Проверьте подключение и работоспособность.

Поддерживать

Известные проблемы

Вскоре

Сервер Google Home MCP

! Внимание!