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

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

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

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

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

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

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

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

خدمات Firebase السارية

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

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

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

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

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

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

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

Antigravity

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

    يتم تضمين مهارات وكلاء Firebase في المكوّن الإضافي Firebase في Antigravity Marketplace (وكحزمة تكامل Build with Google). ثبِّت المكوّن الإضافي باستخدام أي من الخيارات التالية:

    • من "سوق Antigravity": انقر على التخصيصات، واختَر علامة التبويب السوق، ثم انقر على + في بطاقة المكوّن الإضافي Firebase.
    • في Antigravity CLI: شغِّل /plugin install firebase@agent-marketplace (أو شغِّل /plugin وثبِّت Firebase من علامة التبويب اقتراحات). تتم أيضًا مزامنة المكوّنات الإضافية المثبّتة في Antigravity تلقائيًا مع Antigravity CLI.
    • أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار الخاص بمجموعة Firebase.

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

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

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

Claude Code

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

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

Codex

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

Cursor

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

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

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

وكلاء آخرون

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

npx skills add firebase/agent-skills

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

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

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

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

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

Antigravity

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

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

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

{
  "mcpServers": {
    "firebase-mcp-server": {
      "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 يدويًا

    بدلاً من ذلك، يمكنك ضبط خادم Firebase MCP يدويًا:

    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"]
    }
  }
}

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"]
  }
}

Cline

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

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

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 وFirebase 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، يجب التعامل مع التفاعل على أنّه تعاون وليس أمرًا واحدًا.

قدِّم طلبات دقيقة مع سياق واضح

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

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

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

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

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

التحقّق قبل التنفيذ

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

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

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

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

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

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