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

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

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

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

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

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

ملاحظة: يُرجى الاطّلاع على المستند المرجعي الخاص بأدوات المطوّرين في Pay & Wallet لعرض تفاصيل أدوات MCP المتاحة وأوصافها.

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

يستخدم OAuth 2.0 النطاقات وبيانات الاعتماد لتحديد ما إذا كان يمكن لجهة أساسية مصادَق عليها اتخاذ إجراء محدّد بشأن أحد الموارد. لمزيد من المعلومات حول نطاقات 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، اتّبِع الخطوات التالية:

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

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

عليك إنشاء تطبيق جديد في "منصة مصادقة Google" إذا لم يكن لديك تطبيق بعد. انقر على الزر "البدء" في صفحة النظرة العامة واملأ المعلومات اللازمة.
في قائمة نوع التطبيق، اختَر النوع المناسب لتطبيق الذكاء الاصطناعي:
- بالنسبة إلى Cursor Desktop وClaude Code وClaude.ai وChatGPT وAntigravity، اختَر تطبيق الويب.
- بالنسبة إلى Antigravity CLI وAntigravity IDE وVS Code، اختَر تطبيق الكمبيوتر.
في حقل الاسم، أدخِل اسمًا لتطبيقك.
إذا اخترت تطبيق ويب، انقر على + إضافة معرّف الموارد المنتظم (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
انقر على إنشاء. عند إنشاء سرّ العميل، يتم عرضه مرة واحدة. انسخها وخزِّنها بأمان.

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

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

VS Code

انقر على رمز في أعلى اللوحة الجانبية للدردشة وانتقِل إلى خوادم MCP.
انقر على الزر إضافة خادم (add)، واختَر 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"
    }
  }
}
```
انقر بزر الماوس الأيمن على خادم MCP الجديد واختَر بدء الخادم.
ارجع إلى نافذة المحادثة واستدعِ أداة في خادم MCP لبدء عملية المصادقة. على سبيل المثال: "أدرِج حساباتي على Google Pay".
يتم فتح مربّع الحوار Dynamic Client Registration غير متاح كما هو متوقّع. انقر على أي زر لإغلاق مربّع الحوار.
أدخِل معرّف عميل OAuth واضغط على Enter.
عندما يُطلب منك ذلك، أدخِل سر عميل OAuth واضغط على مفتاح Enter.
سيفتح مربّع حوار للمصادقة، انقر على السماح.
يمكنك الاختيار من قائمة الهويات التي تم إثبات ملكيتها أو تسجيل الدخول باستخدام حساب جديد.
بعد المصادقة، يتم استدعاء الأداة وتستمر الجلسة في نافذة المحادثة.

Cursor Desktop

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

انقر على تخصيص في اللوحة الجانبية على يمين الصفحة.
انقر على خادم MCP جديد. سيؤدي ذلك إلى فتح ملف الإعداد mcp.json.

أدخِل تفاصيل الإعداد لإضافة خادم بروتوكول سياق النموذج (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"
      }
    }
  }
}

بعد حفظ الملف، يتم تعديل قائمة خوادم بروتوكول سياق النموذج (MCP).
انقر على مصادقة لبدء عملية المصادقة.

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، اتّبِع الخطوات التالية:

انتقِل إلى تخصيص > الموصِّلات.
انقر على إضافة واختَر إضافة موصِّل مخصّص.
أدخِل التفاصيل التالية:
في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
اختَر الموصّل الجديد وانقر على ربط.

ChatGPT

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

فعِّل وضع مطور البرامج من الإعدادات > الأمان وتسجيل الدخول.
انقر على المكوّنات الإضافية في اللوحة الجانبية الرئيسية، ثمّ انقر على الزر .
أدخِل التفاصيل التالية:
انتقِل إلى الإعدادات المتقدّمة وأدخِل معرّف عميل OAuth وكلمة السر.
انسخ عنوان URL لرد الاتصال الديناميكي وأضِفه إلى عميل OAuth الذي تم إنشاؤه في الخطوة السابقة.

Antigravity CLI

لضبط إعدادات 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"
      }
    }
  }
}

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

Antigravity IDE

انقر على في أعلى اللوحة الجانبية الخاصة بالوكيل في المحرّر، ثمّ اختَر خوادم MCP.
انقر على إدارة خوادم MCP.

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

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

ارجع إلى Antigravity IDE وانقر على إعادة التحميل.
اختَر خادم MCP الجديد، ثم انقر على مصادقة وأكمِل خطوات المصادقة.
انسخ رمز التفويض وأرسِله في نافذة إعدادات Antigravity.

Antigravity

في Antigravity، انتقِل إلى الإعدادات > التخصيصات.

في قسم خوادم 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"
      }
    }
  }
}

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

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

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

بنود الخدمة

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

الاتصال بخادم MCP الخاص بـ Google Pay وWallet Developer تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

قبل البدء

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

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

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

Cursor Desktop

Claude Code

Claude.ai

ChatGPT

Antigravity

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

VS Code

Cursor Desktop

Claude Code

Claude.ai

ChatGPT

Antigravity CLI

Antigravity IDE

Antigravity

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

بنود الخدمة

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