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


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

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

سير عمل موجَّه لتحديد المشاكل حسب الأولوية وحلّها

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


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


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

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

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

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

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

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

إذا كنت تعمل على مشروع Unity، يُرجى مراجعة الأسئلة الشائعة حول تحميل أدوات وطلبات Crashlytics 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"]
  }
}

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


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

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

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

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

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

  2. نفِّذ الأمر crashlytics:connect الخاص ببروتوكول MCP.

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

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

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


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

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

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

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

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


مرجع أداة MCP في "Crashlytics"

تعرض الجداول التالية أدوات MCP الـ Crashlytics المتاحة من خلال خادم 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_report crashlytics استخدِم هذا الخيار لطلب تقارير رقمية من Crashlytics. تجمع النتيجة مجموع الأحداث والمستخدمين المتأثرين، ويتم تجميعها حسب سمة مناسبة لهذا التقرير.


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

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

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

الأسعار

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

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

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