يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.
إعداد الخادم
يجب تفعيل خوادم MCP وإعداد المصادقة قبل الاستخدام. لمزيد من المعلومات حول استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP من Google Cloud.
نقاط نهاية الخادم
نقطة نهاية خدمة بروتوكول سياق النموذج (MCP) هي عنوان الشبكة وواجهة الاتصال (عادةً ما تكون عنوان URL) لخادم بروتوكول سياق النموذج الذي يستخدمه تطبيق الذكاء الاصطناعي (المضيف لبرنامج بروتوكول سياق النموذج) لإنشاء اتصال آمن وموحّد. وهي نقطة الاتصال التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استدعاء أداة أو الوصول إلى أحد الموارد. يمكن أن تكون نقاط نهاية بروتوكول سياق النموذج من 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 |
تعرض هذه الطريقة قائمة شاملة بجميع جهات إصدار البطاقات المسجّلة في "وحدة تحكّم النشاط التجاري في محفظة Google" والمرتبطة بالمستخدم الذي تمّت مصادقته. تقدّم هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات "محفظة Google"، مثل بطاقات الولاء أو بطاقات الهدايا أو رحلات الطيران. |
list_pass_classes |
تعرض هذه الطريقة قائمة شاملة بجميع فئات البطاقات المسجّلة في "وحدة تحكّم النشاط التجاري في محفظة 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 }' |