الاتصال بخوادم Model Context Protocol (MCP)

توفّر خوادم MCP لـ Gemini أدوات ومصادر بيانات إضافية. على سبيل المثال، من خلال إضافة خادم MCP في Firebase، يمكنك استخدام اللغة الطبيعية لاستكشاف بيانات Cloud Firestore أثناء إنشاء تطبيقك أو تصحيح أخطائه.

المتطلبات الأساسية

إذا كان خادم MCP يتطلّب ذلك، تأكَّد من تثبيت Node.js وnpm بشكلٍ سليم.

اختيار خادم MCP متوافق

يتوافق نظام التشغيل Firebase Studio مع خوادم MCP بشكل أساسي، ولكن ليس كل خوادم MCP متوافقة. عند اختيار خادم MCP، يجب أخذ تفاصيل التوافق التالية في الاعتبار:

  • متاح:

    • خوادم النقل القياسية للإدخال والإخراج (stdio) أو خوادم النقل التي تستخدم أحداث Server-Sent Events (SSE) أو HTTP القابل للبث
    • مصادقة مفتاح واجهة برمجة التطبيقات باستخدام عناوين HTTP أو متغيرات البيئة
    • الأدوات التي توفّرها خوادم MCP

  • غير متاح:

    • الخوادم التي تتطلّب واجهة مستخدم رسومية أو جلسة على جهاز كمبيوتر
    • الطلبات أو العيّنات أو الموارد الأخرى التي توفّرها خوادم MCP

إضافة خادم MCP

لإضافة خادم MCP، عليك إنشاء ملف الإعداد الخاص به أو تعديله.

الخطوة 1: إنشاء ملف الإعداد

تتصل المحادثة التفاعلية بخوادم MCP باستخدام ملف إعداد:

  • تستخدم المحادثة التفاعلية .idx/mcp.json.

أنشئ الملف باستخدام التعليمات التالية.

محادثة تفاعلية

في العرض Code، أنشئ .idx/mcp.json باستخدام إحدى الطرق التالية:

  • لوحة الأوامر: افتح لوحة الأوامر (Shift+Ctrl+P)، واستخدِم الأمر Firebase Studio: إضافة خادم MCP.
  • المحادثة التفاعلية: انقر على تخصيص رمز الأدوات تخصيص الأدوات في المحادثة التفاعلية، ثم انقر على إضافة خادم MCP.
  • المستكشف: من "المستكشف" (Ctrl+Shift+E)، انقر بزر الماوس الأيمن على دليل .idx واختر ملف جديد. أدخِل اسم الملف mcp.json.

الخطوة 2: تعديل إعدادات الخادم

  1. افتح ملف إعداد الخادم.

  2. أضِف إعدادات الخادم إلى محتوى الملف. على سبيل المثال، لإضافة خادم MCP على Firebase، أدخِل ما يلي:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "mcp"
      ]
    }
  }
}

    يُعلِم ملف الإعداد هذا Gemini بخادم MCP الذي تريد استخدامه. يعرض هذا المثال خادمًا واحدًا باسم firebase سيستخدم الأمر npx لتثبيت firebase-tools@latest وتشغيله.

    إذا كان خادم MCP يتطلّب مصادقة مفتاح واجهة برمجة التطبيقات، يمكنك ضبطه بإحدى الطرق التالية:

    • بالنسبة إلى خوادم HTTP MCP البعيدة التي تتطلّب مفتاح واجهة برمجة تطبيقات في عناوين الطلبات، استخدِم الحقل headers. على سبيل المثال، لضبط خادم MCP في GitHub، اتّبِع الخطوات التالية:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • بالنسبة إلى خوادم MCP المحلية التي تتطلّب مفتاح واجهة برمجة تطبيقات في متغيرات البيئة، استخدِم الحقل env. على سبيل المثال، لضبط إصدار محلي من خادم MCP الخاص بمنصة GitHub، اتّبِع الخطوات التالية:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

    • لتجنُّب الترميز الثابت للأسرار في mcp.json، يمكنك اختياريًا استخدام بنية ${env:VARIABLE_NAME}. سيؤدي ذلك إلى استبدال القيم بمتغيرات البيئة المحدّدة في ملف .env أو .env.local في جذر مساحة العمل. على سبيل المثال:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
      }
    }
  }
}

  3. في الوحدة الطرفية (Shift+Ctrl+C)، شغِّل أي أوامر ضرورية لإكمال عملية التثبيت. على سبيل المثال، لاستخدام خادم MCP في Firebase، أدخِل الأمر التالي لتسجيل الدخول إلى حسابك:

    firebase login --no-localhost

    اتّبِع التعليمات الواردة في الجهاز للسماح بالجلسة. تتطلّب بعض الأدوات مشروعًا مرتبطًا على Firebase. يمكنك استخدام خادم Firebase MCP لإنشاء مشروع، أو يمكنك تنفيذ الأمر التالي لتهيئة مشروع Firebase:

    firebase init

    يؤدي ذلك إلى إنشاء ملف firebase.json في الدليل الجذر.

