Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

MCP-сервер Google Home

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

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

Внимание!

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

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

Вы можете в любой момент закрыть агенту доступ к Home MCP на странице Google Home app (GHA) или "Мои аккаунты".

Обзор

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

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

MCP-сервер Home предоставляет несколько основных возможностей:

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

Требования

Прежде чем настраивать MCP-сервер Home, убедитесь, что у вас есть:

Активная система умного дома в 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.

Как включить Home API

В меню навигации консоли Google Cloud выберите APIs & Services (API и сервисы) > Enabled APIs & Services (Включенные API и сервисы).
Найдите Home API и нажмите Включить.

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

Настройте окно запроса доступа OAuth:
1. Откройте APIs & Services (API и сервисы) > OAuth consent screen (Окно запроса доступа OAuth).
2. Выберите External (Внешняя), нажмите Get started (Начать) и укажите необходимую информацию о приложении и контактный адрес электронной почты.
Создайте идентификатор клиента OAuth:
1. Откройте APIs & Services (API и сервисы) > Credentials (Учетные данные).
2. Нажмите + Создать учетные данные и выберите Идентификатор клиента OAuth.
3. В поле Тип приложения выберите Веб-приложение.
4. Добавьте разрешенные URI перенаправления, соответствующие вашим целевым клиентам ИИ:
  - Google Antigravity: https://antigravity.google/oauth-callback
  - Claude Cowork: https://claude.ai/api/mcp/auth_callback
  - OpenClaw: URI перенаправления, указанный в локальной установке OpenClaw.
5. Нажмите Create (Создать) и скопируйте Client ID (Идентификатор клиента) и Client Secret (Секретный код клиента) в безопасное место.
Опубликуйте приложение.
1. Откройте Google Auth Platform > Audience (Аудитория).
2. В разделе Статус публикации нажмите Опубликовать приложение.

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

Вы можете настроить несколько сред разработки ИИ для подключения к серверу MCP Home с помощью аутентификации 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://home.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

Настройка вручную

Выберите ИИ-инструмент, чтобы посмотреть инструкции по настройке вручную.

Antigravity

В Google Antigravity есть встроенная интеграция с серверами MCP в интерфейсе командной строки, интегрированной среде разработки и на компьютере.

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

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

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

Выполните аутентификацию. Для этого перейдите в раздел Settings (Настройки) > Advanced settings (Расширенные настройки) > Customizations (Настройки) > home_mcp > Authentication (Аутентификация).
Завершите настройку разрешений Google Home в веб-браузере, выберите структуру дома и скопируйте код авторизации обратно в Antigravity.

Дополнительную информацию можно найти в документации по Google Antigravity.

Claude

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

Откройте Claude Connectors.
Нажмите + и выберите Добавить специальный коннектор.
Введите URL сервера: https://home.googleapis.com/mcp.
Нажмите Расширенные настройки и введите идентификатор клиента и секретный код клиента.
Нажмите Добавить и завершите авторизацию OAuth в браузере.
В чате Cowork нажмите + в левом нижнем углу, выберите Connectors (Коннекторы) и включите 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. Получить ссылку на форму согласия можно двумя способами.

Перейдите по ссылке и предоставьте согласие.

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

Если ваш агент уже подключен к MCP-серверу Google Home, он может автоматически найти идентификатор структуры 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

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

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

Запустите ИИ-помощника или сеанс Workspace.
Проверьте активные подключения к 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?
Предоставьте разрешения на выполнение инструмента, когда клиент запросит их. ИИ-помощник может получать данные о состоянии в реальном времени, и все ответы будут основаны на телеметрии вашего дома.

Поддержка

Если вам нужна помощь в разработке продуктов Matter Casting, посетите справочный форум для разработчиков умного дома. Там вы можете задать вопрос или поискать ответ среди уже опубликованных.

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

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

Принудительное применение прав. Доступ к домашней странице MCP должен быть ограничен пользователями с подпиской Google Home Premium Advanced. Сейчас из-за ошибки у подписчиков Nest Aware Plus есть доступ к Home MCP. Мы работаем над устранением этой проблемы и скоро выпустим исправление.
Тестирование признаков. Чтобы предоставить вашим агентам максимально широкий набор функций, мы включили некоторые признаки, помеченные как экспериментальные. Вы можете столкнуться со сценариями, в которых эти экспериментальные функции работают не так, как ожидалось. Если да, сообщите об этом в общедоступной системе отслеживания ошибок.
Задержка. Иногда вы можете заметить, что задержка в работе Home MCP больше, чем ожидалось. Мы активно работаем над оптимизацией. В будущих выпусках задержка будет уменьшена.

Скоро

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

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

warning Внимание!

Обзор

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

Требования

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

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

Как включить Home API

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

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

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

Настройка вручную

Antigravity

Claude

OpenClaw

Согласие на распознавание знакомых лиц

Требования

Ссылки на согласие

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

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

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

Поддержка

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

Скоро

MCP-сервер Google Home

Внимание!