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

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

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

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

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

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

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 عند إنشاء التطبيق (راجِع ضبط تطبيقك المستند إلى الذكاء الاصطناعي أدناه).

  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 Service.