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


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

بعد إعداد خادم بروتوكول سياق النموذج (MCP) في Firebase، يمكنك استخدام ميزات بروتوكول سياق النموذج (MCP) في Crashlytics:

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

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


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



قبل البدء: إعداد خادم بروتوكول سياق النموذج (MCP) في Firebase

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

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

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

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

  • تتوافق أداة التطوير المستندة إلى الذكاء الاصطناعي مع عمليات الدمج في بروتوكول سياق النموذج (MCP).

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

ضبط أداة الذكاء الاصطناعي لاستخدام خادم بروتوكول سياق النموذج (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/gemini-cli-extensions/firebase/

يؤدي تثبيت إضافة Firebase إلى ضبط خادم بروتوكول سياق النموذج (MCP) في Firebase تلقائيًا، كما يتضمّن ملف سياق يمكنه تحسين أداء 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/gemini-cli-extensions/firebase/

يؤدي تثبيت إضافة Firebase إلى ضبط خادم بروتوكول سياق النموذج (MCP) في Firebase تلقائيًا، كما يتضمّن ملف سياق يمكنه تحسين أداء 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 لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase، عدِّل ملف الإعداد أو أنشِئه: .idx/mcp.json.

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

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

Claude

Claude Code

  • الخيار 1: التثبيت من خلال مكوّن إضافي (مُقترَح)

    أسهل طريقة لإعداد خادم بروتوكول سياق النموذج (MCP) في Firebase في Claude Code هي تثبيت المكوّن الإضافي الرسمي لـ Firebase:

    1. أضِف سوق 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 لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase، عدِّل ملف 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

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

يتوفّر سير العمل المُوجَّه هذا من خلال أمر بروتوكول سياق النموذج (MCP) ‏crashlytics:connect.

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

‫Gemini CLI باستخدام الأمر crashlytics:connect
استخدِم أداة ذكاء اصطناعي، مثل Gemini CLI، مع crashlytics:connect سير العمل المُوجَّه.
  1. إذا لم يسبق لك إجراء ذلك، اضبط خادم بروتوكول سياق النموذج (MCP) في Firebase، ثم ابدأ أداة الذكاء الاصطناعي.

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

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

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

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



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

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

بعد إعداد خادم بروتوكول سياق النموذج (MCP) في Firebase، جرِّب بعض الأمثلة التالية.

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

عندما تتمكّن أداة الذكاء الاصطناعي من الوصول إلى أدوات بروتوكول سياق النموذج (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?

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

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

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

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

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

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