Server MCP Google Home

   Accesso in anteprima   

Il server Model Context Protocol (MCP) di Google Home consente a strumenti di sviluppo e assistenti virtuali basati sull'AI di interagire direttamente con gli ambienti di smart home. Espone strumenti MCP e interfacce RPC standard, consentendo ai modelli linguistici di grandi dimensioni (LLM) di ispezionare le strutture della casa, monitorare gli stati dei dispositivi, eseguire azioni di controllo e analizzare gli eventi storici.

Avviso

Se colleghi una casa reale a un agente AI, quest'ultimo può controllare i dispositivi per tuo conto. Home MCP applica limiti di frequenza e protezioni di sicurezza, ad esempio vietando azioni sensibili come l'apertura di porte. Tuttavia, a seconda dell'agente, il collegamento a Home MCP può comportare un comportamento imprevisto o addirittura indesiderato. Esamina attentamente le norme e i termini di servizio per gli sviluppatori.

Se scegli di collegare un Google Home utilizzato da altri membri del nucleo familiare a Home MCP, devi informarli che il tuo agente può controllare i dispositivi e accedere ai dati della casa. In alternativa, puoi creare una casa aggiuntiva e configurare i dispositivi per lo sviluppo e il test.

L'accesso dell'agente a Home MCP può essere revocato in qualsiasi momento da Google Home app (GHA) o dalla pagina I miei account.

Panoramica

Un server MCP funge da proxy tra l'infrastruttura della smart home e le applicazioni AI. Il server MCP di Home espone strumenti eseguibili che consentono ai client AI di eseguire query sulla telemetria della casa in tempo reale ed emettere comandi.

Funzionalità principali

Il server MCP di Home fornisce diverse aree di funzionalità principali:

  • Rilevamento delle strutture:recupera case e strutture accessibili utilizzando list_homes.
  • Rilevamento delle risorse: elenca dispositivi, layout delle aree, tratti, attributi e schemi di comando utilizzando list_home_resources.
  • Monitoraggio dello stato:controlla lo stato di connettività del dispositivo in tempo reale e gli stati delle caratteristiche utilizzando list_home_states.
  • Controllo dei dispositivi: esegui comandi di azione parametrizzati sui dispositivi di destinazione utilizzando run_home_actions.
  • Analisi storica:esegui query su modifiche di stato ed eventi dei log passati in intervalli di tempo specifici utilizzando list_home_history.

Prerequisiti

Prima di configurare il server MCP principale, assicurati di disporre di quanto segue:

  • Una configurazione della smart home attiva in Google Home con dispositivi connessi.
  • Un abbonamento a Google Home Premium Advanced attivo.
  • Accesso a un progetto Google Cloud.
  • Un client o un'applicazione AI compatibile con MCP, come Google Antigravity, Claude Cowork o OpenClaw.

Configura il server MCP

La configurazione del server MCP richiede la creazione di un progetto Google Cloud, l'ottenimento dell'approvazione dell'accesso, l'abilitazione dell'API Home e la generazione delle credenziali OAuth.

Creare un progetto Google Cloud

Se non hai già un Google Cloud, devi crearne uno:

  1. Apri la console Google Cloud.
  2. Crea un nuovo progetto Google Cloud.

Per saperne di più, consulta l'articolo Creare progetti nella documentazione di Google Cloud.

Abilitare l'API Home

  1. Nel menu di navigazione della console Google Cloud, seleziona API e servizi > API e servizi abilitati.
  2. Cerca API Home e fai clic su Abilita.
  1. Configura la schermata per il consenso OAuth:
    1. Apri API e servizi > Schermata per il consenso OAuth.
    2. Seleziona il pubblico Esterno, fai clic su Inizia e inserisci le informazioni sull'app e l'email di contatto richieste.
  2. Crea un ID client OAuth:
    1. Apri API e servizi > Credenziali.
    2. Fai clic su + Crea credenziali e seleziona ID client OAuth.
    3. Imposta Tipo di applicazione su Applicazione web.
    4. Aggiungi gli URI di reindirizzamento autorizzati corrispondenti ai tuoi client AI target:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: URI di reindirizzamento specificato dall'installazione locale di OpenClaw
    5. Fai clic su Crea e copia l'ID client e il client secret in una posizione sicura.
  3. Pubblica la tua richiesta:
    1. Apri Google Auth Platform > Pubblico.
    2. Nella sezione Stato di pubblicazione, fai clic su Pubblica app.

Configura il client AI

Puoi configurare diversi ambienti di sviluppo AI per connetterti al server Home MCP utilizzando l'autenticazione OAuth. Inserisci qui l'ID client OAuth e il client secret, poi segui le istruzioni di configurazione che preferisci.

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

Configurazione automatica utilizzando un prompt

Se l'assistente AI supporta la gestione delle configurazioni degli strumenti MCP direttamente dalla chat, puoi chiedere all'assistente di configurare il server incollando il seguente 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

Configurazione manuale

Seleziona lo strumento di AI che preferisci per le istruzioni di configurazione manuale.

Antigravity

Google Antigravity fornisce un'integrazione integrata per i server MCP nei suoi ambienti CLI, IDE e desktop.

  1. Apri il menu di configurazione dell'applicazione: Impostazioni > Impostazioni avanzate > Personalizzazioni > Apri configurazione MCP.

  2. Aggiungi la voce home_mcp all'oggetto di configurazione mcpServers:

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

  3. Completa l'autenticazione: vai a Settings (Impostazioni) > Advanced settings (Impostazioni avanzate) > Customizations (Personalizzazioni) > home_mcp > Authentication (Autenticazione).

  4. Completa il flusso delle autorizzazioni di Google Home nel browser web, seleziona la struttura della casa e copia il codice di autorizzazione in Antigravity.

