Model Context Protocol (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ştirmeniz ve kimlik doğrulamayı ayarlamanız gerekir. 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ı oluşturmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). Bu uç nokta, 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ı genel veya bölgesel olabilir.
Google Pay ve Cüzdan Geliştirici MCP sunucusunun aşağıdaki küresel 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 bulunur:
| MCP Araçları | |
|---|---|
search_documentation |
Resmi Google Pay ve Google Cüzdan geliştirici belgelerindeki ve kod örneklerindeki en alakalı ve güncel bölümleri arar ve alır. |
list_merchants |
Kimliği doğrulanmış hesapla ilişkili tüm Google Pay satıcı işletme profillerinin listesini alır. |
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. |
create_merchant |
Kimliği doğrulanmış hesapla yeni bir satıcı oluşturur. Kullanıcıdan satıcı oluşturma için gerekli bilgileri sağlamasını İSTEMELİSİNİZ. 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ıyla ilgili herhangi bir işlem yapabilmesi için ÖNCELİKLE İşletme Konsolu Hizmet Şartları URL'sini göstermeniz ve kullanıcının bu URL'yi kabul etmesini sağlamanız GEREKİR. |
create_google_pay_integration |
Belirli bir satıcı için Google Pay entegrasyonu oluşturur. Bu işlem için kullanıcının İşletme Konsolu Hizmet Şartları'nı ve Google Pay API Hizmet Şartları'nı kabul etmiş olması gerekir. Bunları önceden kontrol etmeniz gerekmez. Kabul edilmemişse araç çağrısı başarısız olur ve hata mesajında kabul edilmesi gereken belirli Hizmet Şartları URL'leri yer alır. Bu durumda, URL'leri kullanıcıya kabul etmesi için gösterin ve kabul edildikten sonra tekrar denemesini isteyin. Aracı çağırmadan ÖNCE kullanıcıyla etkileşim kurmak için şu sırayı izleyin: 1. Öncelikle kullanıcıdan entegrasyon öğesini isteyin (Şu an için yalnızca web entegrasyonu desteklenmektedir). - Web sitesinin URL'sini isteyin. # - Entegrasyon öğesi uygulama entegrasyonuysa Android uygulama paketi adını isteyin. 2. Ardından, kullanıcıya entegrasyon türünü sorun: - Kullanıcıya, desteklenen ödeme hizmeti sağlayıcılarımızdan (PSP'ler: https://developers.google.com/pay/api#participating-processors) birini kullanıyorsa Gateway'i, aksi takdirde Direct'i seçmesini söyleyin. 3. TÜM entegrasyon türleri (Doğrudan veya Ağ Geçidi) için: - Kullanıcıya, Google Pay API ile entegre edilmiş satın alma sürecinin ekran görüntülerini (en fazla 1 MB) yüklemesini söyleyin. Tam üretim erişimi verilmeden önce satın alma süreçlerinin incelenip onaylanması gerekir. Örnekler: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Kullanıcıdan 5 destekleyici ekran görüntüsü sağlamasını İSTEMELİSİNİZ. Doğru eşleme için bunları TEK TEK isteyin. Soru sorarken YALNIZCA kullanıcı dostu enum açıklamalarını kullanın. 4. Entegrasyon türü Doğrudan ise: - KULLANICIDAN PCI onay belgesini PDF biçiminde sağlamasını İSTEMELİSİNİZ. Soru sorarken YALNIZCA kullanıcı dostu enum açıklamasını kullanın. 5. Sağlanan her dosya için kullanıcıdan, geçerli dizindeyse belge yolunu veya adını vermesini isteyin. İsteği doğru DocumentType ile eşleyin ve ad alanını açıklayıcı bir adla (ör. item_selection.png veya pci_attestation.pdf) ayarlayın. Seçilen entegrasyon türü için gerekli belgeleri toplamayı denemeden bu aracı çağırmayın. |
list_pass_issuers |
Kimliği doğrulanmış kullanıcıyla ilişkili Google Cüzdan işletme konsolunda kayıtlı tüm kart verenlerin kapsamlı bir listesini alır. Bu araç, bağlılık kartları, hediye kartları veya uçuşlar gibi Cüzdan kartlarını yöneten geliştiriciler için gerekli bilgileri 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ç, bağlılık kartları, hediye kartları veya uçuşlar gibi Cüzdan kartlarını yöneten geliştiriciler için gerekli bilgileri sağlar. |
validate_pass_jwt |
Bir kartın JWT gösterimini veya bir kartın 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ü sunarak geliştiricilerin sorunları belirleyip çözmesine olanak tanır. |
MCP aracı özelliklerini edinme
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 }' |