Servidor de MCP de datos del comercio (alfa pública)

Obtén datos en tiempo real sobre tu cuenta de Merchant Center directamente desde el asistente de programación que elijas. En tu entorno de desarrollo integrado (IDE) o framework de agentes personalizados, ahora puedes acceder a tus datos de Merchant Center y administrarlos con el servicio del Protocolo de contexto del modelo (MCP). Este servicio permite que tu asistente o agente de programación realice operaciones de escritura seguras y de solo lectura en tus datos de Merchant Center, lo que le permite diagnosticar problemas, verificar programas y consultar informes con contexto autorizado y en vivo.

Para obtener más información sobre el protocolo en sí, consulta el estándar del Protocolo de Contexto del Modelo.

Seguridad y control de acceso

El servidor de MCP de datos del comercio se diseñó con la seguridad como prioridad:

  • Autenticación: La ejecución de la herramienta se rige estrictamente por la autenticación estándar de la API de Merchant, que requiere credenciales de OAuth 2.0 o de cuenta de servicio.
  • Seguridad de ejecución: A pesar de la amplia visibilidad de los esquemas de herramientas para tu agente, la ejecución real de cualquier herramienta sigue siendo muy segura y está estrictamente restringida por tus credenciales de API específicas.

Consideraciones importantes

Antes de usar estas herramientas, revisa las siguientes prácticas recomendadas y limitaciones:

Cambios y lanzamientos

Publicaremos los cambios en las notas de la versión, pero estos pueden ocurrir de inmediato sin un período de baja.

Pruebas seguras

Te recomendamos que primero experimentes con una cuenta de prueba o una cuenta que no sea en vivo antes de usar estas herramientas en un entorno de producción en vivo.

Cuota compartida

El servidor de MCP comparte el mismo grupo de cuotas que tus llamadas estándar a la API de Merchant. Los agentes en ejecución pueden agotar rápidamente la cuota, especialmente en el caso de las recuperaciones de fuentes de datos. Te recomendamos que uses una cuenta de prueba para evitar interrupciones en el servicio de producción.

Filtrado de herramientas y seguridad

Es posible que Google agregue nuevas herramientas (incluidas las capacidades de escritura) a este servidor de MCP en el futuro. Para evitar que tu agente de IA ejecute de forma automática y no intencional herramientas nuevas o riesgosas, te recomendamos que configures explícitamente tu cliente para el filtrado de herramientas integradas en lugar de exponer todo el conjunto de herramientas.

Alcance y limitaciones

  • Enfoque de solo lectura: Como medida de seguridad para esta fase inicial, las herramientas se limitan estrictamente a operaciones de solo lectura y herramientas de escritura de bajo riesgo (como la creación de fuentes de datos).

Capacidades disponibles

Puedes usar el servidor del MCP de datos del comercio para realizar las siguientes acciones de forma agentiva:

  • Recupera el contexto detallado de estado y generación de informes para productos específicos con nombres de recursos exactos.
  • Buscar y mostrar varios productos
  • Datos de rendimiento de la búsqueda, estados de los productos y estadísticas de precios a través de los informes de búsqueda
  • Enumera, crea, recupera y verifica el estado de carga de las fuentes de datos.
  • Identifica los problemas a nivel de la cuenta que afectan la visibilidad de los productos o la participación en el programa.
  • Enumera los motivos agregados de los rechazos de productos en todo tu inventario.
  • Verifica las regiones activas, los requisitos no cumplidos y el estado de participación de programas específicos de Merchant Center.
  • Revisa la configuración de las mejoras automáticas para los artículos, las imágenes y el envío.

Configuración

Para conectar tu IDE o asistente de programación al servidor de MCP de datos del comercio, actualiza la configuración del cliente de MCP. Por ejemplo, actualiza el archivo mcp.json para Claude Desktop, Antigravity, Visual Studio Code o tu framework de agentes personalizados.

La configuración del servidor de MCP local requiere una cuenta de servicio. Usuario estándar OAuth no es compatible con esta ejecución local sin interfaz gráfica. Debes crear una cuenta de servicio, descargar su archivo de clave privada JSON y proporcionar la ruta de acceso a este junto con tu ID de Merchant Center específico como argumentos.

