تستخدم 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). كيفية منح الأدوار
تفعيل واجهة برمجة التطبيقات

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

يستخدم خادم MCP لمطوّري Google Pay و"محفظة Google" بروتوكول 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 Auth Platform > العملاء > إنشاء عميل.

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

عليك إنشاء تطبيق جديد في Google Auth Platform إذا لم يكن لديك تطبيق بعد. انقر على الزر "البدء" في صفحة "نظرة عامة" واملأ المعلومات اللازمة.
في قائمة نوع التطبيق، اختَر النوع المناسب لتطبيق الذكاء الاصطناعي:
- بالنسبة إلى 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 Server) (add)، واختَر HTTP وأدخِل عنوان URL الذي يشير إلى خادم MCP الخاص بمطوّري Pay & Wallet: ‏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 & Wallet Developer:

{
  "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. يخضع استخدام 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