Server MCP per i dati dei commercianti (alpha pubblica)

Ottieni dati in tempo reale sul tuo account Merchant Center direttamente dall'assistente alla programmazione che preferisci. All'interno dell'ambiente di sviluppo integrato (IDE) o del framework dell'agente personalizzato, ora puoi accedere ai tuoi dati Merchant Center e gestirli utilizzando il servizio Model Context Protocol (MCP). Questo servizio consente all'assistente alla programmazione o all'agente di eseguire operazioni di lettura e scrittura sicure sui tuoi dati Merchant Center, consentendogli di diagnosticare problemi, controllare i programmi ed eseguire query sui report con un contesto autorevole e in tempo reale.

Per ulteriori informazioni sul protocollo, consulta lo standard Model Context Protocol.

Sicurezza e controllo dell'accesso

Il server MCP per i dati del commerciante è progettato con la sicurezza come priorità:

  • Autenticazione: l'esecuzione dello strumento è rigorosamente regolata dall'autenticazione API Merchant standard, che richiede le credenziali OAuth 2.0 o del service account.
  • Sicurezza di esecuzione: nonostante l'ampia visibilità degli schemi degli strumenti per il tuo agente, l'esecuzione effettiva di qualsiasi strumento rimane altamente sicura ed è rigorosamente limitata dalle tue credenziali API specifiche.

Considerazioni importanti

Prima di utilizzare questi strumenti, esamina le seguenti best practice e limitazioni:

Modifiche e release

Pubblicheremo informazioni sulle modifiche alle note di rilascio, ma queste possono essere apportate immediatamente senza un periodo di ritiro.

Test sicuri

Ti consigliamo di fare prima qualche prova utilizzando un account di test o un account non live prima di utilizzare questi strumenti in un ambiente di produzione live.

Quota condivisa

Il server MCP condivide lo stesso pool di quote delle chiamate API Merchant standard. L'esecuzione di agenti può esaurire rapidamente la quota, soprattutto per i recuperi delle origini dati. Ti consigliamo vivamente di utilizzare un account di test per evitare interruzioni del servizio di produzione.

Filtro e sicurezza degli strumenti

In futuro, Google potrebbe aggiungere nuovi strumenti (incluse funzionalità di scrittura) a questo server MCP. Per impedire all'agente AI di eseguire automaticamente e involontariamente strumenti nuovi o rischiosi, ti consigliamo vivamente di configurare esplicitamente il client per il filtraggio degli strumenti integrati anziché esporre l'intero set di strumenti.

Ambito e limitazioni

  • Focus di sola lettura: come misura di salvaguardia per questa fase iniziale, gli strumenti sono rigorosamente limitati alle operazioni di sola lettura e agli strumenti di scrittura a basso rischio (come la creazione di origini dati).

Funzionalità disponibili

Puoi utilizzare il server MCP di Merchant Data per eseguire le seguenti azioni in modo autonomo:

  • Recupera lo stato dettagliato e il contesto dei report per prodotti specifici utilizzando i nomi esatti delle risorse.
  • Elenca e cerca più prodotti.
  • Dati sul rendimento delle query, stati dei prodotti e insight sul prezzo tramite i report sulla ricerca.
  • Elenca, crea, recupera e controlla lo stato di caricamento delle origini dati.
  • Identifica i problemi a livello di account che influiscono sulla visibilità dei prodotti o sulla partecipazione al programma.
  • Elenca i motivi aggregati delle disapprovazioni dei prodotti nel tuo inventario.
  • Controlla le regioni attive, i requisiti non soddisfatti e lo stato di partecipazione per programmi Merchant Center specifici.
  • Esamina le impostazioni di miglioramento automatico per articoli, immagini e spedizione.

Configurazione

Per connettere l'IDE o l'assistente alla programmazione al server MCP di Merchant Data, aggiorna le impostazioni del client MCP. Ad esempio, aggiorna il file mcp.json per Claude Desktop, Antigravity, Visual Studio Code o il tuo framework di agenti personalizzato.

La configurazione del server MCP locale richiede un service account. Utente standard OAuth non è supportato per questa esecuzione locale headless. Devi creare un service account, scaricare il relativo file JSON della chiave privata e fornire il percorso insieme all'ID Merchant Center specifico come argomenti.

