Servidor MCP do Google Home

   Acesso antecipado   

O servidor do Protocolo de Contexto de Modelo (MCP) do Google Home permite que ferramentas de desenvolvimento e assistentes virtuais com tecnologia de IA interajam diretamente com ambientes de casas inteligentes. Ao expor ferramentas padrão do MCP e interfaces RPC, o servidor permite que modelos de linguagem grandes (LLMs) inspecionem estruturas domésticas, monitorem estados de dispositivos, executem ações de controle e analisem eventos históricos.

Aviso!

Ao conectar uma casa real a um agente de IA, ele pode controlar dispositivos em seu nome. O MCP da casa impõe limites de taxa e proteções de segurança, como a proibição de ações sensíveis, como destrancar portas. No entanto, dependendo do seu agente, a conexão com o Home MCP pode resultar em um comportamento inesperado ou até mesmo indesejado. Leia com atenção as políticas e os termos de serviço para desenvolvedores.

Se você conectar um Google Home usado por outras pessoas com o Home MCP, informe a elas 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 seu agente ao Home MCP pode ser revogado a qualquer momento na 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 Google Home expõe ferramentas executáveis que permitem que clientes de IA consultem a telemetria da casa em tempo real e emitam comandos.

Recursos principais

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

  • Descoberta de estruturas:recupere casas e estruturas acessíveis usando list_homes.
  • Descoberta de recursos:liste dispositivos, layouts de área, características, atributos e esquemas de comando usando list_home_resources.
  • Monitoramento de estado:verifique o status de conectividade do dispositivo em tempo real e os estados de traços 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 e registros de eventos anteriores em períodos específicos usando list_home_history.

Pré-requisitos

Antes de configurar o servidor MCP doméstico, 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, crie um projeto Google Cloud, obtenha a aprovação de acesso, ative a API Home e gere 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 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 Google Cloud, selecione APIs e serviços > APIs e serviços ativados.
  2. Pesquise Home API 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 obrigató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 seu cliente de IA

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

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

Configuração automática usando um comando

Se o assistente de IA permitir gerenciar as configurações da ferramenta MCP diretamente no chat, cole o seguinte comando para instruir o assistente a configurar o servidor:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://preprod-home.sandbox.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 instruções de configuração manual.

Antigravity

O Google Antigravity oferece integração integrada para servidores MCP em todos os 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 ao 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 sua 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 seu servidor MCP doméstico 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 de 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 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 da página inicial, os usuários precisam dar consentimento explícito para esse recurso separadamente.

Pré-requisitos

  • O usuário que concede o consentimento precisa ser um gerente 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 Google Home Premium ativa com a detecção de rostos conhecidos ativada para cada câmera ou campainha.
  • Seu aplicativo precisa ter um ID do cliente OAuth 2.0 criado em Google Cloud. Consulte Configurar seu cliente de IA para criar um cliente OAuth 2.0, se ainda não tiver feito isso.

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

Depois de ter 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 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 seu agente.

  • CLIENT_ID: seu ID do cliente OAuth 2.0 de Google Cloud. Por exemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: o nome da estrutura de destino Home.
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 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: seu ID do cliente OAuth 2.0 de Google Cloud. Por exemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: o UUID da estrutura Home de destino. A maneira mais fácil de conseguir isso é perguntar ao seu agente usando o MCP da casa: "Me diga 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 do servidor:

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

  4. Emita comandos de exemplo para o Google Assistente e teste 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 da ferramenta quando solicitado pelo cliente. O assistente de IA pode recuperar dados de estado em tempo real, e todas as respostas são baseadas na telemetria da sua casa.

Suporte

Para receber suporte no desenvolvimento de MCPs para casa, acesse a Comunidade de Ajuda Casa inteligente para desenvolvedores Lá, você pode postar uma pergunta para receber ajuda ou consultar perguntas postadas anteriormente para saber se a sua já foi respondida.

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

Problemas conhecidos

  • Teste de traços: para oferecer o conjunto mais amplo de funcionalidades aos seus agentes, incluímos alguns traços marcados como experimentais. Você pode encontrar cenários em que essas características experimentais não funcionam como esperado. Se for o caso, 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 Home MCP. Estamos trabalhando para otimizar o processo. Aguarde melhorias na latência em versões futuras.

Em breve

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