Server MCP Google Home

   Accesso in anteprima   

Il server Model Context Protocol (MCP) di Google Home consente agli strumenti per sviluppatori e agli assistenti virtuali basati sull'AI di interagire direttamente con gli ambienti di smart home. Esponendo strumenti MCP standard e interfacce RPC, il server consente 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.

Attenzione:

Il collegamento di una casa reale a un agente AI consente all'agente di controllare i dispositivi per tuo conto. Home MCP applica limiti di frequenza e protezioni di sicurezza, ad esempio vietando azioni sensibili come l'apertura delle porte. Tuttavia, a seconda dell'agente, la connessione a Home MCP può comportare comportamenti imprevisti o persino indesiderati. 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 con Home MCP, devi informarli che l'agente può controllare i dispositivi e accedere ai dati della casa. In alternativa, puoi creare un'altra casa e configurare i dispositivi per lo sviluppo e i test.

L'accesso dell'agente alla piattaforma Home MCP può essere revocato in qualsiasi momento dalla 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 Home espone strumenti eseguibili che consentono ai client AI di eseguire query sulla telemetria della casa in tempo reale e di inviare comandi.

Funzionalità principali

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

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

Prerequisiti

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

  • Una configurazione di smart home attiva in Google Home con dispositivi connessi.
  • Un abbonamento a Google Home Premium Advanced attivo.
  • Accesso a un progetto Google Cloud.
  • Un'applicazione o un client 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'attivazione dell'API Home e la generazione delle credenziali OAuth.

Crea un progetto Google Cloud

Se non hai ancora 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 Crea progetti nella documentazione di Google Cloud.

Abilita 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 compila le informazioni sull'app e l'indirizzo email di contatto richiesti.
  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 di destinazione:
      • 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 l'applicazione:
    1. Apri Google Auth Platform > Pubblico.
    2. Nella sezione Stato della pubblicazione, fai clic su Pubblica app.

Configura il client AI

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

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

Configurazione automatica tramite un prompt

Se l'assistente AI supporta la gestione delle configurazioni degli strumenti MCP direttamente dalla chat, puoi chiedergli 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://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

Configurazione manuale

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

Antigravity

Google Antigravity offre un'integrazione integrata per i server MCP negli 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 nell'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 Impostazioni > Impostazioni avanzate > Personalizzazioni > home_mcp > Autenticazione.

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

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

Claude

Configura Claude Cowork per connetterti al tuo server MCP di casa personalizzato:

  1. Apri Connettori Claude.
  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 connetterti al trasporto SSE remoto con l'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 dei volti riconosciuti nel pannello di controllo di Home MCP, gli utenti devono acconsentire esplicitamente a questa funzionalità separatamente.

Prerequisiti

  • L'utente che concede il consenso deve essere un gestore della struttura Google Home.
  • La casa 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 attivato per ogni videocamera o campanello.
  • La tua applicazione deve avere un ID client OAuth 2.0 creato in Google Cloud. Consulta Configura il tuo 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 di consenso personalizzato con il tuo ID client OAuth 2.0 e l'ID struttura Home. Esistono due modi per ottenere il link per il consenso.

Una volta ottenuto il link, visitalo e fornisci il consenso.

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

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

  • CLIENT_ID: il tuo ID client OAuth 2.0 di Google Cloud. Ad esempio, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: il nome della struttura Home di destinazione.
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 l'agente è già connesso all'MCP Home, può individuare automaticamente l'ID struttura Home e generare un link pronto per essere selezionato.

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

  • CLIENT_ID: il tuo ID client OAuth 2.0 di 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 l'MCP di Home: "Dimmi l'ID struttura (UUID) per [Nome 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 la sessione dell'assistente AI o di Workspace.
  2. Controlla le connessioni attive al server MCP (in Antigravity, esegui /mcp o controlla gli elenchi degli strumenti).
  3. Verifica che home_mcp sia elencato con gli strumenti attivi.

  4. Invia prompt di esempio all'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 client. L'assistente AI può recuperare i dati di stato in tempo reale e tutte le risposte saranno basate sulla telemetria della tua casa.

Assistenza

Per assistenza sullo sviluppo di Home MCP, visita la community di assistenza Smart Home for Developers. Qui puoi pubblicare una domanda per ricevere assistenza o consultare le domande pubblicate in precedenza per vedere se è già stata data una risposta.

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

Problemi noti

  • Applicazione dei diritti: l'accesso alla piattaforma MCP di Home deve essere limitato agli utenti con un abbonamento Google Home Premium Advanced. Al momento, un bug consente agli abbonati a Nest Aware Plus di accedere alla piattaforma di controllo della casa. Stiamo lavorando per risolvere il problema e a breve verrà rilasciata una correzione.
  • Test dei tratti: per fornire l'insieme più ampio di funzionalità per i tuoi agenti, abbiamo incluso alcuni tratti contrassegnati come sperimentali. Potresti riscontrare scenari in cui queste caratteristiche sperimentali non funzionano come previsto. In questo caso, utilizza l'Issue Tracker pubblico per segnalarlo.
  • Latenza: a volte potresti notare una latenza più lunga del previsto con Home MCP. Stiamo lavorando attivamente alle ottimizzazioni. Prevediamo di migliorare la latenza nelle release future.

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 per le automazioni in una versione futura.