Google Pay ve Cüzdan Geliştirici MCP sunucusuna bağlanma

Önizleme

Bu ürün, Hizmete Özel Şartlar'ın Genel Hizmet Şartları bölümündeki "Genel Kullanıma Sunulma Tarihi Öncesi Tekliflere İlişkin Şartlar"a tabidir. GKST öncesi ürünler "olduğu gibi" sunulur ve desteği sınırlı olabilir. Daha fazla bilgi için lansman aşaması açıklamalarına bakın.

Google Pay ve Cüzdan Geliştirici MCP sunucusu, yapay zeka destekli geliştirici araçlarının Google Pay ve Google Cüzdan geliştirici verilerinize erişmesine, resmi belgelerde arama yapmasına ve entegrasyonlarınızı yönetmesine olanak tanır.

Model Context Protocol (MCP), büyük dil modellerinin (LLM'ler) ve yapay zeka uygulamalarının veya temsilcilerinin harici veri kaynaklarına nasıl bağlanacağını standartlaştırır. MCP sunucuları, araçlarını, kaynaklarını ve istemlerini kullanarak harekete geçmenize ve arka uç hizmetlerinden güncellenmiş veriler almanıza olanak tanır.

Google Pay ve Cüzdan Geliştirici MCP sunucusu ile şunları yapabilirsiniz:

• Belgelerde arama yapma: Resmi Google Pay ve Google Cüzdan belgelerinden güncel kılavuzlar ve kod örnekleri alın.
• Entegrasyonları yönetme: Entegrasyonlarınızın durumunu kontrol edin ve satıcı hesabınız için API'leri etkinleştirin.
• Performansı izleme: Satıcı hesabınız için toplu performans verilerine ve hata metriklerine erişin.

• Kartları yönetme: Google Cüzdan için kart verenleri ve sınıfları listeler.

  Not: Kullanılabilir MCP araçlarının ayrıntılarını ve açıklamalarını görüntülemek için Pay & Wallet Developer referansını inceleyin.

Örnek istemler

Yapay zeka asistanınızla aşağıdaki istemleri kullanabilirsiniz:

• "Google Pay hesaplarımı listele."
• "Google Pay entegrasyonlarımın durumu nedir?"
• "Google Pay'i React ile nasıl entegre edebilirim?"
• "Son 30 gün içinde entegrasyonumla ilgili Google Pay hata metriklerini göster."
• "Google Cüzdan kart sınıflarımı listele."

Başlamadan önce

Google Pay ve Cüzdan Developer MCP sunucusunu kullanmak için bir Google Cloud projesi oluşturmanız ve Google Pay ve Cüzdan Developer MCP sunucusunu etkinleştirmeniz gerekir.

1. Cloud Console'unuzdaki proje seçici sayfasında bir Google Cloud projesi seçin veya oluşturun.

   Proje seçiciye git

2. Pay & Wallet Developer API'yi etkinleştirin (henüz etkinleştirilmemişse).

   API'leri etkinleştirmek için gereken roller

   API'leri etkinleştirmek için serviceusage.services.enable iznine ihtiyacınız vardır. Projeyi siz oluşturduysanız muhtemelen Sahip rolü (roles/owner) aracılığıyla bu izne zaten sahipsinizdir. Aksi takdirde bu izni Service Usage Yöneticisi rolü (roles/serviceusage.serviceUsageAdmin) aracılığıyla alabilirsiniz. Rolleri nasıl vereceğinizi öğrenin.

   API'yi etkinleştirme

Kimlik doğrulama ve yetkilendirme

Google Pay ve Cüzdan Geliştirici MCP sunucusu, kimlik doğrulama ve yetkilendirme için Identity and Access Management (IAM) ile OAuth 2.0 protokolünü kullanır. MCP sunucularında kimlik doğrulama için tüm kimlikleri desteklenir.

Google Pay ve Cüzdan Geliştirici MCP sunucusu API anahtarlarını kabul etmez.

Kaynaklara erişimin kontrol edilebilmesi ve izlenebilmesi için MCP araçlarını kullanan temsilcilere ayrı bir kimlik oluşturmanızı öneririz. Kimlik doğrulama hakkında daha fazla bilgi için MCP sunucularında kimlik doğrulama başlıklı makaleyi inceleyin.

Google Pay ve Cüzdan Geliştirici MCP sunucusu OAuth kapsamları

OAuth 2.0, kimliği doğrulanmış bir kullanıcının bir kaynak üzerinde belirli bir işlemi yapma yetkisi olup olmadığını belirlemek için kapsamları ve kimlik bilgilerini kullanır. Google'da OAuth 2.0 kapsamları hakkında daha fazla bilgi için Google API'lerine erişmek için OAuth 2.0'ı kullanma başlıklı makaleyi okuyun.

Google Pay ve Cüzdan Geliştirici MCP sunucusunda aşağıdaki MCP aracı OAuth kapsamları bulunur:

gcloud CLI için kapsam URI'si	Açıklama
https://www.googleapis.com/auth/paydeveloper.merchant	Google Pay satıcı verilerini yönetin.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	Google Cüzdan'daki kartı veren verilerini okuma

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturma

OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturmak için aşağıdaki adımları uygulayın:

1. Google API Konsolu'nda Google Auth Platform > Clients > Create client'a (Google Auth Platform > İstemciler > İstemci oluştur) gidin.

   İstemci oluşturma sayfasına gitme

   Henüz bir uygulamanız yoksa Google Auth Platform'da yeni bir uygulama oluşturmanız gerekir. Genel bakış sayfasında "Başlayın" düğmesini tıklayın ve gerekli bilgileri doldurun.

2. Uygulama türü listesinde yapay zeka uygulamanız için uygun türü seçin:

   • Cursor Desktop, Claude Code, Claude.ai, ChatGPT ve Antigravity için Web uygulaması'nı seçin.
   • Antigravity CLI, Antigravity IDE ve VS Code için Masaüstü uygulaması'nı seçin.

3. Name (Ad) alanına uygulamanız için bir ad girin.

4. Web uygulaması'nı seçtiyseniz Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve ardından yapay zeka uygulamanız için gerekli yönlendirme URI'sini ekleyin:

   Masaüstü İmleci

   http://localhost:8787/callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   Claude.ai

   https://claude.ai/api/mcp/auth_callback

   ChatGPT

   redirect_uri alanını şimdilik boş bırakabilirsiniz. ChatGPT, uygulama oluşturulduğunda bir redirect_uri oluşturur (aşağıdaki Yapay zeka uygulamanızı yapılandırma bölümüne bakın).

   Not: Yetkilendirilmiş JavaScript kaynakları bölümünde + URI ekle'yi tıklayın ve ardından URI'ler alanına https://chatgpt.com değerini ekleyin.

   Antigravity

   https://antigravity.google/oauth-callback

5. Oluştur'u tıklayın. İstemci gizli anahtarı oluşturulduktan sonra bir kez gösterilir. Kodu kopyalayıp güvenli bir yerde saklayın.

Yapay zeka uygulamanızı yapılandırma

Ardından, yapay zeka uygulamanıza sunucu yapılandırma ayrıntılarını sağlamanız gerekir.

VS Code

1. Sohbet yan panelinin üst kısmındaki simgesini tıklayın ve MCP Sunucuları'na gidin.
2. Sunucu ekle düğmesini () tıklayın, HTTP'yi seçin ve Pay & Wallet Developer MCP sunucusuna yönlendiren URL'yi girin: https://paydeveloper.googleapis.com/mcp.
   MCP yapılandırmanız, çalışma alanınızdaki .vscode/mcp.json dosyasına kaydedilir:

   {
     "servers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp"
       }
     }
   }

