دمج خدمات Firebase باستخدام ميزة "المساعدة المستنِدة إلى الذكاء الاصطناعي"

يمكنك تبسيط عملية إعداد Firebase لتطبيقات الويب باستخدام أدوات تطوير مستندة إلى الذكاء الاصطناعي، مثل Antigravity وClaude Code وCodex وCursor. باستخدام مهارات وكيل Firebase مع Firebase CLI وخادم Firebase MCP، يمكنك تحويل وكيل الترميز المستنِد إلى الذكاء الاصطناعي إلى خبير متخصص في Firebase يمكنه كتابة الرموز البرمجية وإعداد Firebase Security Rules وإدارة الموارد المباشرة.

يتناول هذا الدليل كيفية استخدام وكيل ترميز مستند إلى الذكاء الاصطناعي للمساعدة في إعداد Cloud Firestore وAuthentication وFirebase Hosting لتطبيق ويب. سنوفّر قريبًا معلومات عن تطبيقات iOS وAndroid وFlutter.

لماذا يجب استخدام مهارات وأدوات وكلاء Firebase؟

تواجه نماذج الذكاء الاصطناعي العامة غالبًا صعوبة في التعامل مع إعدادات المشاريع المحدّدة أو المعلومات القديمة. تسدّ مجموعة الأدوات هذه هذه الفجوة:

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

يمنح استخدام مهارات وكيل Firebase إلى جانب Firebase CLI وخادم Firebase MCP وكيل الترميز المستنِد إلى الذكاء الاصطناعي قدرات إضافية:

  • اتخاذ الإجراءات: افعل أكثر من مجرد كتابة التعليمات البرمجية. يمكن للوكيل بدء الخدمات وإدارة مستخدمي Authentication ونشر Firebase Security Rules جديدة والعمل مباشرةً مع بيانات Cloud Firestore.
  • البقاء على اطّلاع بآخر المعلومات: استخدِم طلبات رسمية تتضمّن معلومات عن الإصدار لتوجيه الوكيل خلال مهام الإعداد.
  • تحسين الدقة: الوصول إلى بيئة مشروعك ومخططاته لتوفير مساعدة أكثر صلة ودقة.
  • تقليل تكاليف الرموز: تقوم مهارات الوكيل بتحميل الوثائق التفصيلية فقط عندما تتطلب مهمة معينة ذلك، مما يقلل من الحمل الزائد للجلسة.

ما هي خدمات Firebase التي يمكن أن تساعد فيها مهارات وأدوات الوكيل؟

يركّز هذا الدليل بشكل أساسي على كيفية عمل مهارات الوكيل وFirebase CLI وخادم Firebase MCP معًا لمساعدتك في إعداد هذه الخدمات والميزات بسرعة:

  • Cloud Firestore: قم بتوفير قاعدة بيانات NoSQL.
  • استخدِم Authentication لإعداد تسجيل دخول آمن للمستخدمين.
  • Firebase Security Rules: إنشاء Security Rules وتحسينه لتطبيقك
  • Firebase Hosting: إعداد مشروعك لنشر تطبيق ويب ثابت

للاطّلاع على قائمة كاملة بالميزات المتاحة، يمكنك تصفّح القائمة الكاملة لمهارات وكيل Firebase.

سير العمل العام

تصف الخطوات التالية سير عمل عام لكيفية استخدام مهارات وكيل Firebase لإعداد خدمات Firebase واستخدامها في تطبيق ويب. في الخلفية، تستخدم مهارات الوكيل واجهة سطر الأوامر Firebase وخادم Firebase MCP لإكمال هذه المهام.

الخطوة 1: تثبيت مهارات وكلاء Firebase

في معظم الحالات، يمكنك تثبيت مهارات وكلاء Firebase في المحرّر المفضّل لديك باستخدام طلب واحد:

Antigravity

  • الخيار 1: الوصول على المستوى العالمي

    يتم تضمين مهارات وكلاء Firebase كإحدى حِزم الدمج الإنشاء باستخدام Google في Antigravity. قم بتفعيل هذه الحزمة باستخدام أحد الخيارين التاليين:

    • أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار بجانب حزمة Firebase.
    • في الإعدادات بعد الإعداد: انتقل إلى الإعدادات > التخصيصات. ضمن إنشاء باستخدام مكوّنات Google الإضافية، انقر على تخصيص، ثم انقر على تنزيل لدمج Firebase.
  • الخيار 2: إذن الوصول على مستوى المشروع

    نفِّذ الأمر التالي في دليل مشروعك:

    npx skills add firebase/agent-skills --agent=antigravity
    

Claude Code

نفِّذ الأوامر التالية في الوحدة الطرفية:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

