Servidor MCP do desenvolvedor do Google Home

O servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) do Google Home para desenvolvedores oferece às ferramentas de desenvolvimento com tecnologia de IA a capacidade de pesquisar o seguinte e recuperar informações em tempo real e específicas do domínio:

• Centro para Desenvolvedores do Google Home
• OpenThread
• Especificação do Matter: disponível para a versão 1.5.1
• Especificação do Thread: disponível para a versão 1.4.1

Ele ajuda a garantir que os agentes e ferramentas de IA possam fornecer respostas técnicas precisas relacionadas aos programas e tecnologias para desenvolvedores do Google Home.

Um servidor MCP atua como um proxy entre um serviço externo que fornece contexto ou dados e um aplicativo de IA (o host). O servidor MCP do Home para desenvolvedores expõe ferramentas executáveis que permitem que modelos de linguagem grandes (LLMs) encontrem respostas precisas diretamente de corpora indexados. Para saber mais sobre os servidores MCP, consulte O que é o MCP e como ele funciona?.

Pré-requisitos

Para usar o servidor MCP do Home para desenvolvedores, é necessário ter um cliente ou editor de IA compatível com o MCP instalado.

Google Antigravity

Se você estiver usando o ambiente de desenvolvimento de IA do Google, instale um dos seguintes:

• CLI do Antigravity: consulte o guia Introdução à CLI do Antigravity
• Antigravity 2.0: consulte a documentação do Google Antigravity
• IDE do Antigravity: consulte o guia Introdução ao IDE do Antigravity

Assistentes de IA de terceiros

Também é possível integrar o MCP com outros aplicativos de IA, ferramentas de linha de comando e editores de código, como:

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

Escolher um caminho de autenticação

Dependendo dos requisitos de integração, é possível se conectar ao servidor MCP do Home para desenvolvedores usando um caminho de teste não autenticado ou uma chave de API autenticada.

Teste de conexão não autenticado

Esse método não exige nenhuma chave de API ou configuração do Google Cloud. Ele usa uma cota pública compartilhada, o que o torna a maneira mais fácil de testar o servidor e as mecânicas principais imediatamente.

Conexão autenticada para produção

Para evitar a limitação de taxa em cotas públicas compartilhadas, recomendamos autenticar seu ambiente para um desenvolvimento sustentado.

Esse caminho exige que você tenha um projeto ativo do Google Cloud.

1. No console do Google Cloud, ative a API no seu projeto:
   1. Abra a página da API Home Developers na biblioteca de APIs do Google.
   2. Verifique se você selecionou o projeto correto em que pretende usar a API.
   3. Clique em Ativar.

2. Crie uma chave de API:

   1. Acesse a página Credenciais.
   2. Clique em Criar credenciais e selecione a chave de API no menu.
   3. No campo Nome, forneça um nome para a chave.

   4. Clique no menu suspenso Selecionar restrições de API e digite API Home Developers. Clique no resultado e em OK.

   5. Clique em Criar.

   6. Depois que a chave for criada, clique em Mostrar chave para visualizá-la e copie-a para a próxima etapa.

Configurar seu cliente

Há vários ambientes de desenvolvimento que podem se conectar ao servidor MCP do Home para desenvolvedores usando uma configuração não autenticada ou de autenticação. Consulte as instruções de cada ambiente para configurar o servidor.

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

Verificar a instalação e a execução

Depois que a configuração da ferramenta for atualizada, verifique a conexão solicitando o espaço de trabalho do agente.

Exemplo de verificação (CLI do Antigravity)

1. Inicie a sessão interativa do espaço de trabalho:

   agy
   

   

2. Execute a macro de lista de verificação de descoberta para inspecionar os servidores MCP ativos:

   /mcp
   

3. Confirme se HomeDevelopers (ou a chave de nome do servidor escolhida) aparece na lista de conexões ativas.

   

4. Faça uma pergunta ao Google Home, por exemplo:

   How do I create an Automation using Home APIs?
   

5. Se o Antigravity acreditar que a leitura da documentação para desenvolvedores do Google Home vai ajudar, ele vai solicitar permissão para usar as ferramentas search_documents do servidor MCP do Home para desenvolvedores. Selecione uma das opções Permitir para continuar.

   

6. Depois de chamar a ferramenta e pensar, o Antigravity vai responder à sua consulta com uma resposta fundamentada.

   

Tutorial em vídeo

Assista o vídeo para conferir um guia passo a passo sobre como instalar o MCP do Home para desenvolvedores.

Protocolos de teste de API HTTP direta (cURL)

Para testes de pipeline fora de um ambiente de wrapper de cliente, os payloads JSON-RPC padrão podem ser entregues em canais curl.

Descobrir ferramentas de sistema ativas

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

Executar uma consulta de pesquisa funcional

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?"
        }
    }
}'

Enviar feedback

Use nosso formulário de feedback para enviar suas ideias e sugestões sobre o MCP do Home para desenvolvedores ou como podemos melhorar sua experiência com a ferramenta.

Envie-nos seus comentários