Per saperne di più, consulta la documentazione di Google Antigravity.

Claude

Configura Claude Cowork per connettersi al tuo server MCP home personalizzato:

  1. Apri Claude Connectors.
  2. Fai clic su + e seleziona Aggiungi connettore personalizzato.
  3. Inserisci l'URL del server: https://home.googleapis.com/mcp.
  4. Fai clic su Impostazioni avanzate e inserisci l'ID client e il client secret.
  5. Fai clic su Aggiungi e completa il flusso di autorizzazione OAuth nel browser.
  6. In una chat di Cowork, fai clic su + nell'angolo in basso a sinistra, seleziona Connettori e attiva home_mcp.

Per saperne di più, consulta la documentazione della piattaforma Claude.

OpenClaw

Configura OpenClaw per connettersi al trasporto SSE remoto con autenticazione OAuth:

  1. Prepara il blocco JSON della patch di configurazione:

    {
  "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. Applica la patch di configurazione nel terminale:

    openclaw config patch --stdin

  3. Riavvia il gateway OpenClaw:

    openclaw gateway restart

  4. Avvia il flusso di autenticazione:

    openclaw mcp login home_mcp

  5. Segui l'URL di autorizzazione generato per accedere e concedere l'accesso.

Per saperne di più, consulta la documentazione di OpenClaw.

Per accedere ai dati sui volti familiari nel pannello di controllo principale della casa, gli utenti devono acconsentire esplicitamente a questa funzionalità separatamente.

Prerequisiti

  • L'utente che concede il consenso deve essere un amministratore della struttura Google Home.
  • La struttura dell'utente deve avere almeno una videocamera o un campanello Google Nest compatibile e un abbonamento Google Home Premium attivo con il Rilevamento dei volti riconosciuti abilitato per ogni videocamera o campanello.
  • La tua applicazione deve avere un ID client OAuth 2.0 creato in Google Cloud. Consulta Configurare il client AI per creare un client OAuth 2.0, se non l'hai ancora fatto.

Per concedere l'accesso alla tua applicazione, devi visitare un link per il consenso personalizzato con il tuo ID client OAuth 2.0 e l'ID struttura Home. Esistono due modi per ottenere il link al consenso.

Una volta ottenuto il link, visita la pagina e fornisci il consenso.

Se il tuo agente è già connesso all'MCP della casa, può individuare automaticamente l'ID struttura Home e generare un link pronto per essere cliccato.

Aggiorna i seguenti parametri direttamente in questa pagina, quindi copia e incolla il prompt personalizzato nella chat del tuo agente.

  • CLIENT_ID: il tuo ID client OAuth 2.0 da Google Cloud. Ad esempio, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: la struttura del target 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

Se il tuo agente è già connesso all'MCP della casa, può individuare automaticamente l'ID struttura Home e generare un link pronto per essere cliccato.

Aggiorna i seguenti parametri direttamente in questa pagina, poi apri il link personalizzato in un browser web.

  • CLIENT_ID: il tuo ID client OAuth 2.0 da Google Cloud. Ad esempio, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: l'UUID della struttura Home di destinazione. Il modo più semplice per ottenerlo è chiedere all'agente utilizzando la Home MCP: "Dimmi l'ID struttura (UUID) per [nome della struttura]".
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Verifica la connessione e la funzionalità

Una volta configurato e autenticato il client, verifica la connessione al server:

  1. Avvia l'assistente AI o la sessione dello spazio di lavoro.
  2. Controlla le connessioni attive del server MCP (in Antigravity, esegui /mcp o controlla gli elenchi degli strumenti).
  3. Verifica che home_mcp sia elencato tra gli strumenti attivi.

  4. Invia prompt di esempio al tuo assistente per testare diverse funzionalità:

    • Rilevamento delle entità: How many lights do I have in my house?
    • Monitoraggio dello stato in tempo reale: Is my home secured?
    • Controllo dei dispositivi: Turn off all the outside lights.
    • Analisi degli eventi storici: What happened while I was out?

  5. Concedi le autorizzazioni di esecuzione dello strumento quando richiesto dal cliente. L'assistente AI può recuperare i dati sullo stato in tempo reale e tutte le risposte si baseranno sulla telemetria della tua casa.

Assistenza

Per assistenza allo sviluppo di MCP per la casa, visita la Community di assistenza per la smart home per gli sviluppatori. Qui puoi pubblicare una domanda per ricevere aiuto o consultare le domande pubblicate in precedenza per vedere se la tua domanda ha già ricevuto una risposta.

Per segnalare un bug o inviare una richiesta di funzionalità di MCP, vai al nostro strumento Issue Tracker pubblico.

Problemi noti

  • Test delle caratteristiche: per fornire il più ampio set di funzionalità per i tuoi agenti, abbiamo incluso alcune caratteristiche contrassegnate come sperimentali. Potresti riscontrare scenari in cui questi tratti sperimentali non funzionano come previsto. In caso affermativo, utilizza lo strumento di monitoraggio dei problemi pubblici per segnalare il problema.
  • Latenza: a volte potresti notare una latenza più lunga del previsto con Home MCP. Stiamo lavorando attivamente alle ottimizzazioni. Nei prossimi aggiornamenti vedrai miglioramenti della latenza.

Presto disponibile

  • Automazioni: la creazione e la gestione delle automazioni con Home MCP non sono supportate al momento. Stiamo lavorando a questa funzionalità e prevediamo di rilasciare il supporto delle automazioni in una release futura.