المخطوطة

  • الخيار 1: وحدة Codex الطرفية

    نفِّذ الأوامر التالية في الوحدة الطرفية:

    codex plugin marketplace add firebase/agent-skills
    codex plugin add firebase@firebase
    
  • الخيار 2: تطبيق Codex

    1. أكمِل المهام التالية مرة واحدة:

      1. سجِّل من خلال الوحدة الطرفية باتّباع الخطوات التالية:

        codex plugin marketplace add firebase/agent-skills
        
      2. أعد تشغيل تطبيق Codex بالكامل.

      3. افتح الإضافات.

      4. حدد سوق/مصدر Firebase.

      5. افتح Firebase وانقر على + تثبيت.

    2. ابدأ مهمة جديدة.

    3. اكتب @Firebase لاختيار المكوّن الإضافي، أو اطلب من Codex تنفيذ مهمة Firebase.

المؤشر

  • الخيار 1: تثبيت المكوّن الإضافي مباشرةً من سوق Cursor

  • الخيار 2: نفِّذ الأمر التالي في الوحدة الطرفية:

    npx skills add firebase/agent-skills --agent=cursor
    

الوكلاء الآخرون

نفِّذ الأمر التالي في الوحدة الطرفية:

npx skills add firebase/agent-skills

الخطوة 2: الربط بخادم MCP في Firebase

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

طريقة بمساعدة الذكاء الاصطناعي

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

الطريقة اليدوية

Antigravity

لضبط Antigravity لاستخدام خادم MCP في Firebase، اتّبِع الخطوات التالية:

  1. في Antigravity، انقر على قائمة في لوحة "البرنامج الوكيل" > خوادم MCP.
  2. اختَر Firebase > تثبيت.

يؤدي ذلك إلى تعديل ملف mcp_config.json تلقائيًا، ويمكنك الاطّلاع عليه من خلال النقر على إدارة خوادم MCP في أعلى لوحة "متجر MCP" > عرض الإعدادات الأولية، مع المحتوى التالي:

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

Firebase Studio

لضبط Firebase Studio لاستخدام خادم Firebase MCP، عدِّل ملف الإعداد أو أنشئه: .idx/mcp.json.

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

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

Claude

Claude Code

  • الخيار 1: التثبيت من خلال مكوّن إضافي (مُقترَح)

    أسهل طريقة لإعداد خادم Firebase MCP في Claude Code هي تثبيت المكوّن الإضافي الرسمي من Firebase:

    1. أضِف سوق Firebase الخاص بمكوّنات Claude الإضافية:

      claude plugin marketplace add firebase/firebase-tools
    2. قم بتثبيت إضافة Claude لـ Firebase:

      claude plugin install firebase@firebase
    3. التحقّق من عملية التثبيت:

      claude plugin marketplace list
  • الخيار 2: تكوين خادم MCP يدويًا

    بدلاً من ذلك، يمكنك ضبط خادم MCP في Firebase يدويًا باتّباع الخطوات التالية:

    1. نفِّذ الأمر التالي ضمن مجلد تطبيقك:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. التحقّق من عملية التثبيت:

      claude mcp list

      ينبغي أن يظهر ما يلي:

      firebase: npx -y firebase-tools@latest mcp - ✓ Connected
      

‫Claude Desktop

لضبط Claude Desktop لاستخدام خادم Firebase MCP، عدِّل الملف claude_desktop_config.json. يمكنك فتح هذا الملف أو إنشاؤه من قائمة Claude > Settings. انقر على علامة التبويب المطوّر، ثم على تعديل الإعدادات.

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

Cline

لضبط Cline لاستخدام خادم MCP في Firebase، عدِّل ملف cline_mcp_settings.json. يمكنك فتح هذا الملف أو إنشاؤه من خلال النقر على رمز خوادم MCP في أعلى جزء Cline، ثم النقر على الزر ضبط خوادم MCP.

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

المؤشر

الخيار 1: إضافة Marketplace (موصى بها)

ثبِّت المكوّن الإضافي Firebase من Cursor Marketplace. يؤدي ذلك إلى ضبط خادم MCP تلقائيًا وتوفير إمكانية الوصول إلى مهارات وكيل Firebase.

الخيار 2: إعداد MCP بنقرة واحدة

إذا كنت ترغب فقط في إضافة خادم MCP إلى إعداداتك العامة، فانقر فوق الزر التالي:

تثبيت خادم MCP

الخيار 3: الضبط اليدوي

إذا كنت تفضّل ضبط الخادم لمشروع معيّن أو أردت تعديل إعداداتك يدويًا، عدِّل ملف mcp.json باتّباع الخطوات التالية:

  • لمشروع محدد، عدّل .cursor/mcp.json
  • تعديل ~/.cursor/mcp.json لجميع المشاريع (على مستوى العالم)
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

مساعد VS Code

لضبط إعدادات مشروع واحد، عدِّل ملف .vscode/mcp.json في مساحة العمل باتّباع الخطوات التالية:

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

