Servidor MCP do Google Home

   Acesso antecipado   

O servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) do Google Home permite que ferramentas para desenvolvedores com tecnologia de IA e assistentes virtuais interajam diretamente com ambientes de casa inteligente. Ao expor ferramentas padrão do MCP e interfaces RPC, o servidor permite que modelos de linguagem grandes (LLMs) inspecionem estruturas da casa, monitorem estados de dispositivos, executem ações de controle e analisem eventos históricos.

Aviso

Conectar uma casa real a um agente de IA permite que ele controle dispositivos em seu nome. O MCP do Home impõe limites de taxa e proteções de segurança, como proibir ações sensíveis, como destrancar portas. No entanto, dependendo do seu agente, conectá-lo ao MCP do Home pode resultar em comportamentos inesperados ou até mesmo indesejados. Leia com atenção as políticas e os Termos de Serviço para desenvolvedores.

Se você conectar um Google Home usado por outros membros da família ao Home MCP, informe a eles que seu agente pode controlar dispositivos e acessar dados da casa. Como alternativa, você pode criar uma casa adicional e configurar dispositivos para desenvolvimento e teste.

O acesso do agente ao MCP do Home pode ser revogado a qualquer momento no Google Home app (GHA) ou na página "Minhas contas".

Visão geral

Um servidor MCP atua como um proxy entre a infraestrutura de casa inteligente e os aplicativos de IA. O servidor MCP do Home expõe ferramentas executáveis que permitem que os clientes de IA consultem a telemetria da casa em tempo real e emitam comandos.

Recursos principais

O servidor MCP do Home oferece várias áreas de recursos principais:

  • Descoberta de estrutura:recupere casas e estruturas acessíveis usando list_homes.
  • Descoberta de recursos:liste dispositivos, layouts de área, atributos, características e esquemas de comando usando list_home_resources.
  • Monitoramento de estado:verifique o status de conectividade do dispositivo e os estados de traços em tempo real usando list_home_states.
  • Controle de dispositivos:execute comandos de ação parametrizados em dispositivos de destino usando run_home_actions.
  • Análise histórica:consulte mudanças de estado anteriores e logs de eventos em períodos específicos usando list_home_history.

Pré-requisitos

Antes de configurar o servidor MCP do Home, verifique se você tem o seguinte:

  • Uma configuração de casa inteligente ativa no Google Home com dispositivos conectados.
  • Uma assinatura ativa do Google Home Premium Advanced.
  • Acesso a um projeto do Google Cloud.
  • Um cliente ou aplicativo de IA compatível com o MCP, como o Google Antigravity, o Claude Cowork ou o OpenClaw.

Configurar o servidor MCP

Para configurar o servidor MCP, é necessário criar um projeto do Google Cloud, receber aprovação de acesso, ativar a API Home e gerar credenciais do OAuth.

Criar um projeto do Google Cloud

Se você ainda não tiver um Google Cloud, crie um:

  1. Abra o console do Google Cloud.
  2. Crie um novo projeto do Google Cloud.

Para mais informações, consulte o artigo Criar projetos na documentação do Google Cloud.

Ativar a API Home

  1. No menu de navegação do console do Google Cloud, selecione APIs e serviços > APIs e serviços ativados.
  2. Pesquise API Home e clique em Ativar.
  1. Configure a tela de permissão OAuth:
    1. Abra APIs e serviços > Tela de permissão OAuth.
    2. Selecione o público Externo, clique em Começar e preencha as informações necessárias do app e o e-mail de contato.
  2. Crie um ID do cliente OAuth:
    1. Abra APIs e serviços > Credenciais.
    2. Clique em + Criar credenciais e selecione ID do cliente OAuth.
    3. Defina o Tipo de aplicativo como Aplicativo da Web.
    4. Adicione os URIs de redirecionamento autorizados correspondentes aos seus clientes de IA de destino:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork:https://claude.ai/api/mcp/auth_callback
      • OpenClaw:URI de redirecionamento especificado pela instalação local do OpenClaw.
    5. Clique em Criar e copie o ID do cliente e a chave secreta do cliente para um local seguro.
  3. Publique o aplicativo:
    1. Abra Google Auth Platform > Público-alvo.
    2. Em Status da publicação, clique em Publicar app.

Configurar o cliente de IA

É possível configurar vários ambientes de desenvolvimento de IA para se conectar ao servidor MCP do Home usando a autenticação OAuth. Insira o ID do cliente e a chave secreta do cliente OAuth aqui e siga as instruções de configuração de sua preferência.

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

Configuração automatizada usando um comando

Se o assistente de IA permitir o gerenciamento das configurações da ferramenta MCP diretamente no chat, você pode instruir o assistente a configurar o servidor colando o seguinte comando:

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

Configuração manual

Selecione sua ferramenta de IA preferida para ver as instruções de configuração manual.

Antigravity

