Server MCP per Google Home Developer

Il server Model Context Protocol (MCP) di Google Home Developer consente agli strumenti di sviluppo basati sull'AI di cercare quanto segue e recuperare informazioni in tempo reale e specifiche del dominio:

• Centro sviluppatori Google Home
• OpenThread
• Specifiche Matter: disponibili per la versione 1.5.1
• Specifiche Thread: disponibili per la versione 1.4.1

In questo modo, gli agenti e gli strumenti AI possono 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 di Home Developer espone strumenti eseguibili che consentono ai modelli linguistici di grandi dimensioni (LLM) di trovare risposte precise direttamente dai corpus indicizzati. Per saperne di più sui server MCP, consulta Che cos'è l'MCP e come funziona?.

Prerequisiti

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

Google Antigravity

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

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

Assistenti AI di terze parti

Puoi anche integrare l'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 di Home Developer 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 i meccanismi di base.

Connessione autenticata per la produzione

Per evitare la limitazione di frequenza con le quote pubbliche condivise, è consigliabile autenticare l'ambiente per uno sviluppo sostenuto.

Questo percorso richiede un progetto Google Cloud attivo.

1. Nella console Google Cloud, abilita l'API nel tuo progetto:
   1. Apri la pagina Home Developers API 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, quindi digita API Home Developers. Fai clic sul risultato, quindi 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.

Configurare 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 di 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"
      }
    }
  }
}

Verificare l'installazione e l'esecuzione

Una volta aggiornata la configurazione dello strumento, verifica la connessione richiedendo l'area di lavoro dell'agente.

Esempio di verifica (Antigravity CLI)

1. Avvia la sessione interattiva dell'area di lavoro:

   agy
   

   

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

   /mcp
   

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

   

4. Poni 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 gli sviluppatori di Google Home possa essere utile, richiede l'autorizzazione a utilizzare gli strumenti search_documents del server MCP di Home Developer. Seleziona una delle opzioni Consenti per continuare.

   

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

   

Video tutorial

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

Protocolli di test delle API HTTP dirette (cURL)

Per i test della pipeline al di fuori di un ambiente di 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
}'

Esegui 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 sull'MCP di Home Developer o su come possiamo migliorare la tua esperienza con lo strumento.

Inviaci i tuoi commenti