الاتصال بخادم MCP الخاص بـ Google Pay وWallet Developer

معاينة

يخضع هذا المنتج لفقرة "أحكام عروض مرحلة ما قبل التوفّر للجمهور العام" الواردة في فقرة "بنود الخدمة العامة" من بنود الخدمة الخاصة. تتوفّر المنتجات في مرحلة ما قبل التوفّر للجمهور العام "كما هي"، وقد يقتصر دعمها على نطاق محدود. لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

يمنح خادم MCP الخاص بمطوّري Google Pay و"محفظة Google" أدوات التطوير المستندة إلى الذكاء الاصطناعي إمكانية الوصول إلى بيانات المطوّرين في Google Pay و"محفظة Google" والبحث في المستندات الرسمية وإدارة عمليات الدمج.

يضع معيار بروتوكول سياق النموذج (MCP) أسسًا موحّدة لكيفية ربط النماذج اللغوية الكبيرة (LLM) وتطبيقات الذكاء الاصطناعي أو الوكلاء بمصادر البيانات الخارجية. تتيح لك خوادم MCP استخدام أدواتها ومواردها وطلباتها لاتخاذ إجراءات والحصول على بيانات محدّثة من خدمتها الخلفية.

يتيح لك خادم MCP الخاص بمطوّري Google Pay و"محفظة Google" ما يلي:

• مستندات البحث: يمكنك الحصول على إرشادات ونماذج رموز برمجية حديثة من مستندات Google Pay و"محفظة Google" الرسمية.
• إدارة عمليات الدمج: يمكنك الاطّلاع على حالة عمليات الدمج وتفعيل واجهات برمجة التطبيقات لحساب التاجر.
• تتبُّع الأداء: يمكنك الوصول إلى بيانات الأداء المجمّعة ومقاييس الأخطاء لحساب التاجر.

• إدارة البطاقات: تعرض هذه الصفحة قائمة بجهات إصدار البطاقات وفئاتها في "محفظة Google".

  ملاحظة: راجِع مرجع Pay & Wallet Developer للاطّلاع على تفاصيل أدوات MCP المتاحة وأوصافها.

نماذج الطلبات

يمكنك استخدام الطلبات التالية مع المساعد المستند إلى الذكاء الاصطناعي:

• "أدرِج حساباتي على Google Pay".
• "ما هي حالة عمليات الدمج في Google Pay؟"
• "كيف يمكنني دمج Google Pay مع React؟"
• "أرِني مقاييس أخطاء Google Pay لعملية الدمج التي أجريتها خلال آخر 30 يومًا".
• "أدرِج فئات البطاقات في محفظة Google".

قبل البدء

لاستخدام خادم MCP الخاص بأداة Google Pay & Wallet Developer، يجب إنشاء مشروع على Google Cloud وتفعيل خادم MCP الخاص بأداة Google Pay & Wallet Developer وواجهات برمجة التطبيقات Google Wallet API.

1. في Cloud Console، ضِمن صفحة اختيار المشروع، اختَر مشروعًا على Google Cloud أو أنشِئ مشروعًا.

   الانتقال إلى أداة اختيار المشاريع

2. فعِّل واجهات برمجة التطبيقات Pay & Wallet Developer وGoogle Wallet APIs.

   الأدوار المطلوبة لتفعيل واجهات برمجة التطبيقات

   لتفعيل واجهات برمجة التطبيقات، يجب أن يكون لديك دور "مشرف استخدام الخدمة" في إدارة الهوية وإمكانية الوصول (IAM) (roles/serviceusage.serviceUsageAdmin)، والذي يتضمّن الإذن serviceusage.services.enable. كيفية منح الأدوار

   تفعيل واجهات برمجة التطبيقات

الأدوار المطلوبة

للحصول على الأذونات اللازمة لاستخدام خادم MCP البعيد الخاص بخادم Google Pay & Wallet Developer MCP، اطلب من المشرف منحك أدوار Identity and Access Management (IAM) التالية في مشروع على السحابة الإلكترونية من Google Cloud الذي تريد تفعيل خادم MCP الخاص بخادم Google Pay & Wallet Developer MCP فيه:

• إجراء مكالمات أداة MCP: مستخدم أداة MCP (roles/mcp.toolUser)

لمزيد من المعلومات حول منح الأدوار، يُرجى الاطّلاع على إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.

المصادقة والتفويض

تستخدم خوادم MCP في Google Pay و"محفظة Google" بروتوكول OAuth 2.0 مع إدارة الهوية وإمكانية الوصول (IAM) للمصادقة والتفويض. تتوافق جميع الهويات مع عملية المصادقة على خوادم MCP.

لا يقبل خادم MCP الخاص بـ Google Pay & Wallet Developer مفاتيح واجهة برمجة التطبيقات.

ننصح بإنشاء هوية منفصلة للوكلاء باستخدام أدوات MCP حتى يمكن التحكّم في الوصول إلى الموارد ومراقبته. لمزيد من المعلومات حول المصادقة، يُرجى الاطّلاع على المصادقة على خوادم MCP.

نطاقات OAuth لخادم MCP في Google Pay & Wallet Developer

يستخدم الإصدار 2.0 من OAuth النطاقات وبيانات الاعتماد لتحديد ما إذا كان يمكن لجهة أساسية تمت المصادقة عليها اتخاذ إجراء محدّد بشأن أحد الموارد. لمزيد من المعلومات حول نطاقات OAuth 2.0 في Google، يُرجى قراءة مقالة استخدام بروتوكول OAuth 2.0 للدخول إلى واجهات Google APIs.

يحتوي خادم MCP الخاص بأدوات مطوّري Google Pay و"محفظة Google" على نطاقات OAuth التالية لأداة MCP:

معرّف الموارد المنتظم للنطاق في gcloud CLI	الوصف
https://www.googleapis.com/auth/paydeveloper.merchant	إدارة بيانات التجّار في Google Pay
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	قراءة بيانات جهة إصدار البطاقة في "محفظة Google"

إنشاء معرّف عميل وسر لبروتوكول OAuth 2.0

لإنشاء معرّف عميل وسرّ عميل OAuth 2.0، اتّبِع الخطوات التالية:

1. في Google API Console، انتقِل إلى منصة Google Auth‏ > العملاء > إنشاء عميل.

   الانتقال إلى "إنشاء عميل"

   عليك إنشاء تطبيق جديد في "منصة Google للمصادقة" إذا لم يكن لديك تطبيق. انقر على الزر "البدء" في صفحة النظرة العامة، ثم املأ المعلومات اللازمة.

2. في قائمة نوع التطبيق، اختَر النوع المناسب لتطبيق الذكاء الاصطناعي:

   • بالنسبة إلى Antigravity وClaude.ai وClaude Code وChatGPT، اختَر تطبيق ويب.
   • بالنسبة إلى Gemini CLI وVS Code، اختَر تطبيق سطح المكتب.

3. في حقل الاسم، أدخِل اسمًا لتطبيقك.

4. إذا اخترت تطبيق ويب، في قسم معرّفات الموارد المنتظمة (URI) المسموح بها لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أضِف معرّف الموارد المنتظمة (URI) المطلوب لإعادة التوجيه لتطبيق الذكاء الاصطناعي:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

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

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   يمكنك ترك الحقل redirect_uri فارغًا في الوقت الحالي. ينشئ ChatGPT redirect_uri عند إنشاء التطبيق (راجِع ضبط تطبيق الذكاء الاصطناعي أدناه).

   ملاحظة: في قسم مصادر JavaScript المسموح بها، انقر على + إضافة معرّف الموارد المنتظم (URI)، ثم أضِف https://chatgpt.com في الحقل معرّفات الموارد المنتظمة (URI).

5. انقر على إنشاء. عند إنشاء سرّ العميل، يتم عرضه مرة واحدة. انسخها واحفظها في مكان آمن.

إعداد تطبيق الذكاء الاصطناعي

بعد ذلك، عليك تزويد تطبيق الذكاء الاصطناعي بتفاصيل إعدادات الخادم.

Gemini CLI

1. لضبط إعدادات Gemini CLI، أضِف ما يلي إلى الملف `~/.gemini/settings.json`:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "httpUrl": "https://paydeveloper.googleapis.com/mcp",
         "authProviderType": "dynamic_discovery",
         "oauth": {
           "enabled": true,
           "clientId": "GEMINI_CLI_CLIENT_ID",
           "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/paydeveloper.merchant",
             "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
           ]
         }
       }
     }
   }

2. نفِّذ الأمر /mcp auth google-pay-wallet-dev لبدء عملية المصادقة لخادم MCP الخاص بمطوّري Google Pay و"محفظة Google".

Antigravity

لضبط Antigravity لاستخدام خادم MCP، اتّبِع الخطوات التالية:

1. في Antigravity، انقر على قائمة خيارات إضافية في لوحة "البرنامج الوكيل" > خوادم MCP > إدارة خوادم MCP.
2. في أعلى لوحة "إدارة خوادم MCP"، انقر على عرض الإعدادات الأولية لتعديل ملف mcp_config.json:

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

3. ارجع إلى إدارة خوادم MCP وانقر على إعادة التحميل. يؤدي النقر على المصادقة إلى فتح علامة التبويب التخصيصات في إعدادات الوكيل.
4. انقر على مصادقة وأكمِل عملية OAuth.
5. انسخ رمز التفويض وأرسِله في نافذة إعدادات الوكيل.

VS Code

1. لضبط إعدادات VS Code (Copilot)، عدِّل ملف .vscode/mcp.json في مساحة العمل:

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

2. استدعِ أداة في خادم MCP لبدء عملية المصادقة. على سبيل المثال: "أدرِج حساباتي على Google Pay".
3. يتم فتح مربّع الحوار التسجيل الديناميكي للعميل غير متاح كما هو متوقّع. انقر على أي زر لإغلاق مربّع الحوار.
4. أدخِل معرّف عميل OAuth واضغط على مفتاح Enter.
5. عندما يُطلب منك ذلك، أدخِل سر عميل OAuth واضغط على Enter.
6. يفتح مربّع حوار للمصادقة، انقر على السماح.
7. بعد منح الإذن، يتم استدعاء الأداة وتستمر الجلسة في نافذة المحادثة.

Claude.ai

لضبط Claude.ai، اتّبِع الخطوات التالية:

1. انتقِل إلى تخصيص > الموصِّلات.
2. انقر على الزر واختَر إضافة موصّل مخصّص.
3. أدخِل التفاصيل التالية:
   اسم الخادم: Google Pay & Wallet MCP.
   عنوان URL لخادم MCP البعيد https://paydeveloper.googleapis.com/mcp.
4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
5. اختَر الموصّل الجديد وانقر على ربط.

Claude Code

لضبط Claude Code، شغِّل الأمر التالي:

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

ChatGPT

لضبط إعدادات ChatGPT، اتّبِع الخطوات التالية:

1. فعِّل وضع مطور البرامج من الإعدادات > التطبيقات > الإعدادات المتقدّمة.
2. انقر على الزر إنشاء تطبيق.
3. أدخِل التفاصيل التالية:
   الاسم: Google Pay & Wallet MCP.
   عنوان URL لخادم MCP: https://paydeveloper.googleapis.com/mcp
4. انتقِل إلى الإعدادات المتقدّمة وأدخِل معرّف عميل OAuth وسرّه.
5. انسخ عنوان URL لرد الاتصال الديناميكي وأضِفه إلى عميل OAuth الذي تم إنشاؤه في الخطوة السابقة.

القيود المعروفة

• نتائج باللغة الإنجليزية فقط: لا يتيح البحث في المستندات إلا اللغة الإنجليزية.
• المحتوى المحمي بقائمة التحكم بالوصول: لا تتم فهرسة المستندات المحمية بقوائم التحكم بالوصول.
• يعتمد على الشبكة: يتطلّب الخادم اتصالاً مباشرًا بخدمتَي Google Pay و"محفظة Google".

بنود الخدمة

يخضع استخدام Google Pay API لبنود خدمة Google Pay API. يخضع استخدام Google Wallet API لبنود خدمة Google Wallet API.