استخدام أدوات بروتوكول سياق النموذج (MCP)

بعد تثبيت خادم MCP الذي تريد استخدامه، ستتوفّر الأدوات أو البيانات التي يقدّمها في:

  • محادثة تفاعلية عند استخدام وضعَي "الوكيل" و"الوكيل (التشغيل التلقائي)"
  • App Prototyping agent

على سبيل المثال، إذا أضفت خادم MCP الخاص بمنصة Firebase، يمكنك أن تطلب من Gemini جلب إعدادات حزمة SDK للمشروع الحالي، واسترداد البيانات المخزّنة في Cloud Firestore وRealtime Database، ومساعدتك في إعداد خدمات Firebase، وغير ذلك.

في المحادثة التفاعلية، اكتب / للاطّلاع على قائمة بطلبات MCP المتاحة.

قائمة الطلبات المتاحة في &quot;المنتجات المتوافقة مع الأطفال&quot;

التحقّق من الأدوات أو تعديلها

يمكنك إدارة الأدوات النشطة في المحادثة التفاعلية:

  1. انقر على تخصيص رمز الأدوات تخصيص الأدوات في المحادثة التفاعلية للاطّلاع على قائمة بجميع الأدوات المتاحة من خوادم MCP التي تم ضبطها.
  2. استخدِم مربّعات الاختيار لتفعيل خادم بأكمله أو أدوات فردية أو إيقافها.

قائمة أدوات MCP المتاحة

تحديد المشاكل في خوادم MCP وحلّها

إذا واجهت مشاكل في أحد خوادم MCP، اتّبِع الخطوات التالية لتشخيص المشكلة.

التحقّق من السجلات بحثًا عن الأخطاء

  1. افتح لوحة "الإخراج" (Shift+Ctrl+U).
  2. في القائمة المنسدلة، اختَر Gemini.
  3. ابحث عن الرسائل التي تبدأ بعلامة [MCPManager]. تعرض هذه السجلّات الخوادم التي تم إعدادها والأدوات التي تمت إضافتها بنجاح وأي رسائل خطأ.

إعادة إنشاء البيئة

إذا تعذّر تثبيت خادم MCP أو الاتصال به، جرِّب إعادة إنشاء مساحة العمل باتّباع الخطوات التالية:

  1. افتح "لوحة الأوامر" (Shift+Ctrl+P).
  2. نفِّذ الأمر Firebase Studio: إعادة إنشاء البيئة.
  3. بعد إعادة إنشاء مساحة العمل، تحقَّق ممّا إذا كان خادم MCP متصلاً.

في حال عدم استخدام الأدوات

إذا تم ربط خادم بروتوكول سياق النموذج (MCP) ولكن Gemini لا يستخدم أدواته:

  • بدء جلسة محادثة جديدة: يضمن ذلك أن يختار Gemini أحدث إعدادات للأداة. كيفية إدارة سجلّ المحادثات
  • تحديد التفاصيل في الطلب: إذا كان بإمكان Gemini إكمال المهمة بدون استخدام أداة MCP، قد يحاول استخدام طريقة مختلفة. إذا أردت استخدام أداة معيّنة، جرِّب تسميتها. على سبيل المثال: "استخدِم firebase_get_sdk_config للحصول على إعدادات حزمة تطوير البرامج للمشروع الحالي".
  • الانضمام إلى برنامج Google Developer: التأكّد من أنّ حسابك مسجَّل

الخطوات التالية