Servidor MCP do desenvolvedor do Google Home

O servidor do Protocolo de Contexto de Modelo (MCP) do Google Home para desenvolvedores permite que ferramentas de desenvolvimento com tecnologia de IA pesquisem e recuperem informações em tempo real e específicas do domínio sobre:

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

Isso ajuda a garantir que os agentes e as ferramentas de IA possam fornecer respostas técnicas precisas relacionadas aos programas e à tecnologia 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 Developer expõe ferramentas executáveis que permitem que modelos de linguagem grandes (LLMs) encontrem respostas precisas diretamente de corpus 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 Developer, é 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 itens:

• CLI do Antigravity: consulte o guia Primeiros passos com a 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 a 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 Developer usando um caminho de teste não autenticado ou uma chave de API autenticada.

Teste de conexão não autenticada

Esse método não exige chave de API nem 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 principais mecânicas imediatamente.

Conexão autenticada para produção

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

Para fazer este programa, você precisa ter 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 "Chave de API" no menu.
   3. No campo Nome, digite 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 conferir e copie para a próxima etapa.

Configurar o cliente

Há vários ambientes de desenvolvimento que podem se conectar ao servidor MCP do Home Developer 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 seu espaço de trabalho do agente.

Exemplo de verificação (CLI do Antigravity)

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

   agy
   

   

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

   /mcp
   

3. Confirme se HomeDevelopers (ou a chave do 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 a Antigravity acreditar que a leitura da documentação para desenvolvedores do Google Home vai ajudar, ela vai pedir permissão para usar as ferramentas search_documents do servidor MCP para desenvolvedores do Home. Selecione uma das opções de Permitir para continuar.

   

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

   

Tutorial em vídeo

Assista o vídeo para conferir um guia explicativo sobre como instalar o MCP do Home Developer.

Protocolos de teste direto de API HTTP (cURL)

Para testes de pipeline fora de um ambiente de wrapper de cliente, payloads JSON-RPC padrão podem ser entregues por 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 Home Developer MCP ou como podemos melhorar sua experiência com a ferramenta.

Envie-nos seus comentários