Server MCP Data Penjual (Alfa Publik)

Dapatkan data langsung tentang akun Merchant Center Anda langsung dari asisten pengodean pilihan Anda. Dalam Lingkungan Pengembangan Terintegrasi (IDE) atau framework agen kustom, Anda kini dapat mengakses dan mengelola data Merchant Center menggunakan layanan Model Context Protocol (MCP). Layanan ini memungkinkan asisten atau agen pengodean Anda melakukan operasi penulisan yang aman dan hanya baca pada data Merchant Center Anda, sehingga dapat mendiagnosis masalah, memeriksa program, dan membuat kueri laporan dengan konteks live yang tepercaya.

Untuk mengetahui informasi selengkapnya tentang protokol itu sendiri, lihat standar Model Context Protocol.

Kontrol keamanan dan akses

Server MCP Data Penjual dirancang dengan keamanan sebagai prioritas:

  • Autentikasi: Eksekusi alat diatur secara ketat oleh autentikasi Merchant API standar, yang memerlukan kredensial OAuth 2.0 atau akun layanan.
  • Keamanan Eksekusi: Meskipun skema alat memiliki visibilitas yang luas bagi agen Anda, eksekusi aktual alat apa pun tetap sangat aman dan dibatasi secara ketat oleh kredensial API spesifik Anda.

Pertimbangan penting

Sebelum menggunakan alat ini, tinjau praktik terbaik dan batasan berikut:

Perubahan dan rilis

Kami akan memposting perubahan pada catatan rilis, tetapi perubahan tersebut dapat terjadi segera tanpa periode penghentian penggunaan.

Pengujian yang aman

Sebaiknya lakukan eksperimen terlebih dahulu menggunakan akun pengujian atau akun non-aktif sebelum menggunakan alat ini di lingkungan produksi aktif.

Kuota bersama

Server MCP menggunakan kumpulan kuota yang sama dengan panggilan Merchant API standar Anda. Menjalankan agen dapat dengan cepat menghabiskan kuota, terutama untuk pengambilan sumber data. Sebaiknya gunakan akun pengujian untuk mencegah gangguan layanan produksi.

Pemfilteran dan keamanan alat

Google mungkin menambahkan alat baru (termasuk kemampuan menulis) ke server MCP ini pada masa mendatang. Untuk mencegah agen AI Anda menjalankan alat baru atau berisiko secara otomatis dan tidak disengaja, sebaiknya konfigurasi klien Anda secara eksplisit untuk pemfilteran alat bawaan, bukan mengekspos seluruh set alat.

Cakupan dan batasan

  • Fokus Hanya Baca: Sebagai pembatas keamanan untuk fase awal ini, alat dibatasi secara ketat untuk operasi hanya baca dan alat tulis berisiko rendah (seperti pembuatan sumber data).

Kemampuan yang tersedia

Anda dapat menggunakan server MCP Data Penjual untuk melakukan tindakan berikut secara agentik:

  • Mendapatkan konteks status dan pelaporan yang mendetail untuk produk tertentu menggunakan nama resource yang tepat.
  • Mencantumkan dan menelusuri beberapa produk.
  • Kueri data performa, status produk, dan insight harga melalui laporan penelusuran.
  • Mencantumkan, membuat, mengambil, dan memeriksa status upload sumber data.
  • Identifikasi masalah tingkat akun yang memengaruhi visibilitas produk atau partisipasi program.
  • Mencantumkan alasan gabungan penolakan produk di seluruh inventaris Anda.
  • Periksa wilayah aktif, persyaratan yang tidak terpenuhi, dan status partisipasi untuk program Merchant Center tertentu.
  • Tinjau setelan penyempurnaan otomatis untuk item, gambar, dan pengiriman.

Penyiapan

Untuk menghubungkan IDE atau asisten coding Anda ke server MCP Data Penjual, perbarui setelan klien MCP Anda. Misalnya, perbarui file mcp.json untuk Claude Desktop, Antigravity, Visual Studio Code, atau framework agen kustom Anda.

Penyiapan server MCP lokal memerlukan akun layanan. Pengguna standar OAuth tidak didukung untuk eksekusi lokal tanpa UI ini. Anda harus membuat akun layanan, mendownload file kunci pribadi JSON-nya, dan memberikan jalur ke file tersebut bersama dengan ID Merchant Center spesifik Anda sebagai argumen.

