المساعدة المستندة إلى الذكاء الاصطناعي في Crashlytics من خلال "منصة المطوّرين في Google"


باستخدام Firebase Crashlytics أدوات MCP ومطالباتها، يمكنك التفاعل مع Crashlytics بياناتك باستخدام أدوات التطوير المستنِدة إلى الذكاء الاصطناعي والمتوافقة مع MCP، مثل Gemini CLI أو Claude Code أو Cursor. توفّر Crashlytics أدوات MCP ومطالباتها سياقًا مهمًا لأداة الذكاء الاصطناعي لمساعدتك في إدارة المشاكل وتحديد أولوياتها وتصحيحها وحلّها.

بعد إعداد خادم MCP في Firebase، يمكنك استخدام ميزات MCP في Crashlytics:

سير عمل إرشادي لتحديد الأولويات في المشاكل وحلّها

تصحيح الأخطاء في المحادثات ذات التصميم الحر


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



قبل البدء: إعداد خادم MCP في Firebase

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

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

تأكَّد من أنّ بيئتك تستوفي المتطلبات التالية:

  • يجب أن يكون لديك نسخة عاملة من Node.js وnpm. يؤدي تثبيت Node.js إلى تثبيت أدوات أوامر npm تلقائيًا.

  • تتيح أداة التطوير المستندة إلى الذكاء الاصطناعي عمليات تكامل MCP.

إذا كنت تعمل على مشروع Unity، راجِع الأسئلة الشائعة حول تحميل Crashlytics أدوات وإشعارات MCP.

ضبط أداة الذكاء الاصطناعي لاستخدام خادم MCP في Firebase

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

Gemini CLI

الطريقة المقترَحة لإعداد Gemini CLI لاستخدام خادم MCP في Firebase هي تثبيت إضافة Firebase لـ Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills/

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

بدلاً من ذلك، يمكنك ضبط إعدادات Gemini CLI لاستخدام خادم MCP في Firebase (ولكن ليس ملف سياق إضافة Firebase) من خلال تعديل أحد ملفات الإعداد أو إنشائه:

  • في مشروعك: .gemini/settings.json
  • في الدليل الرئيسي: ~/.gemini/settings.json

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

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

Gemini Code Assist

الطريقة المقترَحة لإعداد Gemini Code Assist لاستخدام خادم MCP من Firebase هي تثبيت إضافة Firebase لـ Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills/

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

بدلاً من ذلك، يمكنك ضبط Gemini Code Assist لاستخدام خادم MCP في Firebase (ولكن ليس ملف سياق إضافة Firebase)، وذلك من خلال تعديل أحد ملفات الإعداد أو إنشائه:

  • في مشروعك: .gemini/settings.json
  • في الدليل الرئيسي: ~/.gemini/settings.json

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

{
  "mcpServers": {
    "firebase": {
      "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 لاستخدام خادم Firebase MCP، عدِّل الملف 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"]
  }
}

بالإضافة إلى الإعداد الأساسي الموضّح أعلاه لكل أداة من أدوات الذكاء الاصطناعي، يمكنك تحديد مَعلمات اختيارية.



(يُنصح به) سير عمل إرشادي لتحديد المشاكل في crashlytics:connect وحلّها حسب الأولوية

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

يتوفّر سير العمل الموجّه هذا من خلال أمر crashlytics:connect MCP.

الوصول إلى الأمر واستخدامه

‫Gemini CLI باستخدام الأمر crashlytics:connect
استخدام أداة تعمل بالذكاء الاصطناعي، مثل Gemini CLI، مع crashlytics:connect سير العمل الإرشادي
  1. إذا لم يسبق لك إجراء ذلك، عليك إعداد خادم MCP على Firebase، ثم بدء استخدام أداة الذكاء الاصطناعي.

  2. نفِّذ أمر بروتوكول سياق النموذج (MCP) crashlytics:connect.

    توفّر معظم أدوات الذكاء الاصطناعي طريقة سهلة للوصول إلى سير العمل هذا. على سبيل المثال، إذا كنت تستخدم Gemini CLI، شغِّل الأمر الذي يبدأ بعلامة الشرطة المائلة /crashlytics:connect

  3. استخدِم أداة الذكاء الاصطناعي للمساعدة في تحديد أولويات مشاكل Crashlytics وحلّها، على سبيل المثال:

    • عرض قائمة بالمشاكل ذات الأولوية
    • تحديد المشكلة المحدّدة وحلّها من خلال تقديم رقم تعريفها أو عنوان URL الخاص بها
    • طلب المزيد من المعلومات حول عُطل
    • اطلب من الوكيل تقديم أسباب لاقتراح سبب أساسي.



تصحيح الأخطاء أثناء المحادثات الحرة

مع أنّنا ننصحك باستخدام crashlytics:connect للحصول على أفضل تجربة لتحديد المشاكل وحلّها، يمكنك أيضًا تحديد المشاكل وحلّها من خلال محادثة حرة مع إحدى أدوات الذكاء الاصطناعي التي تتيح الوصول إلى أدوات Crashlytics في "مركز شركاء المحتوى". ويُعدّ ذلك مهمًا بشكل خاص لأدوات الذكاء الاصطناعي التي لا تتوافق بعد مع طلبات MCP (يُشار إليها غالبًا باسم أوامر الشرطة المائلة أو الأوامر المخصّصة).

