يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.
إعداد الخادم
يجب تفعيل خوادم MCP وإعداد المصادقة قبل الاستخدام. لمزيد من المعلومات حول استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP من Google Cloud.
هذا هو خادم MCP الذي يوفّر أدوات للمطوّرين الذين يستخدمون ميزة "الدفع".
نقاط نهاية الخادم
نقطة نهاية خدمة MCP هي عنوان الشبكة وواجهة الاتصال (عادةً عنوان URL) لخادم MCP الذي يستخدمه تطبيق الذكاء الاصطناعي (المضيف لعميل MCP) لإنشاء اتصال آمن وموحّد. وهي نقطة التواصل التي يمكن للنموذج اللغوي الكبير من خلالها طلب السياق أو استخدام أداة أو الوصول إلى أحد الموارد. يمكن أن تكون نقاط نهاية Google MCP عالمية أو إقليمية.
يحتوي خادم MCP على paydeveloper.googleapis.com على نقطة نهاية MCP التالية:
- https://paydeveloper.googleapis.com/mcp
أدوات MCP
أداة MCP هي وظيفة أو إمكانية تنفيذية يعرضها خادم MCP لتطبيق LLM أو تطبيق مستند إلى الذكاء الاصطناعي من أجل تنفيذ إجراء في العالم الحقيقي.
يتضمّن خادم MCP على paydeveloper.googleapis.com الأدوات التالية:
| أدوات MCP | |
|---|---|
| search_documentation | يبحث عن الأقسام الأكثر صلةً والأحدث من مستندات المطوّرين الرسمية وعيّنات التعليمات البرمجية في Google Pay و"محفظة Google" ويسترجعها. |
| list_merchants | تعرض هذه الطريقة قائمة بجميع الملفات التجارية الخاصة بالتجّار على Google Pay والمرتبطة بالحساب الذي تمّت المصادقة عليه. |
| list_google_pay_integrations | تعرض هذه الطريقة الحالة الحالية وتفاصيل الإعدادات لجميع عمليات الدمج في Google Pay المرتبطة بمعرّف تاجر معيّن. تقدّم هذه الميزة ملاحظات فورية حول حالة عمليات الدمج ومراجعات المستندات. |
| enable_google_pay_api | تتيح هذه السمة استخدام Google Pay API لحساب تاجر تم إنشاؤه حديثًا أو حساب حالي. هذه خطوة أساسية قبل المتابعة لإضافة عمليات الدمج الخاصة بالمنصة (الويب أو Android). |
| list_pass_issuers | تعرض هذه الطريقة قائمة شاملة بجميع جهات إصدار البطاقات المسجّلة في Business Console في محفظة Google المرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
| list_pass_classes | تعرض هذه الطريقة قائمة شاملة بجميع فئات البطاقات المسجّلة في "وحدة تحكّم النشاط التجاري في محفظة Google" المرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
| 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 }' |