دمج خدمات 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

يتم تضمين مهارات وكيل Firebase كإحدى حِزم الدمج Build with Google في Antigravity. يمكنك تفعيل هذه الحزمة للوصول على مستوى العالم في نقطتَين:

  • أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار بجانب حزمة Firebase.
  • في الإعدادات: انتقِل إلى الإعدادات > التخصيصات. ضمن Build with Google Plugins (إنشاء باستخدام مكوّنات Google الإضافية)، انقر على تخصيص (Customize)، ثم انقر على تنزيل (Download) لدمج Firebase.

إذا كنت تفضّل الوصول على مستوى المشروع، نفِّذ الأمر التالي في دليل مشروعك:

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

Claude Code 

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

Codex 

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

المؤشر

يمكنك تثبيت مهارات وكيل Firebase مباشرةً من سوق Cursor أو عن طريق تنفيذ الأمر التالي في الوحدة الطرفية:

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

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

npx skills add firebase/agent-skills

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

مع أنّ العديد من مهارات وكيل Firebase تستخدم واجهة سطر الأوامر Firebase لتنفيذ المهام، ننصحك بربط وكيل الترميز المستنِد إلى الذكاء الاصطناعي بخادم MCP في Firebase. يعزّز هذا الربط قدرة وكيلك على التفاعل مع بيئة 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 > الإعدادات. انقر على علامة التبويب المطوّر، ثم على تعديل الإعدادات.

{
  "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 Copilot

لضبط إعدادات مشروع واحد، عدِّل ملف .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 بالخدمات التي يجب نشرها وكيفية إعدادها).
    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".

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