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

معاينة

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

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

يضع معيار بروتوكول سياق النموذج (MCP) أسسًا موحّدة لطريقة ربط النماذج اللغوية الكبيرة وتطبيقات أو وكلاء الذكاء الاصطناعي بمصادر البيانات الخارجية. تتيح لك خوادم 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.

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

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

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

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

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

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

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

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

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

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

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

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

لا يقبل خادم بروتوكول سياق النموذج (MCP) الخاص بخدمة Google Pay و"محفظة Google" للمطوّرين مفاتيح واجهة برمجة التطبيقات.

ننصح بإنشاء هوية منفصلة للوكلاء باستخدام أدوات 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 التالية:

معرّف الموارد المنتظم (URI) للنطاق في 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 للمصادقة > العملاء > إنشاء عميل.

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

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

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

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

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

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

   Cursor Desktop

   http://localhost:8787/callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   Claude.ai

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

   ChatGPT

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

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

   Antigravity

   https://antigravity.google/oauth-callback

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

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

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

VS Code

1. انقر على رمز في أعلى اللوحة الجانبية للدردشة وانتقِل إلى خوادم MCP.
2. انقر على الزر إضافة خادم ()، واختَر HTTP وأدخِل عنوان URL الذي يشير إلى خادم MCP الخاص بأداة Pay & Wallet Developer: https://paydeveloper.googleapis.com/mcp.
   يتم حفظ إعدادات MCP في الملف .vscode/mcp.json في مساحة العمل:

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

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

Cursor Desktop

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

1. انقر على تخصيص في اللوحة الجانبية على يمين الصفحة.
2. انقر على خادم MCP جديد. سيؤدي ذلك إلى فتح ملف الإعداد mcp.json.
3. أدخِل تفاصيل الإعداد لإضافة خادم بروتوكول سياق النموذج (MCP) الخاص بمطوّري Google Pay و"محفظة Google":

   {
     "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. بعد حفظ الملف، يتم تعديل قائمة خوادم MCP.
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

Claude.ai

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

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

ChatGPT

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

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

Antigravity CLI

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

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

2. نفِّذ الأمر /mcp، واختَر خادم MCP الجديد، ثم انقر على مصادقة لبدء عملية المصادقة.

Antigravity IDE

1. انقر على في أعلى اللوحة الجانبية الخاصة بأداة التعديل واختَر خوادم MCP.
2. انقر على إدارة خوادم MCP.
3. انقر على عرض الإعدادات الأولية وأضِف تفاصيل خادم بروتوكول سياق النموذج (MCP):

   {
     "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 وانقر على إعادة التحميل.
5. اختَر خادم MCP الجديد، ثم انقر على مصادقة وأكمِل خطوات المصادقة.
6. انسخ رمز التفويض وأرسِله في نافذة إعدادات Antigravity.

Antigravity

1. في Antigravity، انتقِل إلى الإعدادات > التخصيصات.
2. في قسم خوادم MCP المثبَّتة، انقر على فتح إعدادات 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. ارجع إلى Antigravity وانقر على إعادة التحميل.
4. انقر على مصادقة وأكمِل عملية المصادقة.
5. انسخ رمز التفويض وأرسِله في نافذة إعدادات Antigravity.

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

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

بنود الخدمة

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