Servicio de acceso a MCP de la API de Merchant (alfa)

Usa el Servicio de acceso al Protocolo de contexto del modelo (MCP) de la API de Merchant para obtener acceso autorizado a tus datos y estadísticas de Merchant Center para crear nuevas experiencias de agentes y flujos de trabajo automatizados.

Descripción general

El Servicio de acceso al MCP de la API de Merchant proporciona un puente estandarizado y seguro para que los LLM, los agentes y los asistentes de codificación creen y organicen nuevas experiencias de agentes y flujos de trabajo automatizados basados en datos de Merchant Center.

En particular, permite el acceso autorizado a tus datos de Merchant Center y a los informes y estadísticas generados por Google para realizar operaciones de lectura y escritura limitadas para abordar casos de uso como los siguientes:

• Diagnosticar y corregir los rechazos de productos
• Generar informes de rendimiento y estadísticas
• Revisar la habilitación de las mejoras automáticas
• Crear y recuperar fuentes de datos

Seguridad y controles de acceso

El Servicio de acceso al MCP de la API de Merchant se diseñó con prioridad en la seguridad:

• Autenticación: La ejecución de la herramienta se rige por la autenticación estándar de la API de Merchant, que requiere credenciales de OAuth 2.0 o de cuenta de servicio. Te recomendamos que uses credenciales con los derechos de acceso más restrictivos posibles.
• Seguridad de ejecución: Si bien la visibilidad de la herramienta no está restringida para el descubrimiento de agentes, la ejecución de la herramienta está restringida a tus credenciales de API específicas.
• Protecciones: Las herramientas se limitan estrictamente a las operaciones de solo lectura y a las herramientas de escritura de bajo riesgo (por ejemplo, la creación de fuentes de datos) como una protección de seguridad.

Consideraciones importantes

El Servicio de acceso al MCP de la API de Merchant es una versión alfa; su alcance y capacidades se ampliarán y pueden cambiar.

Antes de comenzar, revisa las siguientes limitaciones y prácticas recomendadas:

Cambios y lanzamientos

Los cambios pueden ocurrir sin previo aviso y se publicarán en las notas de la versión.

Pruebas seguras

Te recomendamos que primero experimentes con una cuenta de prueba o una cuenta que no esté activa antes de usar estas herramientas en un entorno de producción activo.

Cuota compartida

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

Filtrado y seguridad de herramientas

En el futuro, se agregarán nuevas capacidades, en especial las acciones de escritura. Te recomendamos que configures explícitamente tu cliente para el filtrado de herramientas integrado en lugar de exponer todo el conjunto de herramientas.

Resumen de las capacidades disponibles

Puedes usar el Servicio de acceso al MCP de la API de Merchant para realizar las siguientes acciones de forma automática:

• Recuperar el estado detallado y el contexto de los informes de productos específicos con nombres de recursos exactos
• Enumerar y buscar varios productos
• Consultar métricas de rendimiento, estados de productos y estadísticas sobre productos populares, estadísticas de precios, visibilidad competitiva y estadísticas de afiliados de YouTube Shopping
• Identificar problemas a nivel de la cuenta que afectan la visibilidad de los productos o la participación en el programa
• Enumerar, crear, recuperar y verificar el estado de carga de las fuentes de datos
• Enumerar los motivos agregados de los rechazos de productos en tu inventario
• Revisar la configuración de mejoras automáticas para artículos, imágenes y envíos
• Verificar las regiones activas, los requisitos incumplidos y el estado de participación de programas específicos de Merchant Center

Cómo comenzar

Para conectar tu IDE, asistente de codificación o agente al Servicio de acceso al MCP de la API de Merchant, actualiza la configuración del cliente de MCP. Por ejemplo, actualiza el archivo mcp.json para Google Agent Studio, Claude para computadoras de escritorio, Antigravity, Visual Studio Code o tu framework de agente personalizado.

La configuración local del Servicio de acceso al MCP de la API de Merchant requiere una cuenta de servicio. El OAuth de usuario estándar 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 junto con tu ID específico de Merchant Center 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

Configuraciones:

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

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

Situaciones de ejemplo de uso

Para ilustrar cómo puedes aprovechar el Servicio de acceso al MCP de la API de Merchant para crear experiencias de agentes y flujos de trabajo automatizados, considera las siguientes situaciones:

Situación 1: Diagnosticar y corregir los rechazos de productos

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

Solicitud del usuario:

"¿Por qué se rechazó mi producto con el ID de 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, y te sugiere cómo solucionarlo (por ejemplo, actualizar la información del precio).

Situación 2: Revisar la habilitación de las mejoras automáticas

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

Solicitud 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 de imágenes, artículos y envíos.
3. El agente confirma que las mejoras de envío están activas o explica cómo habilitarlas si están desactivadas.

Situación 3: Generar informes de rendimiento y estadísticas

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

Solicitud del usuario:

"Muéstrame mis 5 productos con mejor rendimiento por 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 consulta creada.
3. El servidor de MCP ejecuta la consulta en la base de datos de informes en vivo y devuelve las filas.
4. El agente formatea los resultados en una tabla de Markdown clara para ti.

Situación 4: Crear y recuperar fuentes de datos

Quieres agregar una nueva fuente de datos para subir actualizaciones de productos.

Solicitud del usuario:

"Crea una fuente de datos complementaria llamada 'price-updates' para mi cuenta de comercio".

Comportamiento del agente con MCP:

1. El agente llama a create_data_source con la configuración especificada para registrar el nuevo feed.
2. El servidor de MCP crea la fuente de datos y devuelve su nombre de recurso único.
3. El agente llama a fetch_data_source para activar la descarga y el procesamiento del archivo asociado.
4. El agente llama a get_file_upload para supervisar el progreso de la carga y confirmar el estado de procesamiento correcto de los artículos.

Herramientas y descripciones de MCP

El Servicio de acceso al MCP de la API de Merchant expone las siguientes herramientas a tu agente: