Bu, geliştiricilere ödeme yapmak için araçlar sağlayan bir MCP sunucusudur.
Model Bağlam Protokolü (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.
Sunucu Kurulumu
Kullanmadan önce MCP sunucularını etkinleştirmelisiniz ve kimlik doğrulamasını kurmalısınız. Google ve Google Cloud uzaktan MCP sunucularını kullanma hakkında daha fazla bilgi için Google Cloud MCP sunucularına genel bakış başlıklı makaleyi inceleyin.
Sunucu Uç Noktaları
MCP hizmeti uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standartlaştırılmış bir bağlantı kurmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). LLM'nin bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için kullandığı iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.
Google Pay ve Cüzdan Geliştirici MCP sunucusu API'sinin aşağıdaki genel MCP uç noktası vardır:
- https://paydeveloper.googleapis.com/mcp
MCP Araçları
MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.
Araçlar
paydeveloper.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunmaktadır:
| MCP Araçları | |
|---|---|
search_documentation |
Google Pay ve Google Cüzdan'ın resmi geliştirici belgelerinden ve kod örneklerinden en alakalı ve güncel bölümleri arar ve getirir. |
list_merchants |
Kimliği doğrulanmış hesapla ilişkili tüm Google Pay satıcılarının kapsamlı bir listesini alır. Kullanıcının satıcıdaki rolüne bağlı olarak, yöneticiler satıcıya ait tüm detaylı bilgilere erişebilirken, geliştiriciler yalnızca temel satıcı bilgilerini görüntüleyebilir. |
list_google_pay_integrations |
Belirli bir satıcı kimliğiyle ilişkili tüm Google Pay entegrasyonlarının mevcut durumunu ve yapılandırma ayrıntılarını döndürür. Entegrasyon ve belge incelemelerinin durumu hakkında anında geri bildirim sağlar. Ayrıca, kullanıcıyı entegrasyonun Google Pay ve Cüzdan Konsolu'nda (https://pay.google.com/business/console/) oluşturulabileceği/güncellenebileceği konusunda bilgilendirmeniz ZORUNLUDUR. |
create_merchant |
Kimliği doğrulanmış hesapla yeni bir satıcı oluşturur. Satıcı oluşturmak için gerekli bilgileri kullanıcıdan istemeniz ZORUNLUDUR. Zorunlu alanlardan biri satıcı kategorisi kodudur (MCC). MCC'lerin listesi uzun olduğundan, yaygın seçeneklerin bir alt kümesini sunabilirsiniz, ancak kullanıcıya daha fazla seçeneğin mevcut olduğunu ve tam listeyi isteyebileceklerini mutlaka bildirmelisiniz (örneğin "X daha fazla seçenek" veya benzeri bir ipucu göstererek). Ayrıca, kullanıcıyı 4 haneli MM kodunu (ör. 5499) biliyorsa doğrudan sağlayabileceği konusunda bilgilendirin ve bu kodu kullanmaya teşvik edin. Satıcı oluşturma için gerekli bilgileri toplamayı denemeden bu aracı çağırmayın. Satıcı oluşturulduktan sonra, kullanıcının bu satıcı üzerinde herhangi bir işlem yapabilmesi için İşletme Konsolu Hizmet Şartları URL'sini kullanıcıya göstermeniz ve kabul etmesini istemeniz GEREKMEKTEDİR. |
list_pass_issuers |
Kimliği doğrulanmış kullanıcıyla ilişkili Google Cüzdan işletme konsoluna kayıtlı tüm kart verenlerin kapsamlı bir listesini alır. Bu araç, sadakat kartları, hediye kartları veya uçuşlar gibi Wallet geçiş kartlarını yöneten geliştiriciler için temel bilgiler sağlar. |
list_pass_classes |
Kimliği doğrulanmış kullanıcıyla ilişkili Google Cüzdan işletme konsolunda kayıtlı tüm kart sınıflarının kapsamlı bir listesini alır. Bu araç, sadakat kartları, hediye kartları veya uçuşlar gibi Wallet geçiş kartlarını yöneten geliştiriciler için temel bilgiler sağlar. |
validate_pass_jwt |
Bir geçiş kartının JWT temsilini veya bir geçiş kartı için kodlanmamış JWT yükünü JSON dizesi olarak doğrular. |
query_merchant_performance |
Belirli bir satıcının işletme profili için üst düzey toplu performans verilerini ve entegrasyon sonrası metrikleri alır. |
query_merchant_error_metrics |
Belirli bir satıcı işletme profili için ayrıntılı hata metriklerini alır. Bu araç, hataların ayrıntılı bir dökümünü sağlayarak geliştiricilerin sorunları tespit edip çözmelerine olanak tanır. |
update_merchant |
Mevcut bir satıcının belirli alanlarını günceller. Desteklenen alanlar arasında display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email ve customer_support_phone bulunur. |
list_principals |
Belirli bir satıcıya erişimi olan yetkilileri (kullanıcıları) listeler. Bu işlem için satıcının yönetici erişimi gerekir. |
set_principal_role |
Bir satıcıdaki asıl kullanıcının rolünü ayarlar veya belirtilen role sahip yeni bir asıl kullanıcı ekler. Müdüre e-postayla davetiye gönderilir ve erişiminin etkinleşmesi için davetiyeyi kabul etmesi gerekir. Bu işlem için satıcının yönetici erişimi gerekir. |
delete_principal |
Bir asılın (kullanıcının) belirli bir satıcıya erişimini siler. Bu işlem için satıcının yönetici erişimi gerekir. |
MCP aracı özelliklerini alma
Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.
| Curl İsteği |
|---|
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 }' |