بعد إعداد خادم MCP على Firebase، جرِّب بعض الأمثلة التالية.

استرداد سياق المشكلة وتعطُّل التطبيق

عندما تتيح لأداة الذكاء الاصطناعي الوصول إلى Crashlytics أدوات MCP، يمكنها استرداد بيانات Crashlytics المشاكل المهمة، مثل عدد المستخدمين والأحداث، وعمليات تتبُّع تسلسل استدعاء الدوال البرمجية، والبيانات الوصفية، ومعلومات إصدار التطبيق.

في ما يلي بعض الأمثلة على الطلبات:

  • A customer reported an issue during login when using our latest release. What Crashlytics issues do I have that could be related to this login trouble?

    • للإجابة عن هذا السؤال، من المحتمل أن تقرأ أداة الذكاء الاصطناعي الرمز البرمجي لفهم مكان حدوث عملية تسجيل الدخول، ثم تستخدم أدوات Crashlytics MCP المختلفة لاسترداد بيانات المشكلة. بعد ذلك، ستحاول أداة الذكاء الاصطناعي تحديد ما إذا كانت هناك مشكلة في أحدث إصدار متعلقة بتسلسل تسجيل الدخول.
  • The previous on-call engineer was investigating issue abc123 but wasn't able to resolve it. She said she left some notes -- let's pick up where she left off.

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

توثيق عملية تصحيح الأخطاء

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

في ما يلي بعض الأمثلة على الطلبات:

  • Add a note to issue abc123 summarizing this investigation and the proposed fix.
  • We weren't able to get to the bottom of this issue today, summarize what we learned and attach it to issue abc123 to pick back up later.
  • Close issue abc123 and leave a note including the link to the PR that fixed the issue.



Crashlytics مرجع أداة MCP

تعرض الجداول التالية Crashlytics أدوات MCP المتاحة من خلال خادم MCP في Firebase.

بعد إعداد خادم MCP في Firebase، يمكن لأداة الذكاء الاصطناعي استخدام أدوات MCP هذه لمساعدتك في فهم المشاكل وتصحيح أخطائها وإدارتها. يتم استخدام أدوات MCP هذه في كل من crashlytics:connect سير العمل الموجّه والمحادثات الحرة مع أداة الذكاء الاصطناعي.

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

إدارة المشاكل Crashlytics

يوضّح الجدول التالي الأدوات المتاحة لإدارة مشاكل Crashlytics.

اسم الأداة مجموعة الميزات الوصف
crashlytics_create_note crashlytics إضافة ملاحظة إلى مشكلة من Crashlytics
crashlytics_delete_note crashlytics حذف ملاحظة من مشكلة في Crashlytics
crashlytics_update_issue crashlytics استخدِم هذا الحقل لتعديل حالة مشكلة Crashlytics.

استرجاع بيانات Crashlytics

يوضّح الجدول التالي الأدوات المتاحة للحصول على معلومات ذات صلة بـ Crashlytics حول تطبيقاتك.

اسم الأداة مجموعة الميزات الوصف
crashlytics_get_issue crashlytics تعرض هذه السمة بيانات عن مشكلة في Crashlytics، ويمكن استخدامها كنقطة بداية لتصحيح الأخطاء.
crashlytics_list_events crashlytics يُستخدَم هذا الخيار لعرض قائمة بأحدث الأحداث التي تتطابق مع الفلاتر المحدّدة.
يمكن استخدامه لجلب عيّنات من الأعطال والاستثناءات المرتبطة بمشكلة معيّنة،
والتي ستتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية وبيانات أخرى مفيدة لتصحيح الأخطاء.
crashlytics_batch_get_events crashlytics تعرض هذه الطريقة أحداثًا محدّدة حسب اسم المورد.
يمكن استخدامها لجلب عيّنات من الأعطال والاستثناءات لمشكلة معيّنة،
والتي ستتضمّن عمليات تتبُّع تسلسل استدعاء الدوال البرمجية وبيانات أخرى مفيدة لتصحيح الأخطاء.
crashlytics_list_notes crashlytics استخدِم هذا الحقل لإدراج جميع الملاحظات المتعلّقة بمشكلة في Crashlytics.
crashlytics_get_report crashlytics يُستخدَم هذا الخيار لطلب تقارير رقمية من Crashlytics. تجمع النتيجة مجموع الأحداث والمستخدمين المتأثرين، ويتم تجميعها حسب سمة مناسبة لهذا التقرير.



معلومات إضافية

كيفية استخدام بياناتك

يتم تحديد إدارة البيانات من خلال أداة التطوير المستندة إلى الذكاء الاصطناعي التي تستخدمها، وتخضع للبنود المحدّدة من خلال أداة الذكاء الاصطناعي هذه.

الأسعار

لا يفرض Firebase رسومًا مقابل استخدام Crashlytics أدوات وإشعارات MCP أو مقابل استرداد بيانات Crashlytics من واجهة برمجة التطبيقات العامة.

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

تحديد المشاكل وحلّها والأسئلة الشائعة