هذا خادم "بروتوكول سياق النموذج" (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 المرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات Wallet، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
validate_pass_jwt |
تتحقّق هذه السمة من صحة تمثيل JWT لبطاقة أو حمولة JWT غير المشفرة كسلسلة JSON لبطاقة. |
query_merchant_performance |
تستردّ هذه الطريقة بيانات الأداء المجمّعة العالية المستوى ومقاييس ما بعد التكامل لملف نشاط تجاري محدّد خاص بتاجر. |
query_merchant_error_metrics |
تعرض هذه الطريقة مقاييس تفصيلية للأخطاء في ملف تجاري محدّد لتاجر. توفّر هذه الأداة تفصيلاً دقيقًا للأخطاء، ما يتيح للمطوّرين تحديد المشاكل وحلّها. |
update_merchant |
تعديل حقول معيّنة لتاجر حالي تشمل الحقول المتوافقة display_name وmcc وcorporate_website_url وcustomer_support_website_url وcustomer_support_email وcustomer_support_phone. |
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 }' |