Servidor de MCP de Google Home

   Acceso anticipado   

El servidor del Protocolo de contexto del modelo (MCP) de Google Home permite que las herramientas para desarrolladores y los asistentes virtuales potenciados por IA interactúen directamente con los entornos de casa inteligente. Exponiendo herramientas de MCP y de interfaces de RPC estándar, el servidor permite que los modelos de lenguaje grandes (LLM) inspeccionen las estructuras de la casa, supervisen los estados de los dispositivos, ejecuten acciones de control y analicen eventos históricos.

Advertencia

Conectar una casa real a un agente de IA permite que ese agente controle los dispositivos en tu nombre. Home MCP aplica límites de frecuencia y protecciones de seguridad, como prohibir acciones sensibles, como destrabar puertas. Sin embargo, según tu agente, conectarlo al MCP de Home puede provocar un comportamiento inesperado o incluso no deseado. Revisa detenidamente las políticas y las condiciones del servicio para desarrolladores.

Si eliges conectar un dispositivo Google Home que usan otros miembros de la familia con Home MCP, debes informarles que tu agente puede controlar dispositivos y acceder a los datos de la casa. Como alternativa, puedes crear una casa adicional y configurar dispositivos para el desarrollo y las pruebas.

Puedes revocar el acceso de tu agente al Home MCP en cualquier momento desde el Google Home app (GHA) o la página Mis cuentas.

Descripción general

Un servidor de MCP actúa como un proxy entre la infraestructura de la casa inteligente y las aplicaciones de IA. El servidor de MCP de Home expone herramientas ejecutables que permiten que los clientes de IA consulten la telemetría de la casa en tiempo real y emitan comandos.

Capacidades principales

El servidor de MCP de Home proporciona varias áreas de funciones principales:

  • Descubrimiento de estructuras: Recupera casas y estructuras accesibles con list_homes.
  • Descubrimiento de recursos: Enumera dispositivos, diseños de áreas, características, atributos y esquemas de comandos con list_home_resources.
  • Supervisión de estado: Verifica el estado de conectividad del dispositivo en tiempo real y los estados de los rasgos con list_home_states.
  • Control de dispositivos: Ejecuta comandos de acción parametrizados en dispositivos de destino con run_home_actions.
  • Análisis histórico: Consulta los cambios de estado anteriores y los registros de eventos en períodos específicos con list_home_history.

Requisitos previos

Antes de configurar el servidor de MCP de Home, asegúrate de tener lo siguiente:

  • Una configuración activa de casa inteligente en Google Home con dispositivos conectados
  • Una suscripción activa a Google Home Premium Advanced
  • Acceso a un proyecto de Google Cloud
  • Un cliente o una aplicación de IA compatible con MCP, como Google Antigravity, Claude Cowork o OpenClaw.

Configura el servidor de MCP

Para configurar el servidor de MCP, se debe crear un proyecto de Google Cloud, obtener la aprobación de acceso, habilitar la API de Home y generar credenciales de OAuth.

Crea un proyecto de Google Cloud

Si aún no tienes un Google Cloud, debes crear uno:

  1. Abre la consola de Google Cloud.
  2. Crea un proyecto de Google Cloud nuevo.

Para obtener más información, consulta el artículo Crea proyectos en la documentación de Google Cloud.

Habilita la API de Home

  1. En el menú de navegación de la consola de Google Cloud, selecciona APIs y servicios > APIs y servicios habilitados.
  2. Busca API de Home y haz clic en Habilitar.
  1. Configura la pantalla de consentimiento de OAuth:
    1. Abre APIs y servicios > Pantalla de consentimiento de OAuth.
    2. Selecciona el público Externo, haz clic en Comenzar y completa la información de la app y el correo electrónico de contacto requeridos.
  2. Crea un ID de cliente de OAuth:
    1. Abre APIs y servicios > Credenciales.
    2. Haz clic en + Crear credenciales y selecciona ID de cliente de OAuth.
    3. Configura Tipo de aplicación como Aplicación web.
    4. Agrega los URIs de redireccionamiento autorizados que correspondan a tus clientes de IA de destino:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: Es el URI de redireccionamiento que especifica tu instalación local de OpenClaw.
    5. Haz clic en Crear y copia tu ID de cliente y el secreto del cliente en una ubicación segura.
  3. Publica tu aplicación:
    1. Abre Google Auth Platform > Público.
    2. En Estado de publicación, haz clic en Publicar app.

Configura tu cliente de IA

Puedes configurar varios entornos de desarrollo de IA para que se conecten al servidor de MCP de Home con la autenticación de OAuth. Ingresa tu ID de cliente de OAuth y el secreto del cliente aquí y, luego, sigue las instrucciones de configuración que prefieras.

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

Configuración automatizada con una instrucción

Si tu asistente de IA admite la administración de configuraciones de herramientas de MCP directamente desde el chat, puedes indicarle que configure el servidor pegando la siguiente instrucción:

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

Configuración manual

Selecciona tu herramienta de IA preferida para obtener instrucciones de configuración manual.

Antigravity

Google Antigravity proporciona integración integrada para los servidores de MCP en sus entornos de CLI, IDE y escritorio.

  1. Abre el menú de configuración de la aplicación: Configuración > Configuración avanzada > Personalizaciones > Abrir configuración de MCP.

  2. Agrega la entrada home_mcp en el objeto de configuración mcpServers:

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

  3. Completa la autenticación: Navega a Configuración > Configuración avanzada > Personalizaciones > home_mcp > Autenticación.

  4. Completa el flujo de permisos de Google Home en tu navegador web, selecciona la estructura de tu casa y copia el código de autorización en Antigravity.

Para obtener más información, consulta la documentación de Google Antigravity.

Claude

