MCP Reference: paydeveloper.googleapis.com

Ini adalah server MCP yang menyediakan alat untuk developer Pembayaran.

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 oleh aplikasi AI.

Penyiapan Server

Anda harus mengaktifkan server MCP dan menyiapkan autentikasi sebelum digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan 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 API 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 lengkap semua penjual Google Pay yang terkait dengan akun terautentikasi. Bergantung pada peran pengguna di penjual, admin dapat melihat informasi penjual yang detail dan lengkap, sedangkan developer hanya dapat melihat informasi penjual dasar.
list_google_pay_integrations Menampilkan status saat ini dan detail konfigurasi untuk semua integrasi Google Pay yang terkait dengan ID Penjual tertentu. Alat ini memberikan masukan langsung tentang status integrasi dan ulasan dokumen. Selain itu, Anda HARUS memberi tahu pengguna bahwa integrasi dapat dibuat/diperbarui di Konsol Google Pay & Wallet (https://pay.google.com/business/console/).
create_merchant Membuat penjual baru dengan akun terautentikasi. Anda HARUS meminta pengguna untuk memberikan informasi yang diperlukan untuk pembuatan penjual. Salah satu kolom yang wajib diisi adalah Kode Kategori Penjual (MCC). Karena daftar MCC panjang, Anda dapat menampilkan subset opsi umum, tetapi Anda HARUS memberi tahu pengguna bahwa ada lebih banyak opsi yang tersedia dan mereka dapat meminta daftar lengkap (misalnya, dengan menampilkan "X opsi lainnya" atau petunjuk serupa). Selain itu, beri tahu pengguna bahwa mereka dapat langsung memberikan kode MCC 4 digit (misalnya, 5499) jika sudah mengetahuinya, dan mendorong mereka untuk menggunakannya. 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.
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.
update_merchant Memperbarui kolom tertentu dari penjual yang ada. Kolom yang didukung mencakup display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email, dan customer_support_phone.
list_principals Mencantumkan entity utama (pengguna) yang memiliki akses ke penjual tertentu. Operasi ini memerlukan akses Admin untuk penjual.
set_principal_role Menetapkan peran entity utama (pengguna) pada penjual, atau menambahkan entity utama baru dengan peran yang ditentukan. Entity utama akan dikirimi undangan email dan harus menerimanya sebelum aksesnya menjadi aktif. Operasi ini memerlukan akses Admin untuk penjual.
delete_principal Menghapus akses entity utama (pengguna) ke penjual tertentu. Operasi ini memerlukan akses Admin untuk penjual.

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
}'