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

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

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

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

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

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

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

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

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

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

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

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

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

توضّح الخطوات التالية سير عمل عامًا لكيفية استخدام مهارات وكيل Firebase لإعداد خدمات Firebase واستخدامها في تطبيق ويب. في الخلفية، تستخدم مهارات الوكيل واجهة سطر الأوامر (CLI) Firebase وخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase لإكمال هذه المهام.

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

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

Antigravity

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

  • أثناء الإعداد: يمكنك وضع علامة في مربّع الاختيار بجانب حزمة Firebase.
  • في الإعدادات: يمكنك الانتقال إلى الإعدادات > التخصيصات. Under المكوّنات الإضافية "الإنشاء باستخدام Google", click تخصيص, then click تنزيل لتكامل 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

Cursor

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

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

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

npx skills add firebase/agent-skills

الخطوة 2: الربط بخادم بروتوكول سياق النموذج (MCP) لمنصة Firebase

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

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

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

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

Antigravity

لضبط Antigravity لاستخدام خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase:

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

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

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

Firebase Studio

لضبط Firebase Studio لاستخدام خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase، يمكنك تعديل ملف الإعداد أو إنشاؤه: .idx/mcp.json.

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

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

Claude

Claude Code

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

    أسهل طريقة لإعداد خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase في 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 لاستخدام خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase، يمكنك تعديل ملف claude_desktop_config.json. يمكنك فتح هذا الملف أو إنشاؤه من قائمة Claude > الإعدادات (Settings). انقر على علامة التبويب المطوّر (Developer)، ثم على تعديل الإعدادات (Edit Config).

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

كلاين"

لضبط Cline لاستخدام خادم بروتوكول سياق النموذج (MCP) لمنصة Firebase، يمكنك تعديل ملف cline_mcp_settings.json. يمكنك فتح هذا الملف أو إنشاؤه من خلال النقر على رمز "خوادم MCP" (MCP Servers) في أعلى لوحة Cline، ثم النقر على الزر ضبط خوادم MCP (Configure MCP Servers).

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

Cursor

الخيار 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

لإعداد 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 يقدّم للوكيل سياقًا كبيرًا عن مشروعك، فإنّ الطلبات الواضحة والمحددة باللغة الطبيعية تحقّق أفضل النتائج. تجنَّب الطلبات الغامضة.

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

كرِّر الأسئلة وحسِّنها

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

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

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

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

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

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

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

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

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