Configura Claude Cowork para que se conecte a tu servidor de MCP de Home personalizado:

  1. Abre Claude Connectors.
  2. Haz clic en + y selecciona Agregar conector personalizado.
  3. Ingresa la URL del servidor: https://home.googleapis.com/mcp.
  4. Haz clic en Configuración avanzada y, luego, ingresa tu ID de cliente y el secreto del cliente.
  5. Haz clic en Agregar y completa el flujo de autorización de OAuth en tu navegador.
  6. En un chat de Cowork, haz clic en + en la esquina inferior izquierda, selecciona Conectores y activa home_mcp.

Para obtener más información, consulta la documentación de la plataforma de Claude.

OpenClaw

Configura OpenClaw para conectarte al transporte de SSE remoto con la autenticación de OAuth:

  1. Prepara el bloque JSON del parche de configuración:

    {
  "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. Aplica el parche de configuración en tu terminal:

    openclaw config patch --stdin

  3. Reinicia la puerta de enlace de OpenClaw:

    openclaw gateway restart

  4. Inicia el flujo de autenticación:

    openclaw mcp login home_mcp

  5. Sigue la URL de autorización generada para acceder y otorgar acceso.

Para obtener más información, consulta la documentación de OpenClaw.

Para acceder a los datos de rostros conocidos en el MCP de Home, los usuarios deben dar su consentimiento explícito para esta función por separado.

Requisitos previos

  • El usuario que otorga el consentimiento debe ser un administrador de la estructura de Google Home.
  • La estructura del usuario debe tener, al menos, una cámara o un timbre Google Nest compatibles y una suscripción a Google Home Premium activa con la detección de rostros conocidos habilitada para cada cámara o timbre.
  • Tu aplicación debe tener un ID de cliente de OAuth 2.0 creado en Google Cloud. Consulta Configura tu cliente de IA para crear un cliente de OAuth 2.0 si aún no lo hiciste.

Para otorgar acceso a tu aplicación, debes visitar un vínculo de consentimiento personalizado con tu ID de cliente de OAuth 2.0 y el ID de estructura de Home. Hay dos maneras de obtener el vínculo de consentimiento.

Una vez que tengas el vínculo, visítalo y otorga tu consentimiento.

Si tu agente ya está conectado al MCP de Home, puede ubicar automáticamente tu ID de estructura de Home y generar un vínculo listo para hacer clic.

Actualiza los siguientes parámetros directamente en esta página y, luego, copia y pega la instrucción personalizada en el chat de tu agente.

  • CLIENT_ID: Es tu ID de cliente de OAuth 2.0 de Google Cloud. Por ejemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: Es el nombre de la estructura 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%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fhome.google.com

Si tu agente ya está conectado al MCP de Home, puede ubicar automáticamente tu ID de estructura de Home y generar un vínculo listo para hacer clic.

Actualiza los siguientes parámetros directamente en esta página y, luego, abre el vínculo personalizado en un navegador web.

  • CLIENT_ID: Es tu ID de cliente de OAuth 2.0 de Google Cloud. Por ejemplo, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: Es el UUID de la estructura Home de destino. La forma más fácil de obtenerlo es preguntarle a tu agente con el MCP de Home: "Dime el ID de la estructura (UUID) de [nombre de la estructura]".
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fhome.google.com

Verifica la conexión y la funcionalidad

Una vez que el cliente esté configurado y autenticado, verifica la conexión del servidor:

  1. Inicia tu asistente de IA o la sesión del espacio de trabajo.
  2. Verifica las conexiones activas del servidor de MCP (en Antigravity, ejecuta /mcp o inspecciona las listas de herramientas).
  3. Confirma que home_mcp aparezca con herramientas activas.

  4. Envía instrucciones de ejemplo a tu asistente para probar diferentes capacidades:

    • Descubrimiento de entidades: How many lights do I have in my house?
    • Supervisión del estado en tiempo real: Is my home secured?
    • Control del dispositivo: Turn off all the outside lights.
    • Análisis de eventos históricos: What happened while I was out?

  5. Otorga permisos de ejecución de la herramienta cuando lo solicite el cliente. El asistente de IA puede recuperar datos de estado en tiempo real y todas las respuestas se basarán en la telemetría de tu casa.

Asistencia

Para obtener asistencia para el desarrollo de MCP de Home, visita la Comunidad de ayuda de Casa inteligente para desarrolladores. Allí, puedes publicar una pregunta para obtener ayuda o consultar las preguntas publicadas anteriormente para ver si ya se respondió tu pregunta.

Para informar un error o enviar una solicitud de función de MCP, dirígete a nuestra herramienta de seguimiento de errores pública.

Problemas conocidos

  • Aplicación de derechos: El acceso al MCP de Home debe restringirse a los usuarios con una suscripción a Google Home Premium Advanced. Actualmente, un error permite que los suscriptores de Nest Aware Plus tengan acceso al MCP de Home. Estamos trabajando para solucionar este problema y pronto lanzaremos una corrección.
  • Prueba de rasgos: Para proporcionar el conjunto de funciones más amplio para tus agentes, incluimos algunos rasgos que están marcados como experimentales. Es posible que encuentres situaciones en las que estos atributos experimentales no funcionen como se espera. Si es así, usa la herramienta de seguimiento de errores pública para informarlo.
  • Latencia: En ocasiones, es posible que notes una latencia más larga de lo esperado con el MCP de Home. Estamos trabajando activamente en optimizaciones. Se espera que haya mejoras en la latencia en las próximas versiones.

Próximamente

  • Automatizaciones: Por el momento, no se admite la creación ni la administración de automatizaciones con el MCP de Home. Estamos trabajando en esta funcionalidad y planeamos lanzar la compatibilidad con automatizaciones en una versión futura.