O Google Antigravity oferece integração integrada para servidores MCP nos ambientes de CLI, IDE e desktop.

  1. Abra o menu de configuração do aplicativo: Configurações > Configurações avançadas > Personalizações > Abrir configuração do MCP.

  2. Adicione a entrada home_mcp no objeto de configuração mcpServers:

    {
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

  3. Conclua a autenticação: acesse Configurações > Configurações avançadas > Personalizações > home_mcp > Autenticação.

  4. Conclua o fluxo de permissões do Google Home no navegador da Web, selecione a estrutura da casa e copie o código de autorização de volta para o Antigravity.

Para mais informações, consulte a documentação do Google Antigravity.

Claude

Configure o Claude Cowork para se conectar ao servidor MCP personalizado:

  1. Abra os conectores do Claude.
  2. Clique em + e selecione Adicionar conector personalizado.
  3. Digite o URL do servidor: https://home.googleapis.com/mcp.
  4. Clique em Configurações avançadas e insira o ID do cliente e a chave secreta do cliente.
  5. Clique em Adicionar e conclua o fluxo de autorização do OAuth no navegador.
  6. Em uma conversa do Cowork, clique em + no canto inferior esquerdo, selecione Conectores e ative home_mcp.

Para mais informações, consulte a documentação da plataforma Claude.

OpenClaw

Configure o OpenClaw para se conectar ao transporte SSE remoto com autenticação OAuth:

  1. Prepare o bloco JSON do patch de configuração:

    {
  "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. Aplique o patch de configuração no terminal:

    openclaw config patch --stdin

  3. Reinicie o gateway do OpenClaw:

    openclaw gateway restart

  4. Inicie o fluxo de autenticação:

    openclaw mcp login home_mcp

  5. Siga o URL de autorização gerado para fazer login e conceder acesso.

Para mais informações, consulte a documentação do OpenClaw.

Para acessar os dados de rostos conhecidos no MCP do Home, os usuários precisam consentir explicitamente com esse recurso separadamente.

Pré-requisitos

  • O usuário que concede o consentimento precisa ser um administrador da estrutura Google Home.
  • A estrutura do usuário precisa ter pelo menos uma câmera ou campainha Google Nest compatível e uma assinatura ativa do Google Home Premium com a detecção de rosto conhecido ativada para cada câmera ou campainha.
  • Seu aplicativo precisa ter um ID do cliente OAuth 2.0 criado em Google Cloud. Consulte Configurar o cliente de IA para criar um cliente OAuth 2.0, caso ainda não tenha feito isso.

Para conceder acesso ao aplicativo, acesse um link de consentimento personalizado com o ID do cliente OAuth 2.0 e o ID da estrutura do Home. Há duas maneiras de conseguir o link de consentimento.

Depois de receber o link, acesse-o e dê seu consentimento.

Se o agente já estiver conectado ao MCP do Home, ele poderá localizar automaticamente o ID da estrutura do Home e gerar um link pronto para clicar.

Atualize os parâmetros a seguir diretamente nesta página e copie e cole o comando personalizado no chat do agente.

  • CLIENT_ID: seu ID do cliente OAuth 2.0 do Google Cloud. Por exemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: o nome da estrutura Home de destino.
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 o agente já estiver conectado ao MCP do Home, ele poderá localizar automaticamente o ID da estrutura do Home e gerar um link pronto para clicar.

Atualize os parâmetros a seguir diretamente nesta página e abra o link personalizado em um navegador da Web.

  • CLIENT_ID: o ID do cliente OAuth 2.0 do Google Cloud. Por exemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: o UUID da estrutura de Home de destino. A maneira mais fácil de conseguir isso é perguntar ao agente usando o MCP do Home: "Qual é o ID da estrutura (UUID) de [Nome da estrutura]?"
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Verificar a conexão e a funcionalidade

Depois que o cliente estiver configurado e autenticado, verifique a conexão com o servidor:

  1. Inicie seu assistente de IA ou a sessão do espaço de trabalho.
  2. Verifique as conexões ativas do servidor MCP (no Antigravity, execute /mcp ou inspecione as listas de ferramentas).
  3. Confirme se home_mcp está listado com as ferramentas ativas.

  4. Envie comandos de exemplo para o assistente para testar diferentes recursos:

    • Descoberta de entidades:How many lights do I have in my house?
    • Monitoramento de estado em tempo real:Is my home secured?
    • Controle do dispositivo:Turn off all the outside lights.
    • Análise de eventos históricos:What happened while I was out?

  5. Conceda permissões de execução de ferramentas quando solicitado pelo cliente. O assistente de IA pode recuperar dados de estado em tempo real, e todas as respostas serão baseadas na telemetria da sua casa.

Suporte

Para receber suporte ao desenvolvimento do MCP do Home, acesse a Comunidade de Ajuda da Casa Inteligente para Desenvolvedores. Lá, você pode postar uma pergunta para receber ajuda ou pesquisar perguntas postadas anteriormente para ver se sua dúvida já foi respondida.

Para registrar um bug ou uma solicitação de recurso do MCP, acesse nosso Issue Tracker público.

Problemas conhecidos

  • Aplicação de direitos: o acesso ao MCP do Google Home precisa ser restrito a usuários com uma assinatura do Google Home Premium Advanced. No momento, um bug está permitindo que assinantes do Nest Aware Plus tenham acesso ao MCP do Home. Estamos trabalhando para resolver esse problema, e uma correção será lançada em breve.
  • Teste de atributos: para oferecer o conjunto mais amplo de funcionalidades para seus agentes, incluímos alguns atributos marcados como experimentais. Você pode encontrar cenários em que essas características experimentais não funcionam como esperado. Se sim, use o Issue Tracker público para informar.
  • Latência: às vezes, você pode notar uma latência maior do que o esperado com o MCP do Home. Estamos trabalhando em otimizações. As melhorias de latência serão lançadas em versões futuras.

Em breve

  • Automações: no momento, não é possível criar e gerenciar automações com o MCP do Google Home. Estamos trabalhando nessa funcionalidade e planejamos lançar o suporte para automações em uma versão futura.