Servidor de MCP de Google Home Developer

El servidor del Protocolo de contexto del modelo (MCP) para desarrolladores de Google Home brinda a las herramientas de desarrollo potenciadas por IA la capacidad de buscar lo siguiente y recuperar información específica del dominio en tiempo real:

• Centro para desarrolladores de Google Home
• OpenThread
• Especificación de Matter: Disponible para la versión 1.5.1

Ayuda a garantizar que los agentes y las herramientas de IA puedan proporcionar respuestas técnicas precisas relacionadas con los programas y la tecnología para desarrolladores de Google Home.

Un servidor de MCP actúa como proxy entre un servicio externo que proporciona contexto o datos y una aplicación de IA (el host). El servidor de MCP para desarrolladores de Home expone herramientas ejecutables que permiten que los modelos de lenguaje grandes (LLM) encuentren respuestas precisas directamente de corpus indexados. Para obtener más información sobre los servidores de MCP, consulta ¿Qué es el MCP y cómo funciona?.

Requisitos previos

Para usar el servidor de MCP para desarrolladores de Home, debes tener instalado un cliente o editor de IA compatible con MCP.

Google Antigravity

Si usas el entorno de desarrollo de IA de Google, instala uno de los siguientes:

• CLI de Antigravity: Consulta la guía Comienza a usar la CLI de Antigravity
• Antigravity 2.0: Consulta la documentación de Google Antigravity
• IDE de Antigravity: Consulta la guía Comienza a usar el IDE de Antigravity

Asistentes de IA externos

También puedes integrar el MCP con otras aplicaciones de IA, herramientas de línea de comandos y editores de código, como los siguientes:

• Claude Code
• Cursor
• GitHub Copilot (VS Code)

Elige una ruta de autenticación

Según los requisitos de integración, puedes conectarte al servidor de MCP para desarrolladores de Home con una ruta de prueba no autenticada o una clave de API autenticada.

Prueba de conexión no autenticada

Este método no requiere ninguna clave de API ni configuración de Google Cloud. Usa una cuota pública compartida, lo que la convierte en la forma más sencilla de probar el servidor y probar la mecánica principal de inmediato.

Conexión autenticada para producción

Para evitar la limitación de frecuencia en las cuotas públicas compartidas, se recomienda autenticar tu entorno para un desarrollo sostenido.

Esta ruta requiere que tengas un proyecto Google Cloud activo.

1. En la consola de Google Cloud, habilita la API en tu proyecto:
   1. Abre la página de la API de Home Developers en la biblioteca de APIs de Google.
   2. Verifica que hayas seleccionado el proyecto correcto en el que deseas usar la API.
   3. Haz clic en Habilitar.

2. Crea una clave de API:

   1. Ve a la página Credenciales.
   2. Haz clic en Crear credenciales y, luego, selecciona Clave de API en el menú.
   3. En el campo Nombre, proporciona un nombre para la clave.

   4. Haz clic en el menú desplegable Seleccionar restricciones de API y, luego, escribe API de Home Developers. Haz clic en el resultado y, luego, en Aceptar.

   5. Haz clic en Crear.

   6. Después de crear la clave, haz clic en Mostrar clave para verla y cópiala para el siguiente paso.

Configura tu cliente

Existen varios entornos de desarrollo que pueden conectarse al servidor de MCP para desarrolladores de Home con una configuración no autenticada o de autenticación. Consulta las instrucciones de cada entorno para configurar el 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"
      }
    }
  }
}

Verifica la instalación y la ejecución

Una vez que se actualice la configuración de la herramienta, verifica la conexión solicitando tu espacio de trabajo del agente.

Ejemplo de verificación (CLI de Antigravity)

1. Inicia tu sesión de espacio de trabajo interactivo:

   agy
   

   

2. Ejecuta la macro de la lista de tareas de descubrimiento para inspeccionar los servidores de MCP activos:

   /mcp
   

3. Confirma que HomeDevelopers (o la clave de nombre del servidor que elegiste) aparezca en la lista de conexiones activas.

   

4. Hazle una pregunta a Google Home, por ejemplo:

   How do I create an Automation using Home APIs?
   

5. Si Antigravity cree que leer la documentación para desarrolladores de Google Home será útil, solicita permiso para usar las herramientas search_documents del servidor de MCP para desarrolladores de Home. Selecciona cualquiera de las opciones de Permitir para continuar.

   

6. Después de llamar a la herramienta y pensar, Antigravity responderá tu consulta con una respuesta fundamentada.

   

Video tutorial

Mira el video para obtener una guía paso a paso para instalar el MCP para desarrolladores de Home.

Protocolos de prueba de la API de HTTP directa (cURL)

Para las pruebas de canalización fuera de un entorno de wrapper de cliente, las cargas útiles JSON-RPC estándar se pueden entregar a través de canales curl.

Descubre las herramientas del sistema activas

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

Ejecuta una búsqueda 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?"
        }
    }
}'

Envíanos tus comentarios

Usa nuestro formulario de comentarios para enviar tus opiniones y sugerencias sobre el MCP para desarrolladores de Home o cómo podemos mejorar tu experiencia con la herramienta.

Envíanos tus comentarios