Serwer MCP Google Home

   Wcześniejszy dostęp   

Serwer Model Context Protocol (MCP) Google Home umożliwia narzędziom dla programistów opartym na AI i asystentom wirtualnym bezpośrednią interakcję ze środowiskami inteligentnego domu. Dzięki udostępnianiu standardowych narzędzi MCP i interfejsów RPC serwer umożliwia dużym modelom językowym (LLM) sprawdzanie struktur domu, monitorowanie stanów 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 egzekwuje ograniczanie liczby żądań i zabezpieczenia, takie jak zakaz wykonywania działań wrażliwych, 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 korzystania z usługi dewelopera.

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

Dostęp agenta do Home MCP można w każdej chwili unieważnić na stronie Google Home app (GHA) lub Moje konta.

Przegląd

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

Najważniejsze funkcje

Serwer Home MCP zapewnia kilka podstawowych funkcji:

  • Wykrywanie domów: pobieraj dostępne domy i struktury za pomocą metody list_homes.
  • Wykrywanie zasobów: wyświetlaj listę urządzeń, układów obszarów, cech, atrybutów i schematów poleceń za pomocą list_home_resources.
  • Monitorowanie stanu: sprawdzaj stan połączenia urządzenia i stany cech w czasie rzeczywistym za pomocą list_home_states.
  • Sterowanie urządzeniami: wykonywanie poleceń działań z parametrami na urządzeniach docelowych za pomocą run_home_actions.
  • Analiza historyczna: zapytania dotyczące wcześniejszych zmian stanu i dzienników zdarzeń w określonych zakresach czasu za pomocą list_home_history.

Wymagania wstępne

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

  • aktywną konfigurację inteligentnego domu w Google Home z połączonymi urządzeniami;
  • Aktywna subskrypcja Google Home Premium Advanced.
  • Dostęp do projektu Google Cloud.
  • klienta lub aplikację AI zgodną z MCP, np. Google Antigravity, Claude Cowork lub OpenClaw;

Konfigurowanie serwera MCP

Konfigurowanie serwera MCP wymaga utworzenia projektu Google Cloud, uzyskania zatwierdzenia dostępu, 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 konsolę Google Cloud.
  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 podaj wymagane informacje o aplikacji oraz kontaktowy adres e-mail.
  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. Jako Typ aplikacji wybierz 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 Identyfikator klienta oraz Tajny klucz klienta do bezpiecznej lokalizacji.
  3. Opublikuj aplikację:
    1. Otwórz Google Auth Platform > 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 MCP Google Home za pomocą uwierzytelniania OAuth. Wpisz tutaj identyfikator klienta OAuth i tajny klucz klienta, a następnie postępuj zgodnie z preferowanymi instrukcjami konfiguracji.

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

Konfiguracja automatyczna za pomocą prompta

Jeśli asystent AI obsługuje zarządzanie konfiguracjami narzędzi MCP bezpośrednio z poziomu czatu, możesz poprosić go o skonfigurowanie serwera, wklejając tego prompta:

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

Konfiguracja ręczna

Wybierz preferowane narzędzie AI, aby uzyskać instrukcje konfiguracji ręcznej.

Antigravity

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

  1. Otwórz menu konfiguracji aplikacji: Ustawienia > Ustawienia zaawansowane > Dostosowania > 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. Uwierzytelnij się: kliknij Ustawienia > Ustawienia zaawansowane > Dostosowania > home_mcp > Uwierzytelnianie.

  4. W przeglądarce przejdź przez 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 Oprogramowanie sprzęgające Claude.
  2. Kliknij + i wybierz Dodaj oprogramowanie sprzęgające niestandardowe.
  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 przeprowadź proces autoryzacji OAuth w przeglądarce.
  6. Na czacie Cowork kliknij + w lewym dolnym rogu, wybierz Connectors (Oprogramowanie sprzęgające) i włącz home_mcp.

Więcej informacji znajdziesz w dokumentacji platformy Claude.

OpenClaw

Skonfiguruj OpenClaw, aby połączyć się ze zdalnym transportem SSE z uwierzytelnianiem OAuth:

  1. Przygotuj blok JSON poprawki 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ą wyraźnie wyrazić zgodę na tę funkcję.

Wymagania wstępne

  • Użytkownik, który wyraża zgodę, musi być menedżerem domu Google Home.
  • Dom użytkownika musi mieć co najmniej 1 zgodną kamerę lub dzwonek Google Nest oraz aktywną subskrypcję Google Home Premium z włączoną funkcją wykrywania znajomych twarzy na każdej kamerze lub dzwonku.
  • Twoja aplikacja musi mieć identyfikator klienta OAuth 2.0 utworzony w Google Cloud. Jeśli nie masz jeszcze klienta OAuth 2.0, zapoznaj się z artykułem Konfigurowanie klienta AI, aby go utworzyć.

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

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

Jeśli Twój agent jest już połączony z Home MCP, może automatycznie znaleźć identyfikator struktury Home i wygenerować link, który wystarczy kliknąć.

Zaktualizuj te parametry bezpośrednio na tej stronie, a następnie skopiuj i wklej dostosowany prompt na czacie agenta.

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

Jeśli Twój agent jest już połączony z Home MCP, może automatycznie znaleźć identyfikator struktury Home i wygenerować link, który można kliknąć.

Zaktualizuj te parametry bezpośrednio na tej stronie, a następnie 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 docelowej struktury Home. Najłatwiejszym sposobem na uzyskanie tych informacji jest zapytanie agenta za pomocą Home MCP: „Podaj mi 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 sesję asystenta AI lub obszaru roboczego.
  2. Sprawdź aktywne połączenia z serwerem MCP (w Antigravity uruchom /mcp lub sprawdź listy narzędzi).
  3. Sprawdź, czy home_mcp jest na liście aktywnych narzędzi.

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

    • Wykrywanie encji: 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 zdarzeń historycznych: What happened while I was out?

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

Pomoc

Aby uzyskać pomoc dotyczącą programowania w Home MCP, odwiedź Forum pomocy Smart Home dla deweloperów. Możesz tam zadać pytanie, aby uzyskać pomoc, lub przejrzeć wcześniej opublikowane pytania i sprawdzić, czy ktoś już nie odpowiedział na Twoje pytanie.

Aby zgłosić błąd lub poprosić o dodanie funkcji w MCP, skorzystaj z naszego publicznego narzędzia do śledzenia błędów.

Znane problemy

  • Egzekwowanie uprawnień – dostęp do Home MCP powinien być ograniczony do użytkowników z subskrypcją Google Home Premium Advanced. Obecnie błąd umożliwia subskrybentom Nest Aware Plus dostęp do Home MCP. Pracujemy nad rozwiązaniem tego problemu i wkrótce udostępnimy poprawkę.
  • Testowanie cech – aby zapewnić jak najszerszy zestaw funkcji dla agentów, dodaliśmy kilka cech oznaczonych jako eksperymentalne. Możesz napotkać sytuacje, w których te eksperymentalne cechy nie będą działać zgodnie z oczekiwaniami. Jeśli tak, zgłoś to za pomocą publicznego narzędzia Issue Tracker.
  • Opóźnienie – czasami możesz zauważyć dłuższe niż oczekiwane opóźnienie w Home MCP. Pracujemy nad optymalizacją. W przyszłych wersjach będziemy poprawiać czas oczekiwania.

Już wkrótce

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