يعمل خادم بروتوكول سياق النموذج (MCP) كوكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بأنظمة خارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.
إعداد الخادم
عليك تفعيل خوادم MCP وإعداد المصادقة قبل استخدامها. لمزيد من المعلومات عن استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP في Google Cloud.
نقاط نهاية الخادم
نقطة نهاية خدمة MCP هي عنوان الشبكة وواجهة الاتصال (عادةً عنوان URL) لخادم MCP الذي يستخدمه تطبيق الذكاء الاصطناعي (المضيف لعميل MCP) لإنشاء اتصال آمن وموحّد. وهي نقطة الاتصال التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استدعاء أداة أو الوصول إلى أحد الموارد. يمكن أن تكون نقاط نهاية MCP من Google عالمية أو إقليمية.
يحتوي خادم MCP الخاص بمطوّري Google Pay و"محفظة Google" على نقطة نهاية 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 المرتبطة بمعرّف تاجر معيّن. وتقدّم ملاحظات فورية عن حالة عمليات الدمج ومراجعات المستندات. |
create_merchant |
تنشئ هذه الأداة تاجرًا جديدًا باستخدام الحساب الذي تم التحقّق منه. عليك أن تطلب من المستخدم تقديم المعلومات المطلوبة لإنشاء التاجر. لا تستدعِ هذه الأداة إلى أن تحاول جمع المعلومات المطلوبة لإنشاء التاجر. بعد إنشاء التاجر، عليك أن تعرض على المستخدم عنوان URL لبنود خدمة Business Console وأن تطلب منه الموافقة عليها قبل أن يتمكّن من تنفيذ أي عمليات على هذا التاجر. |
create_google_pay_integration |
تنشئ هذه الأداة عملية دمج في Google Pay لتاجر معيّن. تتطلّب هذه العملية أن يكون المستخدم قد وافق على بنود خدمة Business Console وبنود خدمة Google Pay API. ليس عليك التحقّق من ذلك بشكل استباقي. إذا لم تتم الموافقة على البنود، ستفشل عملية استدعاء الأداة وستحتوي رسالة الخطأ على عناوين URL المحدّدة لبنود الخدمة التي يجب الموافقة عليها. في هذه الحالة، اعرض عناوين URL على المستخدم ليوافق عليها، واطلب منه إعادة المحاولة بعد الموافقة عليها. اتّبِع هذا التسلسل للتفاعل مع المستخدم قبل استدعاء الأداة: 1. اطلب أولاً من المستخدم عنصر الدمج (لا تتوفّر حاليًا سوى عملية الدمج على الويب). - اطلب عنوان URL للموقع الإلكتروني. # - إذا كان عنصر الدمج هو دمج التطبيق، اطلب اسم حزمة تطبيق Android. 2. بعد ذلك، اطلب من المستخدم نوع عملية الدمج: - اطلب من المستخدم اختيار "البوابة" إذا كان يستخدم أحد مقدّمي خدمات الدفع المتاحين (https://developers.google.com/pay/api#participating-processors)، وإلا اختَر "مباشر". 3- بالنسبة إلى جميع أنواع عمليات الدمج (المباشرة أو البوابة): - اطلب من المستخدم تحميل لقطات شاشة (بحجم 1 ميغابايت كحد أقصى) لمسار الشراء بعد دمج واجهة برمجة تطبيقات Google Pay. يجب مراجعة مسار الشراء والموافقة عليه قبل منح المستخدم إذنًا بالإصدار العلني. أمثلة: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - عليك أن تطلب من المستخدم تقديم 5 لقطات شاشة داعمة. اطلبها واحدةً تلو الأخرى لضمان الربط الصحيح. استخدِم أوصاف التعدادات سهلة الاستخدام فقط عند الطلب. 4. إذا كان نوع عملية الدمج "مباشر": - عليك أيضًا أن تطلب من المستخدم تقديم مستند إثبات الامتثال لمعيار أمان بيانات بطاقات الدفع بتنسيق PDF. استخدِم وصف التعداد سهل الاستخدام فقط عند الطلب. 5- بالنسبة إلى كل ملف يتم تقديمه، اطلب من المستخدم تقديم مسار المستند أو اسمه إذا كان في الدليل الحالي. اربطه بـ DocumentType الصحيح واضبط حقل الاسم على اسم وصفي (مثل item_selection.png أو pci_attestation.pdf) في الطلب. لا تستدعِ هذه الأداة إلى أن تحاول جمع المستندات المطلوبة لنوع عملية الدمج المحدّد. |
list_pass_issuers |
تسترجع هذه الأداة قائمة شاملة بجميع جهات إصدار البطاقات المسجَّلة في Business Console من "محفظة Google" المرتبطة بالمستخدم الذي تم التحقّق منه. توفّر هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
list_pass_classes |
تسترجع هذه الأداة قائمة شاملة بجميع فئات البطاقات المسجَّلة في Business Console من "محفظة Google" المرتبطة بالمستخدم الذي تم التحقّق منه. توفّر هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
validate_pass_jwt |
تتحقّق هذه الأداة من صحة تمثيل JWT لبطاقة أو حمولة JWT غير المشفرة كالسلسلة بتنسيق JSON لبطاقة. |
query_merchant_performance |
تسترجع هذه الأداة بيانات الأداء المجمّعة عالية المستوى والمقاييس بعد عملية الدمج لملف تجاري معيّن. |
query_merchant_error_metrics |
تسترجع هذه الأداة مقاييس تفصيلية للأخطاء لملف تجاري معيّن. توفّر هذه الأداة تفصيلاً دقيقًا للأخطاء، ما يسمح للمطوّرين بتحديد المشاكل وحلّها. |
الحصول على مواصفات أداة 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 }' |