يمكنك استخدام "وضع المطوّر" في "تطبيقات Gemini" لاختبار خادم "بروتوكول سياق النموذج" (MCP) بشكل تفاعلي، وتشخيص أخطاء المخطط أو أخطاء التشغيل، وتقييم جودة الأداة قبل إرسال تطبيقك المرتبط للمراجعة في Google Connected Console.
يتناول هذا الدليل المهام التالية:
- فعِّل "وضع المطوّر" في "تطبيقات Gemini"، وأنشئ تطبيق MCP مخصّصًا، وتحقَّق من العثور على الأداة الأولية.
- يمكنك تصحيح أخطاء طلبات الأدوات التي تعذّر تنفيذها، ومزامنة المخططات المعدَّلة، واختبار المصادقة.
- محاكاة سياق بيئة المستخدم وضبط مصادقة العميل
للحصول على مقدمة حول تنسيق مساحة العمل وعلامات تبويب "المفتّش"، يُرجى الاطّلاع على نظرة عامة على "وضع المطوّر" في "تطبيقات Gemini".
تفعيل "وضع المطوّر" في "تطبيقات Gemini"
إذا كنت بصدد إعداد خادم MCP في Google Connected Console، سيكون تطبيقك المسجَّل متاحًا عند تفعيل "وضع المطوّر" في "تطبيقات Gemini"، ويمكنك تخطّي الخطوة 2. إذا أردت اختبار نقطة نهاية خادم HTTPS MCP تم نشرها مباشرةً في Gemini قبل تسجيلها في وحدة التحكّم، اتّبِع الخطوتَين لتفعيل "وضع مطوّر تطبيقات Gemini" وربط خادمك كتطبيق MCP مخصّص.
الخطوة 1: تفعيل "وضع المطوّر" في "تطبيقات Gemini"
- افتح Gemini في متصفّح الويب.
- انقر على الإعدادات > وضع المطوّر في تطبيقات Gemini (أو انتقِل مباشرةً إلى gemini.google.com/devmode).
(اختياري) الخطوة 2: إنشاء تطبيق MCP مخصّص واختباره
لربط خادم MCP كتطبيق مخصّص في "وضع المطوّر" ضمن "تطبيقات Gemini"، اتّبِع الخطوات التالية:
- في مربّع الحوار اختيار تطبيق، انقر على + إنشاء تطبيق جديد.
- في مربّع الحوار الربط بخادم MCP، أدخِل نقطة نهاية HTTPS العامة للخادم في عنوان URL لخادم MCP (تأكَّد من أنّ عنوان URL يبدأ بـ
https://، على سبيل المثال،https://your-app-link.com/mcp). - إذا كان الخادم يتطلّب بيانات اعتماد OAuth مسجَّلة مسبقًا، انقر على إعدادات إضافية > عرض المزيد لإدخال معرّف العميل وسر العميل في OAuth، ثم انقر على التالي.
- في مربّع حوار تأكيد الأمان والخصوصية، راجِع كيفية تفاعل Gemini مع خادم MCP المخصّص:
- تنفيذ الأدوات: ينفّذ Gemini أدوات خادم MCP لتفعيل الوظائف المتاحة وتشغيلها من أجل معالجة طلباتك.
- استرداد البيانات ومشاركتها: يسترد Gemini الموارد والمخططات والسياقات التي تعرضها نقاط نهاية خادم MCP ويديرها، وقد يشارك المعلومات التي يمكنه الوصول إليها استنادًا إلى إعدادات حسابك على Google أو عند التفاعل مع تطبيقات مرتبطة أخرى.
- الموثوقية وإلغاء الربط: يُرجى التأكّد من موثوقية خادم MCP ومراجعة سياسة الخصوصية الخاصة به قبل المتابعة. يمكنك إلغاء ربط الخادم في أي وقت من صفحة "التطبيقات المرتبطة" أو حذف عملية الربط من عمليات الربط بحساب Google.
- اختَر أُدرك وأقبل بمخاطر الأمان والخصوصية المترتبة على ربط هذا التطبيق المخصّص، ثم انقر على ربط.
- في مربّع الحوار حفظ تطبيقك المخصّص، أدخِل اسمًا معروضًا لتطبيقك المخصّص، وتأكَّد من ظهور أدوات الخادم في قائمة الإجراءات المتاحة، ثم انقر على ربط.
- في اللوحة الجانبية "وضع المطوّر" في "تطبيقات Gemini"، انقر على علامة التبويب مخططات الأدوات لمراجعة معلومات حول كل أداة في تطبيقك المرتبط، بما في ذلك تعريفات المَعلمات وشارات الأمان (للقراءة فقط ومدمِّرة وتتطلّب المصادقة) والمخطط الأولي وبنية الردّ.
- في لوحة المحادثة اليمنى، أدخِل طلبات بلغة طبيعية أو طلبات
@mention(على سبيل المثال،@MyApp show my profile)، وراقِب علامة التبويب سجلّ الأحداث لمعرفة كيفية عمل الأداة.
تصحيح أخطاء طلبات استخدام الأدوات
عندما يتعذّر استدعاء أداة أو ينتج عنه وسيطات غير متوقّعة، يمكنك فحص بيانات القياس التشخيصي عن بُعد وتعديل خادم MCP في الخلفية وإعادة تحميل المخطط بسرعة بدون محو سجلّ المحادثات.
لتصحيح أخطاء استدعاء أداة تعذّر تنفيذها، اتّبِع الخطوات التالية:
- في اللوحة اليسرى، انقر على علامة التبويب سجلّ الأحداث.
- انقر على الحدث الذي تعذّر إكماله في قائمة القياس عن بُعد لتوسيع تفاصيله وفحص حمولة طلب
Tool callواستجابةTool result:- أخطاء الاتصال والشبكة: تحقَّق من رسائل الخطأ ووقت الاستجابة للتأكّد من إمكانية الوصول إلى نقطة النهاية.
- أخطاء المصادقة: إذا عرض الحدث
401أو403، تحقَّق من حالة رمز OAuth المميّز أو بيانات اعتماد العميل في علامة التبويب المصادقة. - عدم تطابق في التحقّق من صحة المخطط: إذا عرض الخادم خطأً في مَعلمات MCP غير الصالحة (
-32602)، قارِن وسيطات JSON التي أنشأها النموذج فيTool callبأنواع المَعلمات والسمات المطلوبة وتعليمات التنسيق في علامة التبويب مخططات الأدوات. - استثناءات وقت تشغيل الخادم: افحص رمز الخطأ والرسالة في JSON-RPC في
Tool resultلتشخيص استثناءات الخلفية.
- لحلّ المشكلة، عليك تعديل عملية تنفيذ خادم MCP أو تحسين أوصاف الأدوات والمَعلمات. للحصول على إرشادات حول كتابة مخططات أدوات واضحة وردود الأخطاء، يُرجى الاطّلاع على معايير دمج التطبيقات المرتبطة ببروتوكول MCP.
- في علامة التبويب مخططات الأدوات، انقر على مزامنة المخطط. يعيد Gemini جلب
tools/listمن خادم MCP ويعدّل تعريفات الأدوات النشطة مع الحفاظ على سلسلة المحادثات الحالية. - أعِد محاولة إجراء طلب البحث. في علامة التبويب سجلّ الأحداث، تأكَّد من أنّ طلب الأداة الذي تمت إعادة تشغيله يعرض
200 OKويعرض الردّ المتوقّع في معاينة المحادثة.
محاكاة سياق البيئة والمصادقة
يمكنك اختبار كيفية استجابة أدوات MCP للمواقع الجغرافية والمناطق الزمنية واللغات وطرق المصادقة المختلفة للمستخدمين مباشرةً في لوحة الفحص.
تجاهُل سياق البيئة
لمحاكاة سياق المستخدم للأدوات التي تتأثر بالتاريخ أو الوقت أو اللغة، اتّبِع الخطوات التالية:
- في اللوحة اليسرى، انقر على علامة التبويب البيئة.
- ضمن التاريخ والوقت، اختَر تاريخًا محاكيًا ووقتًا محاكيًا لاختبار تعبيرات الوقت النسبي (مثل "غدًا صباحًا" أو "بعد ظهر يوم السبت القادم").
- ضمن الإعدادات المفضّلة، اختَر لغة لمحاكاة لغة المستخدم (مثلاً،
en-US). - أدخِل طلبًا تجريبيًا في لوحة المحادثة لتقييم أداتك في السياق المحاكى.
- لاستعادة إعدادات البيئة التلقائية، انقر على إعادة ضبط.
ضبط مصادقة العميل
لضبط طريقة المصادقة المستخدَمة أثناء جلسة "وضع مطوّر البرامج" في "تطبيقات Gemini" أو تبديلها، اتّبِع الخطوات التالية:
- في اللوحة اليسرى، انقر على علامة التبويب المصادقة.
- ضمن إعدادات مصادقة العميل، اختَر أحد أوضاع المصادقة التالية:
- Dynamic Client Registration: يستخدم مسار OAuth للتفاوض على بيانات الاعتماد تلقائيًا مع خادم التفويض. لمزيد من المعلومات، يُرجى الاطّلاع على دليل استخدام OAuth 2.1. أدخِل نقطة النهاية في إضافة رابط تطبيق مخصّص، إذا كان ذلك منطبقًا.
- التسجيل اليدوي للعميل: يتيح لك تقديم معرّف العميل والرمز السري للعميل المسجَّلين مسبقًا يدويًا. وسِّع الإعدادات المتقدّمة لضبط عمليات تجاوز إضافية للتدفق.
- انقر على حفظ، وانتظر ظهور رسالة تم الحفظ. بعد ذلك، يمكنك تشغيل طلب اختبار للتحقق من نجاح الأدوات التي تمت مصادقتها.