MCP Reference: paydeveloper.googleapis.com

Server Model Context Protocol (MCP) bertindak sebagai proxy antara layanan eksternal yang menyediakan konteks, data, atau kemampuan ke Model Bahasa Besar (LLM) atau aplikasi AI. Server MCP menghubungkan aplikasi AI ke sistem eksternal seperti database dan layanan web, serta menerjemahkan responsnya ke dalam format yang dapat dipahami oleh aplikasi AI.

Penyiapan Server

Anda harus mengaktifkan server MCP dan menyiapkan autentikasi sebelum digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan server MCP jarak jauh Google dan Google Cloud, lihat Ringkasan server MCP Google Cloud.

Endpoint Server

Endpoint layanan MCP adalah alamat jaringan dan antarmuka komunikasi (biasanya URL) server MCP yang digunakan aplikasi AI (Host untuk klien MCP) untuk membuat koneksi yang aman dan standar. Agen ini adalah titik kontak bagi LLM untuk meminta konteks, memanggil alat, atau mengakses resource. Endpoint MCP Google dapat bersifat global atau regional.

Server MCP Developer Google Pay & Wallet memiliki endpoint MCP global berikut:

  • https://paydeveloper.googleapis.com/mcp

Alat MCP

Alat MCP adalah fungsi atau kemampuan yang dapat dieksekusi yang diekspos server MCP ke aplikasi LLM atau AI untuk melakukan tindakan di dunia nyata.

Alat

Server MCP paydeveloper.googleapis.com memiliki alat berikut:

Alat MCP
search_documentation Menelusuri dan mengambil bagian yang paling relevan dan terbaru dari dokumentasi developer serta contoh kode resmi Google Pay dan Google Wallet.
list_merchants Mengambil daftar semua profil bisnis penjual Google Pay yang terkait dengan akun terautentikasi.
list_google_pay_integrations Menampilkan status saat ini dan detail konfigurasi untuk semua integrasi Google Pay yang terkait dengan ID Penjual tertentu. Fitur ini memberikan masukan langsung tentang status integrasi dan peninjauan dokumen.
create_merchant Membuat penjual baru dengan akun yang diautentikasi. Anda HARUS meminta pengguna untuk memberikan informasi yang diperlukan untuk pembuatan penjual. Jangan panggil alat ini hingga Anda mencoba mengumpulkan informasi yang diperlukan untuk pembuatan penjual. Setelah penjual dibuat, Anda HARUS menampilkan URL Persyaratan Layanan Konsol Bisnis kepada pengguna dan menginstruksikan mereka untuk menyetujuinya sebelum mereka dapat melakukan operasi apa pun pada penjual ini.
create_google_pay_integration Membuat integrasi Google Pay untuk penjual tertentu. Operasi ini mengharuskan pengguna menyetujui Persyaratan Layanan Konsol Bisnis dan Persyaratan Layanan Google Pay API. Anda tidak perlu memeriksanya secara dini. Jika belum disetujui, panggilan alat akan gagal dan pesan error akan berisi URL Persyaratan Layanan tertentu yang harus disetujui. Jika hal ini terjadi, tampilkan URL kepada pengguna untuk disetujui, dan instruksikan mereka untuk mencoba lagi setelah disetujui. Ikuti urutan ini untuk berinteraksi dengan pengguna SEBELUM memanggil alat: 1. Pertama, minta pengguna untuk item integrasi (Saat ini hanya integrasi Web yang didukung). - Minta URL situs. # - Jika item integrasi adalah Integrasi aplikasi, minta nama paket aplikasi Android. 2. Kemudian, minta pengguna untuk memilih jenis integrasi: - Minta pengguna memilih Gateway jika mereka menggunakan salah satu Penyedia Layanan Pembayaran (PSP) yang didukung: https://developers.google.com/pay/api#participating-processors, atau pilih Langsung. 3. Untuk SEMUA jenis integrasi (Langsung atau Gateway): - Minta pengguna mengupload screenshot (maks. 1 MB) alur pembelian mereka yang terintegrasi dengan Google Pay API. Alur pembelian mereka harus ditinjau dan disetujui sebelum mereka diberi akses produksi penuh. Contoh: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Anda HARUS meminta pengguna untuk memberikan 5 screenshot pendukung. Minta mereka SATU PER SATU untuk memastikan pemetaan yang benar. Gunakan HANYA deskripsi enum yang mudah digunakan saat bertanya. 4. Jika jenis integrasinya adalah Langsung: - Anda JUGA HARUS meminta pengguna untuk memberikan dokumen pengesahan PCI dalam format PDF. Gunakan HANYA deskripsi enum yang mudah digunakan saat bertanya. 5. Untuk setiap file yang diberikan, minta pengguna untuk memberikan jalur atau nama dokumen jika berada di direktori saat ini. Petakan ke DocumentType yang benar dan tetapkan kolom nama ke nama deskriptif (misalnya, item_selection.png atau pci_attestation.pdf) dalam permintaan. Jangan panggil alat ini hingga Anda mencoba mengumpulkan dokumen yang diperlukan untuk jenis integrasi yang dipilih.
list_pass_issuers Mengambil daftar lengkap semua penerbit kartu yang terdaftar di konsol bisnis Google Wallet yang terkait dengan pengguna terautentikasi. Alat ini memberikan informasi penting bagi developer yang mengelola kartu Wallet seperti kartu loyalitas, kartu voucher, atau penerbangan.
list_pass_classes Mengambil daftar lengkap semua class kartu yang terdaftar di konsol bisnis Google Wallet yang terkait dengan pengguna terautentikasi. Alat ini memberikan informasi penting bagi developer yang mengelola kartu Wallet seperti kartu loyalitas, kartu voucher, atau penerbangan.
validate_pass_jwt Memvalidasi representasi JWT kartu, atau payload JWT yang tidak dienkode sebagai string JSON untuk kartu.
query_merchant_performance Mengambil data performa gabungan tingkat tinggi dan metrik pasca-integrasi untuk profil bisnis penjual tertentu.
query_merchant_error_metrics Mengambil metrik error mendetail untuk profil bisnis penjual tertentu. Alat ini memberikan perincian error yang terperinci, sehingga developer dapat mengidentifikasi dan menyelesaikan masalah.

Mendapatkan spesifikasi alat MCP

Untuk mendapatkan spesifikasi alat MCP untuk semua alat di server MCP, gunakan metode tools/list. Contoh berikut menunjukkan cara menggunakan curl untuk mencantumkan semua alat dan spesifikasinya yang saat ini tersedia dalam server MCP.

Permintaan Curl
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'