3. Yeni MCP sunucusunu sağ tıklayın ve Start Server'ı (Sunucuyu Başlat) seçin.
4. Kimlik doğrulama sürecini tetiklemek için sohbet penceresine geri dönün ve MCP sunucusunda bir araç çağırın. Örneğin: "Google Pay hesaplarımı listele".
5. Dynamic Client Registration desteklenmiyor iletişim kutusu beklendiği gibi açılır. İletişim kutusunu kapatmak için herhangi bir düğmeyi tıklayın.
6. OAuth istemci kimliğinizi girip Enter tuşuna basın.
7. İstendiğinde OAuth istemci gizli anahtarınızı girin ve Enter tuşuna basın.
8. Kimlik doğrulama için bir iletişim kutusu açılır. İzin ver'i tıklayın.
9. Kimliği doğrulanmış kimlikler listesinden seçim yapabilir veya yeni bir hesapla oturum açabilirsiniz.
10. Kimlik doğrulama işleminden sonra araç çağrılır ve oturum sohbet penceresinde devam eder.

Cursor Desktop

Cursor Desktop'ı yapılandırmak için:

1. Sol taraftaki panelde Özelleştir'i tıklayın.
2. Yeni MCP Sunucusu'nu tıklayın. Bu işlem, mcp.json yapılandırma dosyasını açar.
3. Google Pay ve Cüzdan Geliştirici MCP sunucusunu eklemek için yapılandırma ayrıntılarını girin:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
           "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
         }
       }
     }
   }

