باستخدام أدوات بروتوكول سياق النموذج (MCP) والرسائل الفورية في Firebase Crashlytics، يمكنك التفاعل مع بيانات Crashlytics باستخدام أدوات التطوير المستندة إلى الذكاء الاصطناعي والمتوافقة مع بروتوكول سياق النموذج (MCP)، مثل Antigravity أو 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، راجِع الـ أسئلة الشائعة حول تحميل Crashlytics أدوات بروتوكول سياق النموذج (MCP) والرسائل الفورية.
ضبط أداة الذكاء الاصطناعي لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase
Antigravity
لضبط Antigravity لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase:
- في Antigravity، انقر على قائمة في لوحة "البرنامج الوكيل" > خوادم بروتوكول سياق النموذج (MCP).
- انقر على Firebase > تثبيت.
يؤدي ذلك إلى تعديل ملف mcp_config.json تلقائيًا، ويمكنك الاطّلاع عليه من خلال
النقر على إدارة خوادم بروتوكول سياق النموذج (MCP) في أعلى لوحة "متجر بروتوكول سياق النموذج (MCP)" >
عرض الإعدادات الأولية، مع المحتوى التالي:
{
"mcpServers": {
"firebase-mcp-server": {
"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:
أضِف سوق Firebase للمكوّنات الإضافية في Claude:
claude plugin marketplace add firebase/firebase-toolsثبِّت المكوّن الإضافي Claude لمنصة Firebase:
claude plugin install firebase@firebaseتحقَّق من عملية التثبيت:
claude plugin marketplace list
الخيار 2: ضبط خادم بروتوكول سياق النموذج (MCP) يدويًا
بدلاً من ذلك، يمكنك ضبط خادم بروتوكول سياق النموذج (MCP) في Firebase يدويًا:
نفِّذ الأمر التالي ضمن مجلد تطبيقك:
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 لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase، عدِّل ملف claude_desktop_config.json. يمكنك فتح هذا الملف أو إنشاؤه من قائمة Claude > الإعدادات. انقر على علامة التبويب المطوّر ، ثم على تعديل الإعدادات.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
كلاين"
لضبط Cline لاستخدام خادم بروتوكول سياق النموذج (MCP) في Firebase، عدِّل ملف cline_mcp_settings.json. يمكنك فتح هذا الملف أو إنشاؤه من خلال النقر على رمز "خوادم بروتوكول سياق النموذج (MCP)" في أعلى لوحة Cline، ثم النقر على الزر ضبط خوادم بروتوكول سياق النموذج (MCP).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
Cursor
الخيار 1: المكوّن الإضافي في السوق (مستحسن)
ثبِّت المكوّن الإضافي لمنصة Firebase من Cursor Marketplace. يؤدي ذلك إلى ضبط خادم بروتوكول سياق النموذج (MCP) تلقائيًا ويتيح الوصول إلى مهارات البرنامج الوكيل في Firebase.
الخيار 2: إعداد بروتوكول سياق النموذج (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.
الوصول إلى الأمر واستخدامه
إذا لم يسبق لك إجراء ذلك، اضبط خادم بروتوكول سياق النموذج (MCP) في Firebase، ثم ابدأ أداة الذكاء الاصطناعي.
نفِّذ أمر بروتوكول سياق النموذج (MCP)
crashlytics:connect.توفّر معظم أدوات الذكاء الاصطناعي طريقة للوصول بسهولة إلى سير العمل هذا. إذا كان البرنامج الوكيل لا يتوافق مع أوامر بروتوكول سياق النموذج (MCP)، ننصحك باستخدام تصحيح الأخطاء الحواري ذي التصميم المرن.
استخدِم أداة الذكاء الاصطناعي للمساعدة في تحديد أولويات مشاكل Crashlytics وحلّها، مثلاً:
- عرض قائمة بالمشاكل التي تم تحديد أولويتها
- تصحيح خطأ معيّن من خلال تقديم رقم تعريفه أو عنوان URL
- طلب مزيد من المعلومات حول عطل
- سؤال البرنامج الوكيل عن أسباب اقتراحه لسبب أساسي
تصحيح الأخطاء الحواري ذو التصميم المرن
ننصحك باستخدام crashlytics:connect للحصول على أفضل تجربة لتصحيح الأخطاء، ولكن يمكنك أيضًا تصحيح الأخطاء
باستخدام محادثة ذات تصميم مرن مع أداة ذكاء اصطناعي
يمكنها الوصول إلى أدوات بروتوكول سياق النموذج (MCP) 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) في 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.- للإجابة عن هذا السؤال، ستستخدم أداة الذكاء الاصطناعي أدوات مختلفة Crashlytics لبروتوكول سياق النموذج (MCP) في 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 لا يوفّر طريقة صريحة للتحكّم في مقدار البيانات التي يتم تحميلها في السياق، ولكننا نقدّم إرشادات تلقائية معقولة للنموذج.