Para obtener instrucciones detalladas sobre cómo crear y descargar una cuenta de servicio, consulta la guía de cuentas de servicio.

Configuración del cliente

Configuración:

Antigravity

Sigue las instrucciones de la documentación de Antigravity.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude para computadoras de escritorio

Sigue las instrucciones de la documentación de Claude Desktop.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Ejemplos de situaciones de uso

El servidor de MCP de datos del comercio permite que tu agente interactúe con tus datos activos de Merchant Center. Éstos son algunos casos comunes:

Situación 1: Diagnostica los rechazos de productos

Quieres comprender por qué un producto específico no aparece en los resultados de la Búsqueda de Google.

Instrucción del usuario:

¿Por qué se rechazó mi producto con el ID de la oferta 'offer123'?

Comportamiento del agente con MCP:

  1. El agente llama a list_products o get_product_by_name para ubicar el estado del producto.
  2. El servidor de MCP devuelve el estado del producto, incluida una lista de issues (por ejemplo, "Formato de precio incorrecto" o "Falta el valor de envío").
  3. El agente analiza los problemas y te explica la causa raíz, además de sugerirte cómo solucionarlos (por ejemplo, actualizar la información del precio).

Situación 2: Verifica las mejoras automáticas

Quieres verificar si tus mejoras automáticas de envío están activas.

Instrucción del usuario:

“¿Están habilitadas mis mejoras automáticas de envío?”

Comportamiento del agente con MCP:

  1. El agente llama a get_automatic_improvements para recuperar la configuración a nivel de la cuenta.
  2. El servidor de MCP devuelve la configuración que muestra el estado de las mejoras en las imágenes, los artículos y el envío.
  3. El agente confirma que las mejoras en el envío están activas o explica cómo habilitarlas si están desactivadas.

Situación 3: Métricas de rendimiento de las consultas

Quieres verificar rápidamente tu rendimiento reciente sin navegar por la IU de Merchant Center.

Instrucción del usuario:

"Muéstrame los 5 productos con mejor rendimiento según los clics de la semana pasada".

Comportamiento del agente con MCP:

  1. El agente crea una consulta del lenguaje de consultas de Merchant Center (MCQL) que segmenta la tabla product_performance_view, ordena por clicks DESC y limita a 5.
  2. El agente llama a report_search con la búsqueda construida.
  3. El servidor de MCP ejecuta la consulta en la base de datos de informes activos y devuelve las filas.
  4. El agente formatea los resultados en una tabla de Markdown clara para ti.

Lista detallada de las herramientas disponibles

El servidor de MCP expone las siguientes herramientas a tu agente:

Herramienta del MCP Descripción
get_product_by_name Obtiene información del producto para un comercio determinado usando el nombre exacto del recurso del producto. Devuelve el estado detallado del producto que contiene el contexto del informe y los posibles problemas a nivel del producto.
list_products Enumera o busca varios productos para un comercio determinado. Devuelve el estado detallado del producto que contiene el contexto de informes y los posibles problemas a nivel del producto.
report_search Consultar tablas de informes para recuperar métricas de rendimiento, estados de productos e información sobre precios Consulta la guía de informes para obtener más detalles.
list_data_sources Enumera las fuentes de datos de un comercio determinado.
get_data_source Obtén detalles de una fuente de datos específica.
create_data_source Crea una fuente de datos para un comercio determinado.
fetch_data_source Recupera y procesa el archivo asociado a una fuente de datos para un comercio determinado.
get_file_upload Obtén el estado de la carga de archivos más reciente para una fuente de datos determinada.
list_accounts Enumera las cuentas de un usuario determinado.
list_account_issues Enumera los problemas a nivel de la cuenta de un comercio determinado para identificar problemas en toda la cuenta.
list_programs Enumera los programas de un comercio determinado, incluido el estado de participación, las regiones activas y los requisitos no cumplidos.
list_aggregated_product_issues Enumera los problemas agregados a nivel del producto para supervisar el estado general de tus datos de productos.
get_automatic_improvements Obtén la configuración de las mejoras automáticas, incluidas las actualizaciones de artículos, las mejoras de imágenes y las mejoras de envío.