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


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

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

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

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


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



قبل البدء: إعداد خادم "التحويل المتعدّد الأطراف" (MCP) في Firebase

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

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

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

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

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

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

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

Gemini CLI

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

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

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

بدلاً من ذلك، يمكنك ضبط Gemini CLI لاستخدام خادم Firebase MCP (ولكن ليس ملف سياق إضافة 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/gemini-cli-extensions/firebase/

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

بدلاً من ذلك، يمكنك ضبط Gemini Code Assist لاستخدام خادم Firebase MCP (وليس ملف سياق إضافة 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

لضبط Claude Code لاستخدام خادم Firebase MCP، شغِّل الأمر التالي ضمن مجلد تطبيقك:

claude mcp add firebase npx -- -y firebase-tools@latest mcp

يمكنك التحقّق من عملية التثبيت من خلال تنفيذ الأمر التالي:

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

المؤشر

لضبط Cursor لاستخدام خادم MCP على Firebase، عدِّل الملف .cursor/mcp.json (لضبط مشروع معيّن فقط) أو الملف ~/.cursor/mcp.json (لإتاحة خادم MCP في جميع المشاريع):

"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. إذا لم يسبق لك إجراء ذلك، عليك إعداد خادم Firebase MCP، ثم بدء تشغيل أداة الذكاء الاصطناعي.

  2. نفِّذ crashlytics:connect أمر MCP.

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

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

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



تصحيح الأخطاء الحواري ذو التصميم المرن

مع أنّنا ننصحك باستخدام crashlytics:connect للحصول على أفضل تجربة لتحديد المشاكل وحلّها، يمكنك أيضًا تحديد المشاكل وحلّها من خلال محادثة حرة مع إحدى أدوات الذكاء الاصطناعي التي تتيح الوصول إلى أدوات Crashlytics MCP. ويُعدّ ذلك مهمًا بشكل خاص لأدوات الذكاء الاصطناعي التي لا تتوافق بعد مع طلبات 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.

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

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

عند تصحيح خطأ، من المفيد غالبًا الاحتفاظ بسجلات لنفسك أو لفريقك. توفّر 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 مرجع أداة "برنامج الشركاء المعتمدين"

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

بعد إعداد خادم Firebase MCP، يمكن لأداة الذكاء الاصطناعي استخدام أدوات 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_top_issues crashlytics استخدِم هذا الحقل لاحتساب الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعهم حسب المشكلة.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.
crashlytics_get_top_variants crashlytics تحسب هذه السمة عدد الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعها حسب نوع المشكلة.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.
crashlytics_get_top_versions crashlytics يحتسب هذا المقياس عدد الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعها حسب الإصدار.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.
crashlytics_get_top_apple_devices crashlytics تحسب هذه السمة الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعها حسب جهاز Apple.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.
ينطبق ذلك على تطبيقات iOS وiPadOS وMacOS فقط.
crashlytics_get_top_android_devices crashlytics تحسب هذه السمة الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعها حسب جهاز Android.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.
ينطبق ذلك على تطبيقات Android فقط.
crashlytics_get_top_operating_systems crashlytics تحسب هذه البطاقة عدد الأحداث والمستخدمين المتأثرين المختلفين، ويتم تجميعها حسب نظام التشغيل.
يتم ترتيب المجموعات حسب عدد الأحداث، بترتيب تنازلي.
يتم احتساب الأحداث المطابقة للفلاتر المحدّدة فقط.



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

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

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

الأسعار

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

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

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