Per istruzioni dettagliate su come creare e scaricare un service account, consulta la guida ai service account.

Configurazione client

Configurazioni:

Antigravity

Segui le istruzioni riportate nella documentazione di Antigravity.

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

Claude Desktop

Segui le istruzioni nella documentazione di Claude Desktop.

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

Scenari di utilizzo di esempio

Il server MCP per i dati di Merchant consente all'agente di interagire con i dati di Merchant Center live. Di seguito sono riportati alcuni scenari comuni:

Scenario 1: diagnosticare le mancate approvazioni dei prodotti

Vuoi capire perché un prodotto specifico non viene visualizzato nei risultati della Ricerca Google.

Prompt dell'utente:

"Perché il mio prodotto con ID offerta "offer123" non è stato approvato?"

Comportamento dell'agente con MCP:

  1. L'agente chiama list_products o get_product_by_name per individuare lo stato del prodotto.
  2. Il server MCP restituisce lo stato del prodotto, incluso un elenco di issues (ad esempio "Formato del prezzo errato" o "Valore di spedizione mancante").
  3. L'agente analizza i problemi e ti spiega la causa principale, suggerendo come risolverli (ad esempio, aggiornando le informazioni sul prezzo).

Scenario 2: controlla i miglioramenti automatici

Vuoi verificare se i miglioramenti automatici della spedizione sono attivi.

Prompt dell'utente:

"I miglioramenti automatici della spedizione sono attivi?"

Comportamento dell'agente con MCP:

  1. L'agente chiama get_automatic_improvements per recuperare le impostazioni a livello di account.
  2. Il server MCP restituisce la configurazione che mostra lo stato dei miglioramenti di immagine, articolo e spedizione.
  3. L'agente conferma che i miglioramenti alla spedizione sono attivi o spiega come attivarli se sono disattivati.

Scenario 3: metriche sul rendimento delle query

Vuoi controllare rapidamente il tuo rendimento recente senza navigare nell'interfaccia utente di Merchant Center.

Prompt dell'utente:

"Mostrami i miei 5 prodotti con il rendimento migliore in base ai clic della scorsa settimana".

Comportamento dell'agente con MCP:

  1. L'agente crea una query Merchant Center Query Language (MCQL) che ha come target la tabella product_performance_view, ordinando per clicks DESC e limitando a 5.
  2. L'agente chiama report_search con la query creata.
  3. Il server MCP esegue la query sul database di reporting live e restituisce le righe.
  4. L'agente formatta i risultati in una tabella Markdown pulita.

Elenco dettagliato degli strumenti disponibili

Il server MCP espone i seguenti strumenti al tuo agente:

Strumento MCP Descrizione
get_product_by_name Recupera le informazioni sul prodotto per un determinato commerciante utilizzando il nome esatto della risorsa prodotto. Restituisce lo stato dettagliato del prodotto contenente il contesto dei report e i potenziali problemi a livello di prodotto.
list_products Elenca o cerca più prodotti per un determinato commerciante. Restituisce lo stato dettagliato del prodotto contenente il contesto dei report e i potenziali problemi a livello di prodotto.
report_search Esegui query sulle tabelle dei report per recuperare metriche sul rendimento, stati dei prodotti e insight sul prezzo. Per maggiori dettagli, consulta la guida ai report.
list_data_sources Elenca le origini dati per un determinato commerciante.
get_data_source Visualizza i dettagli di un'origine dati specifica.
create_data_source Crea un'origine dati per un determinato commerciante.
fetch_data_source Recupera ed elabora il file associato a un'origine dati per un determinato commerciante.
get_file_upload Visualizza lo stato dell'ultimo caricamento di file per una determinata origine dati.
list_accounts Elenca gli account per un determinato utente.
list_account_issues Elenca i problemi a livello di account per un determinato commerciante per identificare i problemi a livello di account.
list_programs Elenca i programmi per un determinato commerciante, inclusi lo stato di partecipazione, le regioni attive e i requisiti non soddisfatti.
list_aggregated_product_issues Elenca i problemi aggregati a livello di prodotto per monitorare lo stato generale dei dati di prodotto.
get_automatic_improvements Ottieni le impostazioni per i miglioramenti automatici, inclusi aggiornamenti degli articoli, miglioramenti delle immagini e miglioramenti della spedizione.