Serwer MCP Google Home

   Wcześniejszy dostęp   

Serwer Model Context Protocol (MCP) Google Home umożliwia narzędziom deweloperskim opartym na AI i wirtualnym asystentom bezpośrednią interakcję ze środowiskami inteligentnego domu. Udostępniając standardowe narzędzia MCP i interfejsy RPC, serwer umożliwia dużym modelom językowym (LLM) sprawdzanie struktury domu, monitorowanie stanu urządzeń, wykonywanie działań kontrolnych i analizowanie zdarzeń historycznych.

Ostrzeżenie!

Połączenie prawdziwego domu z agentem AI umożliwia mu sterowanie urządzeniami w Twoim imieniu. Home MCP wymusza limity szybkości i zabezpieczenia, takie jak zakaz wykonywania działań wymagających zachowania ostrożności, np. odblokowywania drzwi. Jednak w zależności od agenta połączenie go z Home MCP może spowodować nieoczekiwane lub nawet niepożądane działanie. Dokładnie zapoznaj się z zasadami i warunkami usługi dla deweloperów.

Jeśli zdecydujesz się połączyć z Home MCP urządzenie Google Home używane przez innych domowników, poinformuj ich, że Twój agent może sterować urządzeniami i uzyskiwać dostęp do danych domowych. Możesz też utworzyć dodatkowy dom i skonfigurować urządzenia do programowania i testowania.

Dostęp agenta do Home MCP można cofnąć w dowolnym momencie na stronie Google Home app (GHA) lub na stronie Moje konta.

Przegląd

Serwer MCP działa jako serwer proxy między infrastrukturą inteligentnego domu a aplikacjami AI. Serwer MCP w domu udostępnia narzędzia wykonywalne, które umożliwiają klientom AI wysyłanie zapytań o telemetrię domową w czasie rzeczywistym i wydawanie poleceń.

Główne możliwości

Serwer MCP w domu zapewnia kilka podstawowych funkcji:

  • Odkrywanie struktur: pobieranie dostępnych domów i budynków za pomocą list_homes.
  • Wykrywanie zasobów: wyświetlaj listę urządzeń, układów pomieszczeń, cech, atrybutów i schematów poleceń za pomocą list_home_resources.
  • Monitorowanie stanu: sprawdzaj w czasie rzeczywistym stan połączenia urządzenia i stany cech za pomocą list_home_states.
  • Sterowanie urządzeniami: wykonywanie sparametryzowanych poleceń działań na urządzeniach docelowych za pomocą run_home_actions.
  • Analiza historyczna: wysyłaj zapytania o zmiany stanu i dzienniki zdarzeń z określonych zakresów czasu za pomocą funkcji list_home_history.

Wymagania wstępne

Zanim skonfigurujesz domowy serwer MCP, upewnij się, że masz:

  • aktywna konfiguracja inteligentnego domu w Google Home z połączonymi urządzeniami;
  • aktywną subskrypcję Google Home Premium Advanced;
  • Dostęp do Google Cloud projektu.
  • Klient lub aplikacja AI zgodna z MCP, np. Google Antigravity, Claude Cowork lub OpenClaw.

Konfigurowanie serwera MCP

Skonfigurowanie serwera MCP wymaga utworzenia Google Cloud projektu, uzyskania zgody na dostęp, włączenia interfejsu Home API i wygenerowania danych logowania OAuth.

Tworzenie projektu Google Cloud

Jeśli nie masz jeszcze Google Cloud, musisz je utworzyć:

  1. Otwórz Google Cloudkonsolę.
  2. Utwórz nowy projekt Google Cloud.

Więcej informacji znajdziesz w artykule Tworzenie projektów w dokumentacji Google Cloud.

Włączanie interfejsu Home API

  1. W menu nawigacyjnym konsoli Google Cloud kliknij Interfejsy API i usługi > Włączone interfejsy API i usługi.
  2. Wyszukaj Home API i kliknij Włącz.
  1. Skonfiguruj ekran zgody OAuth:
    1. Otwórz Interfejsy API i usługi > Ekran zgody OAuth.
    2. Wybierz odbiorców zewnętrznych, kliknij Rozpocznij i wypełnij wymagane informacje o aplikacji oraz adres e-mail do kontaktu.
  2. Utwórz identyfikator klienta OAuth:
    1. Otwórz Interfejsy API i usługi > Dane logowania.
    2. Kliknij + Utwórz dane logowania i wybierz Identyfikator klienta OAuth.
    3. Ustaw Typ aplikacji na Aplikacja internetowa.
    4. Dodaj autoryzowane identyfikatory URI przekierowania odpowiadające docelowym klientom AI:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: identyfikator URI przekierowania określony przez lokalną instalację OpenClaw.
    5. Kliknij Utwórz i skopiuj wartości Client ID (Identyfikator klienta) i Client Secret (Tajny klucz klienta) do bezpiecznej lokalizacji.
  3. Opublikuj aplikację:
    1. Otwórz Platformę uwierzytelniania Google > Odbiorcy.
    2. W sekcji Stan publikacji kliknij Opublikuj aplikację.

Konfigurowanie klienta AI

Możesz skonfigurować kilka środowisk programistycznych AI, aby łączyły się z serwerem Home MCP za pomocą uwierzytelniania OAuth. Wpisz tutaj identyfikator klienta OAuth i tajny klucz klienta, a potem postępuj zgodnie z instrukcjami konfiguracji.

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

Automatyczna konfiguracja za pomocą prompta

Jeśli Twój asystent AI obsługuje zarządzanie konfiguracjami narzędzi MCP bezpośrednio na czacie, możesz poprosić go o skonfigurowanie serwera, wklejając ten prompt:

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

Konfiguracja ręczna

Wybierz preferowane narzędzie AI, aby wyświetlić instrukcje konfiguracji ręcznej.

Antigravity

Google Antigravity zapewnia wbudowaną integrację z serwerami MCP w środowiskach CLI, IDE i desktopowych.

  1. Otwórz menu konfiguracji aplikacji: Ustawienia > Ustawienia zaawansowane > Dostosowywanie > Otwórz konfigurację MCP.

  2. Dodaj wpis home_mcp w obiekcie konfiguracji mcpServers:

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

  3. Dokończ uwierzytelnianie: kliknij Ustawienia > Ustawienia zaawansowane > Dostosowywanie > home_mcp > Uwierzytelnianie.

  4. W przeglądarce internetowej przejdź proces przyznawania uprawnień Google Home, wybierz strukturę domu i skopiuj kod autoryzacji z powrotem do Antigravity.

Więcej informacji znajdziesz w dokumentacji Google Antigravity.

Claude

Skonfiguruj Claude Cowork, aby połączyć się z niestandardowym domowym serwerem MCP:

  1. Otwórz Claude Connectors.
  2. Kliknij + i wybierz Dodaj niestandardowe oprogramowanie sprzęgające.
  3. Wpisz adres URL serwera:https://home.googleapis.com/mcp.
  4. Kliknij Ustawienia zaawansowane i wpisz identyfikator klienta oraz tajny klucz klienta.
  5. Kliknij Dodaj i przejdź proces autoryzacji OAuth w przeglądarce.
  6. Na czacie Cowork kliknij + w lewym dolnym rogu, wybierz Łączniki i włącz home_mcp.

Więcej informacji znajdziesz w dokumentacji platformy Claude.

OpenClaw

Skonfiguruj OpenClaw, aby łączyć się ze zdalnym transportem SSE za pomocą uwierzytelniania OAuth:

  1. Przygotuj blok JSON z łatką konfiguracji:

    {
  "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"
        }
      }
    }
  }
}

  2. Zastosuj poprawkę konfiguracji w terminalu:

    openclaw config patch --stdin

  3. Ponownie uruchom bramę OpenClaw:

    openclaw gateway restart

  4. Rozpocznij proces uwierzytelniania:

    openclaw mcp login home_mcp

  5. Otwórz wygenerowany adres URL autoryzacji, aby się zalogować i przyznać dostęp.

Więcej informacji znajdziesz w dokumentacji OpenClaw.

Aby uzyskać dostęp do danych o znajomych twarzach w Home MCP, użytkownicy muszą oddzielnie wyrazić zgodę na korzystanie z tej funkcji.

Wymagania wstępne

  • Użytkownik, który wyraża zgodę, musi być menedżerem Google Homestruktury.
  • W strukturze użytkownika musi być co najmniej 1 zgodnaGoogle Nest kamera lub dzwonek do drzwi oraz aktywnaGoogle Home Premium subskrypcja z włączoną funkcją wykrywania znanych twarzy w przypadku każdej kamery lub dzwonka do drzwi.
  • W Google Cloud musisz utworzyć identyfikator klienta OAuth 2.0 dla swojej aplikacji. Jeśli nie masz jeszcze klienta OAuth 2.0, zapoznaj się z artykułem Konfigurowanie klienta AI.