4. Dosya kaydedildikten sonra MCP sunucularının listesi güncellenir.
5. Kimlik doğrulama sürecini başlatmak için Kimlik doğrula'yı tıklayın.

Claude Code

Claude Code'u yapılandırmak için aşağıdaki komutu çalıştırın:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

Claude.ai

Claude.ai'yi yapılandırmak için:

1. Özelleştir > Bağlayıcılar'a gidin.
2. Ekle'yi tıklayın ve Özel bağlayıcı ekle'yi seçin.
3. Aşağıdaki ayrıntıları girin:
   Sunucu adı: Google Pay & Wallet MCP.
   Uzak MCP sunucu URL'si https://paydeveloper.googleapis.com/mcp.
4. Gelişmiş ayarlar bölümünde OAuth istemci kimliğinizi ve OAuth istemci gizli anahtarınızı girin.
5. Yeni bağlayıcıyı seçin ve Bağlan'ı tıklayın.

ChatGPT

ChatGPT'yi yapılandırmak için:

1. Ayarlar > Güvenlik ve giriş bölümünden Geliştirici modunu etkinleştirin.
2. Ana yan panelde Eklentiler'i seçin ve düğmesini tıklayın.
3. Aşağıdaki ayrıntıları girin:
   Ad: Google Pay & Wallet MCP.
   Sunucu URL'si: https://paydeveloper.googleapis.com/mcp
4. Gelişmiş ayarlar'a gidin ve OAuth istemci kimliğinizi ve gizli anahtarınızı girin.
5. Dinamik geri çağırma URL'sini kopyalayın ve önceki adımda oluşturulan OAuth istemcisine ekleyin.

Antigravity CLI

1. Antigravity CLI'yı yapılandırmak için ~/.gemini/config/mcp_config.json dosyanıza aşağıdakileri ekleyin:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "AGY_CLI_CLIENT_ID",
           "clientSecret": "AGY_CLI_CLIENT_SECRET"
         }
       }
     }
   }

2. /mcp komutunu çalıştırın, yeni MCP sunucunuzu seçin ve kimlik doğrulama sürecini başlatmak için Kimlik doğrula'yı seçin.

Antigravity IDE

1. Düzenleyicinin aracı yan panelinin üst kısmındaki simgesini tıklayın ve MCP Sunucuları'nı seçin.
2. MCP Sunucularını Yönet'i tıklayın.
3. View raw config'i (Ham yapılandırmayı görüntüle) tıklayın ve MCP sunucunuzun ayrıntılarını ekleyin:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
         }
       }
     }
   }

4. Antigravity IDE'ye dönün ve Yenile'yi tıklayın.
5. Yeni MCP sunucunuzu seçip Kimlik doğrula'yı tıklayın ve kimlik doğrulama akışını tamamlayın.
6. Yetkilendirme kodunu kopyalayın ve Antigravity Ayarları penceresinde gönderin.

Antigravity

1. Antigravity'de Ayarlar > Özelleştirmeler'e gidin.
2. Installed MCP Servers (Yüklü MCP Sunucuları) bölümünde, mcp_config.json dosyasını düzenlemek için Open MCP Config'i (MCP Yapılandırmasını Aç) tıklayın:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }

3. Antigravity'ye dönün ve Yenile'yi tıklayın.
4. Kimlik doğrula'yı tıklayın ve kimlik doğrulama akışını tamamlayın.
5. Yetkilendirme kodunu kopyalayın ve Antigravity Ayarları penceresinde gönderin.

Bilinen sınırlamalar

• Yalnızca İngilizce sonuçlar: Doküman arama yalnızca İngilizce dilini destekler.
• EKL'nin arkasındaki içerik: EKL'lerin arkasındaki dokümanlar dizine eklenmez.
• Ağa bağlı: Sunucu, Google Pay ve Cüzdan hizmetlerine canlı bağlantı gerektirir.

Hizmet Şartları

Google Pay API'nin kullanımı Google Pay Hizmet Şartları'na tabidir. Google Cüzdan API'sinin kullanımı, Google Cüzdan API Hizmet Şartları'na tabidir.