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


باستخدام أدوات Firebase Crashlytics MCP والطلبات، يمكنك التفاعل مع بيانات Crashlytics باستخدام أدوات التطوير المستنِدة إلى الذكاء الاصطناعي والمتوافقة مع MCP، مثل Antigravity أو 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"]
    }
  }
}

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

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


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

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

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

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

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

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

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

  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.

    • للإجابة عن هذا السؤال، ستستخدم أداة الذكاء الاصطناعي أدوات مختلفة من 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 مرجع أداة 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 لا يوفّر طريقة واضحة للتحكّم في مقدار البيانات التي يتم تحميلها في السياق، ولكنّنا نقدّم إرشادات منطقية تلقائية للنموذج.

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