Untuk mengetahui petunjuk mendetail tentang cara membuat dan mendownload akun layanan, lihat Panduan Akun Layanan.

Konfigurasi klien

Penyiapan konfigurasi:

Antigravity

Ikuti petunjuk dalam dokumentasi Antigravity.

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

Claude Desktop

Ikuti petunjuk dalam dokumentasi Claude Desktop.

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

Contoh skenario penggunaan

Server MCP Data Penjual memungkinkan agen Anda berinteraksi dengan data Merchant Center aktif Anda. Berikut ini beberapa skenario umum:

Skenario 1: Mendiagnosis penolakan produk

Anda ingin memahami alasan produk tertentu tidak muncul di hasil Google Penelusuran.

Perintah pengguna:

"Mengapa produk saya dengan ID penawaran 'offer123' tidak disetujui?"

Perilaku agen dengan MCP:

  1. Agen memanggil list_products atau get_product_by_name untuk menemukan status produk.
  2. Server MCP menampilkan status produk, termasuk daftar issues (misalnya, "Format harga salah" atau "Nilai pengiriman tidak ada").
  3. Agen akan menganalisis masalah dan menjelaskan penyebab utamanya kepada Anda, serta menyarankan cara memperbaikinya (misalnya, memperbarui informasi harga).

Skenario 2: Memeriksa peningkatan otomatis

Anda ingin memverifikasi apakah peningkatan pengiriman otomatis Anda aktif.

Perintah pengguna:

"Apakah peningkatan kualitas pengiriman otomatis saya diaktifkan?"

Perilaku agen dengan MCP:

  1. Agen memanggil get_automatic_improvements untuk mengambil setelan tingkat akun.
  2. Server MCP menampilkan konfigurasi yang menunjukkan status peningkatan gambar, item, dan pengiriman.
  3. Agen mengonfirmasi bahwa peningkatan pengiriman sudah aktif, atau menjelaskan cara mengaktifkannya jika tidak aktif.

Skenario 3: Metrik performa kueri

Anda ingin memeriksa performa terbaru dengan cepat tanpa membuka UI Merchant Center.

Perintah pengguna:

"Tampilkan 5 produk dengan performa terbaik saya berdasarkan klik minggu lalu".

Perilaku agen dengan MCP:

  1. Agen membuat kueri Merchant Center Query Language (MCQL) yang menargetkan tabel product_performance_view, mengurutkan berdasarkan clicks DESC, dan membatasi hingga 5.
  2. Agen memanggil report_search dengan kueri yang dibuat.
  3. Server MCP menjalankan kueri terhadap database pelaporan langsung dan menampilkan baris.
  4. Agen akan memformat hasil ke dalam tabel Markdown yang rapi untuk Anda.

Daftar mendetail alat yang tersedia

Server MCP mengekspos alat berikut ke agen Anda:

Alat MCP Deskripsi
get_product_by_name Dapatkan info produk untuk penjual tertentu menggunakan nama resource produk yang tepat. Menampilkan status produk mendetail yang berisi konteks pelaporan dan potensi masalah tingkat produk.
list_products Mencantumkan atau menelusuri beberapa produk untuk penjual tertentu. Menampilkan status produk mendetail yang berisi konteks pelaporan dan potensi masalah tingkat produk.
report_search Kueri tabel pelaporan untuk mengambil metrik performa, status produk, dan insight harga. Lihat Panduan laporan untuk mengetahui detailnya.
list_data_sources Mencantumkan sumber data untuk penjual tertentu.
get_data_source Mendapatkan detail sumber data tertentu.
create_data_source Buat sumber data untuk penjual tertentu.
fetch_data_source Mengambil dan memproses file yang terkait dengan sumber data untuk penjual tertentu.
get_file_upload Mendapatkan status upload file terbaru untuk sumber data tertentu.
list_accounts Mencantumkan akun untuk pengguna tertentu.
list_account_issues Mencantumkan masalah tingkat akun untuk penjual tertentu guna mengidentifikasi masalah di seluruh akun.
list_programs Mencantumkan program untuk penjual tertentu, termasuk status partisipasi, wilayah aktif, dan persyaratan yang tidak terpenuhi.
list_aggregated_product_issues Mencantumkan masalah tingkat produk gabungan untuk memantau kondisi keseluruhan data produk Anda.
get_automatic_improvements Mendapatkan setelan peningkatan otomatis, termasuk pembaruan item, peningkatan gambar, dan peningkatan pengiriman.