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

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

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

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

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

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

**ملاحظة:** يُرجى الاطّلاع على مرجع مطوّري Pay و"محفظة Google" لعرض تفاصيل أدوات MCP المتاحة وأوصافها.

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

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

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

قبل البدء

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

في 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 و"محفظة Google"

يستخدم بروتوكول 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)، واختَر HTTP وأدخِل عنوان URL الذي يشير إلى خادم MCP الخاص بمطوّري Pay و"محفظة Google": https://paydeveloper.googleapis.com/mcp.
يتم حفظ إعدادات MCP في الملف .vscode/mcp.json في مساحة العمل:
```
{
  "servers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp"
    }
  }
}
```
انقر بزر الماوس الأيمن على خادم MCP الجديد واختَر بدء الخادم.
ارجِع إلى نافذة المحادثة واستدعِ أداة في خادم MCP لتفعيل عملية المصادقة. على سبيل المثال: "عرض حساباتي على Google Pay"
سيتم فتح مربّع الحوار التسجيل الديناميكي للعميل غير متاح كما هو متوقّع. انقر على أي زر لإغلاق مربّع الحوار.
أدخِل معرّف عميل 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. يخضع استخدام Google Wallet API لبنود خدمة Google Wallet API Service.

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

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

قبل البدء

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

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

إنشاء معرّف عميل 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