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, menerjemahkan responsnya ke dalam format yang dapat dipahami 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. Endpoint ini adalah titik kontak untuk LLM guna meminta konteks, memanggil alat, atau mengakses resource. Endpoint MCP Google dapat bersifat global atau regional.

Server MCP Google Pay &Wallet Developer 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 LLM atau aplikasi 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 dan contoh kode Google Pay dan Google Wallet resmi.
list_merchants Mengambil daftar semua profil bisnis penjual Google Pay yang terkait dengan akun terautentikasi.
list_google_pay_integrations Menampilkan status dan detail konfigurasi saat ini untuk semua integrasi Google Pay yang terkait dengan ID Penjual tertentu. Alat ini memberikan masukan langsung tentang status integrasi dan peninjauan dokumen.
create_merchant Membuat penjual baru dengan akun terautentikasi. 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 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 memeriksa hal ini secara proaktif. Jika belum disetujui, panggilan alat akan gagal dan pesan error akan berisi URL Persyaratan Layanan tertentu yang perlu 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 item integrasi kepada pengguna (Hanya integrasi Web yang didukung untuk saat ini). - Minta URL situs. # - Jika item integrasi adalah integrasi Aplikasi, minta nama paket aplikasi Android. 2. Kemudian, minta jenis integrasi kepada pengguna: - Beri tahu pengguna untuk memilih Gateway jika mereka menggunakan salah satu Penyedia Layanan Pembayaran (PSP) yang didukung: https://developers.google.com/pay/api#participating-processors, jika tidak, pilih Langsung. 3. Untuk SEMUA jenis integrasi (Langsung atau Gateway): - Beri tahu pengguna untuk 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 screenshot SATU PER SATU untuk memastikan pemetaan yang benar. Gunakan HANYA deskripsi enum yang mudah digunakan saat meminta. 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 meminta. 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 hadiah, 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 hadiah, 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 mendetail, sehingga developer dapat menemukan 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
}'