Aby przyznać aplikacji dostęp, musisz otworzyć link do zgody spersonalizowany za pomocą identyfikatora klienta OAuth 2.0 i Home identyfikatora struktury. Link do uzyskiwania zgody możesz uzyskać na 2 sposoby.

Gdy uzyskasz link, otwórz go i wyraź zgodę.

Jeśli Twój agent jest już połączony z serwerem MCP w domu, może automatycznie znaleźć identyfikator struktury Home i wygenerować gotowy do kliknięcia link.

Zaktualizuj te parametry bezpośrednio na tej stronie, a potem skopiuj i wklej dostosowany prompt na czacie z agentem.

  • CLIENT_ID – identyfikator klienta OAuth 2.0 z Google Cloud. Na przykład: `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME – nazwa struktury Home docelowej.
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

Jeśli Twój agent jest już połączony z serwerem MCP w domu, może automatycznie znaleźć identyfikator struktury Home i wygenerować gotowy do kliknięcia link.

Zaktualizuj te parametry bezpośrednio na tej stronie, a potem otwórz dostosowany link w przeglądarce.

  • CLIENT_ID – identyfikator klienta OAuth 2.0 z Google Cloud. Na przykład: `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID – identyfikator UUID struktury docelowej Home. Najłatwiej jest uzyskać ten identyfikator, pytając agenta w ramach Home MCP: „Tell me the structure ID (UUID) for [Structure Name]” (Podaj identyfikator struktury (UUID) dla [nazwa struktury]).
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Sprawdzanie połączenia i funkcjonalności

Po skonfigurowaniu i uwierzytelnieniu klienta sprawdź połączenie z serwerem:

  1. Uruchom asystenta AI lub sesję Workspace.
  2. Sprawdź aktywne połączenia z serwerem MCP (w Antigravity uruchom /mcp lub sprawdź listy narzędzi).
  3. Sprawdź, czy home_mcp znajduje się na liście aktywnych narzędzi.

  4. Wydaj asystentowi przykładowe prompty, aby przetestować różne funkcje:

    • Odkrywanie podmiotów: How many lights do I have in my house?
    • Monitorowanie stanu w czasie rzeczywistym: Is my home secured?
    • Sterowanie urządzeniem: Turn off all the outside lights.
    • Analiza wydarzeń historycznych: What happened while I was out?

  5. Przyznawaj uprawnienia do wykonywania narzędzi, gdy klient o to poprosi. Asystent AI może pobierać dane o stanie w czasie rzeczywistym, a wszystkie odpowiedzi będą oparte na telemetrii Twojego domu.

Pomoc

Jeśli potrzebujesz pomocy w zakresie tworzenia MCP dla domu, odwiedź Forum pomocy dotyczącego inteligentnego domu dla deweloperów. Możesz tam zadać pytanie, aby uzyskać pomoc, lub przejrzeć wcześniej opublikowane pytania i sprawdzić, czy Twoje pytanie nie zostało już udzielone.

Aby zgłosić błąd lub przesłać prośbę o dodanie funkcji w przypadku MCP, otwórz nasze publiczne narzędzie do śledzenia błędów.

Znane problemy

  • Testowanie cech – aby zapewnić agentom jak najszerszy zakres funkcji, uwzględniliśmy niektóre cechy oznaczone jako eksperymentalne. Możesz napotkać sytuacje, w których te eksperymentalne cechy nie działają zgodnie z oczekiwaniami. Jeśli tak, zgłoś to w publicznym narzędziu do śledzenia problemów.
  • Opóźnienie – czasami możesz zauważyć dłuższe niż oczekiwane opóźnienie w przypadku Home MCP. Pracujemy nad optymalizacjami. W kolejnych wersjach będziemy wprowadzać ulepszenia w zakresie opóźnień.

Już wkrótce

  • Automatyzacja – tworzenie automatyzacji i zarządzanie nimi za pomocą Home MCP nie jest obecnie obsługiwane. Pracujemy nad tą funkcją i planujemy wprowadzić obsługę automatyzacji w przyszłej wersji.