Server MCP per Google Home Developer

Il server Model Context Protocol (MCP) per sviluppatori di Google Home offre agli strumenti di sviluppo basati sull'AI la possibilità di cercare e recuperare informazioni in tempo reale e specifiche del dominio:

• Google Home Developer Center
• OpenThread
• Specifica Matter: disponibile per la versione 1.5.1

Consente di garantire che gli agenti e gli strumenti di AI possano fornire risposte tecniche accurate relative ai programmi e alla tecnologia per sviluppatori di Google Home.

Un server MCP funge da proxy tra un servizio esterno che fornisce contesto o dati e un'applicazione AI (l'host). Il server MCP per sviluppatori di Home espone strumenti eseguibili che consentono ai modelli linguistici di grandi dimensioni (LLM) di trovare risposte precise direttamente dai corpus indicizzati. Per scoprire di più sui server MCP, consulta Che cos'è l'MCP e come funziona?.

Prerequisiti

Per utilizzare il server MCP per sviluppatori di Home, devi aver installato un client AI o un editor compatibile con MCP.

Google Antigravity

Se utilizzi l'ambiente di sviluppo dell'AI di Google, installa uno dei seguenti elementi:

• Antigravity CLI: consulta la guida Introduzione ad Antigravity CLI.
• Antigravity 2.0: consulta la documentazione di Google Antigravity
• Antigravity IDE: consulta la guida Introduzione ad Antigravity IDE

Assistenti AI di terze parti

Puoi anche integrare MCP con altre applicazioni AI, strumenti a riga di comando ed editor di codice, ad esempio:

• Claude Code
• Cursore
• GitHub Copilot (VS Code)

Scegliere un percorso di autenticazione

A seconda dei requisiti di integrazione, puoi connetterti al server MCP per sviluppatori di Home utilizzando un percorso di prova non autenticato o una chiave API autenticata.

Test di connessione non autenticata

Questo metodo non richiede alcuna chiave API o configurazione di Google Cloud. Utilizza una quota pubblica condivisa, il che lo rende il modo più semplice per provare il server e testare immediatamente le meccaniche di base.

Connessione autenticata per la produzione

Per evitare la limitazione della frequenza nell'ambito delle quote pubbliche condivise, l'autenticazione del tuo ambiente è consigliata per lo sviluppo sostenuto.

Questo percorso richiede un progetto Google Cloud attivo.

1. Nella console Google Cloud, abilita l'API sul tuo progetto:
   1. Apri la pagina dell'API Home Developers nella libreria delle API di Google.
   2. Verifica di aver selezionato il progetto corretto in cui intendi utilizzare l'API.
   3. Fai clic su Abilita.

2. Crea una chiave API:

   1. Vai alla pagina Credenziali.
   2. Fai clic su Crea credenziali, quindi seleziona Chiave API dal menu.
   3. Nel campo Nome, fornisci un nome per la chiave.

   4. Fai clic sul menu a discesa Seleziona limitazioni dell'API e poi digita API Home Developers. Fai clic sul risultato e poi su Ok.

   5. Fai clic su Crea.

   6. Dopo aver creato la chiave, fai clic su Mostra chiave per visualizzarla e copiala per il passaggio successivo.

Configura il client

Esistono diversi ambienti di sviluppo che possono connettersi al server MCP di Home Developer utilizzando una configurazione non autenticata o di autenticazione. Consulta le istruzioni per ogni ambiente per configurare il server.

Enter your API key: YOUR_API_KEY

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
 "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Verifica l'installazione e l'esecuzione

Una volta aggiornata la configurazione dello strumento, verifica la connessione chiedendo al tuo workspace dell'agente.

Esempio di verifica (Antigravity CLI)

1. Avvia la sessione dello spazio di lavoro interattivo:

   agy
   

   

2. Esegui la macro dell'elenco di controllo del rilevamento per esaminare i server MCP attivi:

   /mcp
   

3. Verifica che HomeDevelopers (o la chiave del nome del server che hai scelto) venga visualizzata nell'elenco delle connessioni attive.

   

4. Fai una domanda a Google Home, ad esempio:

   How do I create an Automation using Home APIs?
   

5. Se Antigravity ritiene che la lettura della documentazione per sviluppatori di Google Home possa essere utile, richiede l'autorizzazione a utilizzare gli strumenti search_documents del server MCP per sviluppatori di Home. Seleziona una delle opzioni Consenti per continuare.

   

6. Dopo aver chiamato lo strumento e aver pensato, Antigravity risponderà alla tua query con una risposta basata su fatti reali.

   

Video tutorial

Guarda il video per una guida passo passo all'installazione di Home Developer MCP.

Protocolli di test dell'API HTTP diretta (cURL)

Per il test della pipeline al di fuori di un ambiente wrapper client, i payload JSON-RPC standard possono essere inviati tramite i canali curl.

Scopri gli strumenti di sistema attivi

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

Eseguire una query di ricerca funzionale

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

Invia feedback

Utilizza il nostro modulo di feedback per inviare i tuoi pensieri e suggerimenti in merito al programma MCP per sviluppatori di Home o su come possiamo migliorare la tua esperienza con lo strumento.

Inviaci i tuoi commenti