لجعل الخادم متاحًا في كل مشروع تقوم بفتحه، قم بتعديل إعدادات المستخدم الخاصة بك، على سبيل المثال:

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

التزلج على الماء بواسطة الرياح

لضبط إعدادات Windsurf Editor، عدِّل الملف ~/.codeium/windsurf/mcp_config.json:

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

الخطوة 3: إعداد خدمات Firebase

بعد إعداد مهارات وأدوات الوكيل، يمكنك الآن استخدام اللغة الطبيعية لجعل وكيل ترميز الذكاء الاصطناعي الخاص بك يقوم بإعداد Cloud Firestore و Authentication و Firebase Hosting.

  1. اطلب من وكيلك إعداد الخدمة. على سبيل المثال، يمكنك استخدام طلبات مثل ما يلي:

    • إعداد Cloud Firestore كقاعدة بيانات لهذا التطبيق
    • أنشئ صفحة تسجيل دخول باستخدام Authentication وعدِّل Security Rules للتأكّد من أنّ المستخدمين المصرّح لهم فقط يمكنهم قراءة بياناتهم وكتابتها.
    • إعداد Firebase Hosting ونشر التطبيق في قناة الإصدار العلني
  2. راجِع أي معلومات واتّبِع أي خطوات إرشادية قد يقدّمها الوكيل، مثل:

    1. الخطط: يقترح الوكيل استراتيجية استنادًا إلى قاعدة الرموز الحالية.
    2. الربط: يربط الوكيل الرمز البرمجي المحلي بمشروع Firebase حالي أو يساعدك في إنشاء مشروع Firebase جديد.
    3. تهيئة الموارد: يقوم الوكيل الخاص بك بإضافة مكتبات Firebase والتكوين المطلوبين إلى قاعدة التعليمات البرمجية الخاصة بك.
    4. تحديث الملفات: يقوم الوكيل الخاص بك بإنشاء وتحديث أي ملفات ضرورية، مثل firestore.rules (لتحديد من يمكنه قراءة أو كتابة أو الاستعلام عن البيانات داخل قاعدة البيانات الخاصة بك) أو firebase.json (لإبلاغ Firebase CLI بالخدمات التي يجب نشرها وكيفية تكوينها).
    5. التنفيذ: يرشدك الموظف خلال خطوات الضبط أو النشر الإضافية.

نصائح عامة لتوجيه وكيل برمجة الذكاء الاصطناعي

لتحقيق أقصى استفادة من وكيل الترميز المستند إلى الذكاء الاصطناعي، خاصةً عند العمل على عمليات دمج متعددة الأوجه مثل Firebase، تعامَل مع التفاعل على أنّه تعاون وليس أمرًا لمرة واحدة.

تحديد التفاصيل وتقديم سياق

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

  • غير واضح: "أريد إصلاح خطأ قاعدة البيانات".
  • محدّد: "تظهر لي رسالة الخطأ 'تم رفض الإذن' عند محاولة الكتابة إلى مجموعة 'المستخدمين' في Cloud Firestore. راجِع firestore.rules واقتَرِح إصلاحًا يسمح للمستخدمين المصادَق عليهم بالكتابة في مستنداتهم."

التكرار والتحسين

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

  • تقديم رسائل الخطأ: ألصِق أي أخطاء في الجهاز أو سجلات وحدة التحكّم في المحادثة.
  • طلب إجراء تعديلات: "يستخدم هذا الرمز الإصدار القديم v8 من حزمة SDK. أعِد كتابة الرمز باستخدام حزمة تطوير البرامج (SDK) المعيارية الإصدار 9 من Firebase."
  • طلب توضيحات: "أريد شرحًا حول كيفية حماية Firebase Security Rules لبيانات المستخدمين".

التحقّق من صحة المعلومات قبل التنفيذ

على الرغم من أنّ وكلاء الترميز المستندين إلى الذكاء الاصطناعي فعّالون، إلّا أنّهم قد يرتكبون أخطاء أو "يهلوسون" (أي يبتكرون وظائف أو خدمات تحمل أسماء غير صحيحة).

  • مراجعة الرمز: احرص دائمًا على قراءة الرمز الذي تم إنشاؤه، خاصةً Firebase Security Rules وملفات الإعداد (مثل firebase.json)، قبل نشره في بيئة الإنتاج.
  • الاختبار محليًا: اطلب من الوكيل مساعدتك في اختبار التغييرات محليًا كلما أمكن ذلك قبل نشرها.

استخدام اتصال MCP

بما أنّ خادم Firebase MCP يتيح لوكيلك الاطّلاع مباشرةً على بنية مشروعك، يمكنك الرجوع إلى ملفات معيّنة للحصول على نصائح مخصّصة بشأن التنفيذ.

  • مثال: "أريد الاطّلاع على ملف src/web/index.html ومعرفة مكان إضافة النص البرمجي العادي لإعداد Firebase".

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