هذا خادم "بروتوكول سياق النموذج" (MCP) يوفّر أدوات للمطوّرين في "برنامج الدفع".
يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بأنظمة خارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.
إعداد الخادم
يجب عليك تمكين خوادم MCP وإعداد المصادقة قبل الاستخدام. لمزيد من المعلومات حول استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP في Google Cloud.
نقاط نهاية الخادم
نقطة نهاية خدمة MCP هي عنوان الشبكة وواجهة الاتصال (عادةً ما تكون عنوان URL) لخادم MCP الذي يستخدمه تطبيق مستند إلى الذكاء الاصطناعي (المضيف لعميل MCP) لإنشاء اتصال آمن وموحّد. وهي نقطة التواصل التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استدعاء أداة أو الوصول إلى أحد الموارد. يمكن أن تكون نقاط نهاية Google MCP عالمية أو إقليمية.
يحتوي خادم Google Pay & Wallet Developer MCP API على نقطة نهاية MCP العامة التالية:
- https://paydeveloper.googleapis.com/mcp
أدوات MCP
أداة MCP هي وظيفة أو إمكانية تنفيذية يعرضها خادم MCP لنموذج لغوي كبير أو تطبيق ذكاء اصطناعي لتنفيذ إجراء في العالم الحقيقي.
الأدوات
يتضمّن خادم MCP على paydeveloper.googleapis.com الأدوات التالية:
| أدوات MCP | |
|---|---|
search_documentation |
يبحث عن الأقسام الأكثر صلةً والأحدث من مستندات المطوّرين الرسمية وعيّنات التعليمات البرمجية في Google Pay و"محفظة Google" ويستردّها. |
list_merchants |
تعرض هذه الطريقة قائمة شاملة بجميع التجّار على Google Pay المرتبطين بالحساب الذي تمّت المصادقة عليه. استنادًا إلى دور المستخدم في حساب التاجر، يمكن للمشرفين الاطّلاع على معلومات التاجر التفصيلية الكاملة، بينما يمكن للمطوّرين الاطّلاع على معلومات التاجر الأساسية فقط. |
list_google_pay_integrations |
تعرض هذه الطريقة الحالة الحالية وتفاصيل الإعدادات لجميع عمليات الدمج في Google Pay المرتبطة بمعرّف تاجر معيّن. ويقدّم ملاحظات فورية حول حالة عمليات الدمج ومراجعات المستندات. بالإضافة إلى ذلك، يجب إبلاغ المستخدم بأنّه يمكن إنشاء عملية الدمج أو تعديلها في Google Pay & Wallet Console (https://pay.google.com/business/console/). |
create_merchant |
تنشئ هذه الطريقة تاجرًا جديدًا باستخدام الحساب الذي تمّت مصادقته. يجب أن تطلب من المستخدم تقديم المعلومات المطلوبة لإنشاء التاجر. أحد الحقول المطلوبة هو رمز فئة التاجر (MCC). بما أنّ قائمة رموز MCC طويلة، يمكنك عرض مجموعة فرعية من الخيارات الشائعة، ولكن يجب إعلام المستخدم بأنّه تتوفّر خيارات إضافية ويمكنه طلب القائمة الكاملة (على سبيل المثال، من خلال عرض "X خيارات إضافية" أو تلميح مشابه). بالإضافة إلى ذلك، أبلِغ المستخدم بأنّه يمكنه تقديم رمز "مركز عملائي" المكوّن من 4 أرقام (مثل 5499) مباشرةً إذا كان يعرفه، وشجِّعه على استخدامه. لا تستخدِم هذه الأداة إلا بعد محاولة جمع المعلومات المطلوبة لإنشاء التاجر. بعد إنشاء التاجر، يجب عليك عرض عنوان URL الخاص بشروط خدمة Business Console للمستخدم وتوجيهه لقبوله قبل أن يتمكن من إجراء أي عمليات على هذا التاجر. |
list_pass_issuers |
تسترد قائمة شاملة بجميع جهات إصدار البطاقات المسجّلة في Business Console في محفظة Google والمرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات Wallet، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
list_pass_classes |
تعرض هذه الطريقة قائمة شاملة بجميع فئات البطاقات المسجّلة في Business Console في محفظة Google المرتبطة بالمستخدم الذي تمّت مصادقته. توفر هذه الأداة معلومات أساسية للمطورين الذين يديرون بطاقات المحفظة الإلكترونية مثل بطاقات الولاء أو بطاقات الهدايا أو الرحلات الجوية. |
validate_pass_jwt |
تتحقّق هذه السمة من صحة تمثيل JWT لبطاقة أو حمولة JWT غير المشفرة كسلسلة JSON لبطاقة. |
query_merchant_performance |
تستردّ هذه الطريقة بيانات الأداء المجمّعة العالية المستوى ومقاييس ما بعد التكامل لملف نشاط تجاري محدّد خاص بتاجر. |
query_merchant_error_metrics |
يسترجع مقاييس الأخطاء التفصيلية لملف تعريف أعمال تاجر محدد. توفر هذه الأداة تحليلاً دقيقاً للأخطاء، مما يسمح للمطورين بتحديد المشكلات وحلها. |
update_merchant |
تعديل حقول معيّنة لتاجر حالي تشمل الحقول المدعومة اسم العرض، ورمز البلد، وعنوان موقع الشركة، وعنوان موقع دعم العملاء، وبريد دعم العملاء الإلكتروني، وهاتف دعم العملاء. |
list_principals |
تعرض هذه السمة الجهات الرئيسية (المستخدمين) التي يمكنها الوصول إلى تاجر معيّن. تتطلّب هذه العملية إذن وصول إداري للتاجر. |
set_principal_role |
تضبط هذه الطريقة دور جهة رئيسية (مستخدم) في تاجر، أو تضيف جهة رئيسية جديدة بالدور المحدّد. يتم إرسال دعوة عبر البريد الإلكتروني إلى المدير، ويجب عليه قبولها قبل تفعيل حسابه. تتطلّب هذه العملية إذن وصول إداري للتاجر. |
delete_principal |
يحذف هذا الإجراء إذن وصول جهة أساسية (مستخدم) إلى تاجر معيّن. تتطلّب هذه العملية إذن وصول إداري للتاجر. |
الحصول على مواصفات أداة MCP
للحصول على مواصفات أداة MCP لجميع الأدوات في خادم MCP، استخدِم الطريقة tools/list. يوضّح المثال التالي كيفية استخدام curl لإدراج جميع الأدوات ومواصفاتها المتاحة حاليًا في خادم MCP.
| طلب Curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |