Servidor de MCP de Google Home

   Acceso anticipado   

El servidor del Protocolo de contexto del modelo (MCP) de Google Home permite que las herramientas de desarrollo potenciadas por IA y los asistentes virtuales interactúen directamente con los entornos de la casa inteligente. Al exponer las herramientas estándar de MCP y las interfaces de RPC, 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 este controle los dispositivos en tu nombre. El MCP principal de la casa aplica límites de frecuencia y protecciones de seguridad, como la prohibición de acciones sensibles, como destrabar puertas. Sin embargo, según tu agente, conectarlo al MCP de Home puede generar un comportamiento inesperado o incluso no deseado. Revisa con atención las políticas y las condiciones del servicio para desarrolladores.

Si decides conectar un dispositivo Google Home que usan otros miembros de la familia con el MCP de Home, 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.

El acceso de tu agente a Home MCP se puede revocar en cualquier momento desde Google Home app (GHA) o la página Mis cuentas.

Descripción general

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

Capacidades principales

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

  • Descubrimiento de estructuras: Recupera casas y estructuras accesibles con list_homes.
  • Descubrimiento de recursos: Enumera dispositivos, diseños de áreas, rasgos, atributos y esquemas de comandos con list_home_resources.
  • Supervisión del 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 objetivo con run_home_actions.
  • Análisis histórico: Consulta los cambios de estado y los registros de eventos anteriores 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 de casa inteligente activa 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, debes 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 archivo 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 Home API 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 requerida de la app y el correo electrónico de contacto.
  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 correspondientes a tus clientes de IA objetivo:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: URI de redireccionamiento especificado por tu instalación local de OpenClaw
    5. Haz clic en Crear y copia tu ID de cliente y tu secreto del cliente en una ubicación segura.
  3. Publica tu aplicación:
    1. Abre Google Auth Platform > Audience.
    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 y secreto de cliente de OAuth 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 automática con una instrucción

Si tu asistente de IA admite la administración de la configuración 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://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

Configuración manual

Selecciona la herramienta de IA que prefieras 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. Autenticación completa: Ve 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

Sigue estos pasos para configurar Claude Cowork y conectarlo a tu servidor de MCP 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 tu 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 que se conecte al transporte SSE remoto con 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 la casa, los usuarios deben dar su consentimiento explícito para esta función por separado.

Requisitos previos

  • El usuario que otorga el consentimiento debe ser administrador de la estructura de Google Home.
  • La estructura del usuario debe tener al menos una cámara o un timbre Google Nest compatible y una suscripción 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 Cómo configurar 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 la estructura de Home. Hay dos formas de obtener tu 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: 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 de Home objetivo.
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

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: 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 objetivo. La forma más sencilla de obtenerlo es preguntarle a tu agente a través del MCP de Home: "Dime el ID de 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%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 sesión de 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 en la lista con las herramientas activas.

  4. Envía mensajes 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 herramientas cuando tu cliente te lo solicite. 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

Si necesitas ayuda para desarrollar un MCP de Home, visita la Comunidad de ayuda de Smart Home para desarrolladores. Allí, puedes publicar una pregunta para obtener ayuda o revisar las preguntas publicadas anteriormente para ver si ya se respondió tu pregunta.

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

Problemas conocidos

  • Pruebas de rasgos: Para proporcionar el conjunto más amplio de funciones para tus agentes, incluimos algunos rasgos marcados como experimentales. Es posible que te encuentres con situaciones en las que estos rasgos experimentales no funcionen como se espera. Si es así, usa la Herramienta de seguimiento de errores pública para informar el problema.
  • Latencia: En ocasiones, es posible que notes una latencia más larga de lo esperado con Home MCP. Estamos trabajando activamente en las optimizaciones. En versiones futuras, esperamos ver mejoras en la latencia.

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 las automatizaciones en una versión futura.