با ابزارها و اعلانهای Firebase Crashlytics MCP، میتوانید با استفاده از ابزارهای توسعه مبتنی بر هوش مصنوعی که از MCP پشتیبانی میکنند، مانند Gemini CLI، Claude Code یا Cursor، با دادههای Crashlytics خود تعامل داشته باشید. این ابزارها و اعلانهای Crashlytics MCP زمینه حیاتی را برای ابزار هوش مصنوعی شما فراهم میکنند تا به شما در مدیریت، اولویتبندی، اشکالزدایی و رفع مشکلات کمک کنند.
پس از تنظیم سرور Firebase MCP ، میتوانید از ویژگیهای MCP برای Crashlytics استفاده کنید:
گردش کار هدایتشده برای اولویتبندی و رفع مشکلات
اشکالزدایی مکالمهای به صورت آزاد
MCP چیست؟ پروتکل زمینه مدل (MCP) یک روش استاندارد برای ابزارهای هوش مصنوعی جهت دسترسی به ابزارها و منابع داده خارجی است.
قبل از شروع: سرور Firebase MCP را راهاندازی کنید
این بخش تنظیمات اولیه سرور Firebase MCP را شرح میدهد تا بتوانید از دستورات، اعلانها و ابزارهای MCP مخصوص Crashlytics (که همگی بعداً در این صفحه توضیح داده شدهاند) استفاده کنید.
پیشنیازها
مطمئن شوید که محیط شما این الزامات را برآورده میکند:
- یک نصب فعال از Node.js و npm. نصب Node.js به طور خودکار ابزارهای دستوری npm را نصب میکند. 
- ابزار توسعه مبتنی بر هوش مصنوعی شما از ادغام MCP پشتیبانی میکند. 
اگر با یک پروژه Unity کار میکنید، سوالات متداول در مورد بارگیری ابزارها و اعلانهای Crashlytics MCP را مرور کنید.
ابزار هوش مصنوعی خود را برای استفاده از سرور Firebase MCP پیکربندی کنید
رابط خط فرمان جمینی
روش پیشنهادی برای راهاندازی رابط خط فرمان Gemini برای استفاده از سرور Firebase MCP، نصب افزونه Firebase برای Gemini CLI است:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/نصب افزونه Firebase به طور خودکار سرور Firebase MCP را پیکربندی میکند و همچنین با یک فایل context ارائه میشود که میتواند عملکرد توسعه برنامه Firebase در Gemini را بهبود بخشد.
از طرف دیگر، میتوانید Gemini CLI را طوری پیکربندی کنید که از سرور Firebase MCP (اما نه از فایل زمینه افزونه Firebase) استفاده کند، که این کار با ویرایش یا ایجاد یکی از فایلهای پیکربندی انجام میشود:
-  در پروژه شما: .gemini/settings.json
-  در دایرکتوری خانگی شما: ~/.gemini/settings.json
اگر فایل هنوز وجود ندارد، با کلیک راست روی دایرکتوری والد و انتخاب گزینه New file آن را ایجاد کنید. محتویات زیر را به فایل اضافه کنید:
{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}
دستیار کد جمینی
روش پیشنهادی برای راهاندازی Gemini Code Assist جهت استفاده از سرور Firebase MCP، نصب افزونه Firebase برای Gemini CLI است:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/نصب افزونه Firebase به طور خودکار سرور Firebase MCP را پیکربندی میکند و همچنین با یک فایل context ارائه میشود که میتواند عملکرد توسعه برنامه Firebase در Gemini را بهبود بخشد.
از طرف دیگر، میتوانید Gemini Code Assist را طوری پیکربندی کنید که از سرور Firebase MCP (اما نه از فایل زمینه افزونه Firebase) استفاده کند، برای این کار کافیست یکی از فایلهای پیکربندی را ویرایش یا ایجاد کنید:
-  در پروژه شما: .gemini/settings.json
-  در دایرکتوری خانگی شما: ~/.gemini/settings.json
اگر فایل هنوز وجود ندارد، با کلیک راست روی دایرکتوری والد و انتخاب گزینه New file آن را ایجاد کنید. محتویات زیر را به فایل اضافه کنید:
{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}
استودیوی فایربیس
 برای پیکربندی Firebase Studio جهت استفاده از سرور Firebase MCP، فایل پیکربندی .idx/mcp.json  را ویرایش یا ایجاد کنید.
اگر فایل هنوز وجود ندارد، با کلیک راست روی دایرکتوری والد و انتخاب گزینه New file آن را ایجاد کنید. محتویات زیر را به فایل اضافه کنید:
{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}
کلود
کلود کد
برای پیکربندی Claude Code برای استفاده از سرور Firebase MCP، دستور زیر را در پوشه app خود اجرا کنید:
claude mcp add firebase npx -- -y firebase-tools@latest mcpمیتوانید با اجرای دستور زیر، نصب را تأیید کنید:
claude mcp listباید نشان دهد:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
دسکتاپ کلود
 برای پیکربندی Claude Desktop برای استفاده از سرور Firebase MCP، فایل claude_desktop_config.json را ویرایش کنید. میتوانید این فایل را از منوی Claude > Settings باز یا ایجاد کنید. تب Developer را انتخاب کنید، سپس روی Edit Config کلیک کنید.
{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}
کلاین
 برای پیکربندی Cline برای استفاده از سرور Firebase MCP، فایل cline_mcp_settings.json را ویرایش کنید. میتوانید با کلیک روی آیکون MCP Servers در بالای پنل Cline و سپس کلیک روی دکمه Configure MCP Servers ، این فایل را باز یا ایجاد کنید. 
{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}
مکان نما
 برای پیکربندی Cursor برای استفاده از سرور Firebase MCP، فایل .cursor/mcp.json (برای پیکربندی فقط یک پروژه خاص) یا فایل ~/.cursor/mcp.json (برای در دسترس قرار دادن سرور MCP در همه پروژهها) را ویرایش کنید: 
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}
کمک خلبان کد VS
 برای پیکربندی یک پروژه واحد، فایل .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، فایل ~/.codeium/windsurf/mcp_config.json را ویرایش کنید: 
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}
علاوه بر پیکربندی اولیهای که در بالا برای هر ابزار هوش مصنوعی توضیح داده شد، میتوانید پارامترهای اختیاری را نیز مشخص کنید .
 (توصیه میشود) گردش کار هدایتشده برای اولویتبندی و رفع مشکلات با crashlytics:connect
Crashlytics یک گردش کار هدایتشده ارائه میدهد که محاورهای و انعطافپذیر است و به شما کمک میکند تا مشکلات Crashlytics در برنامه خود اولویتبندی و برطرف کنید. به عنوان مثال، ابزار هوش مصنوعی شما میتواند مشکلات را دریافت کند، آنها را توضیح دهد، اصلاحات بالقوه را شناسایی کند و حتی تغییرات کد را برای شما انجام دهد.
 این گردش کار هدایتشده از طریق دستور crashlytics:connect MCP در دسترس است.
دسترسی و استفاده از دستور

crashlytics:connect استفاده کنید.- اگر هنوز این کار را نکردهاید، سرور Firebase MCP را راهاندازی کنید و سپس ابزار هوش مصنوعی خود را اجرا کنید. 
- دستور - crashlytics:connectMCP را اجرا کنید.- بیشتر ابزارهای هوش مصنوعی راهی برای دسترسی راحت به این گردش کار ارائه میدهند. برای مثال، اگر از رابط خط فرمان Gemini استفاده میکنید، دستور slash را اجرا کنید. - /crashlytics:connect
- از ابزار هوش مصنوعی خود برای کمک به اولویتبندی و رفع مشکلات Crashlytics استفاده کنید، برای مثال: - فهرستی از مسائل اولویتدار را مشاهده کنید.
- با ارائه شناسه یا نشانی اینترنتی (URL) یک مشکل خاص، آن را اشکالزدایی کنید.
- درخواست اطلاعات بیشتر در مورد یک تصادف.
- از نماینده دلیل پیشنهاد شده برای علت اصلی را بپرسید.
 
اشکالزدایی مکالمهای به صورت آزاد
 اگرچه برای بهترین تجربه اشکالزدایی، استفاده از crashlytics:connect را توصیه میکنیم، اما میتوانید با استفاده از یک مکالمه آزاد با یک ابزار هوش مصنوعی که به ابزارهای MCP Crashlytics دسترسی دارد، مشکلات را اشکالزدایی کنید. این امر به ویژه برای ابزارهای هوش مصنوعی که هنوز از دستورات MCP (که اغلب به عنوان دستورات اسلش یا دستورات سفارشی شناخته میشوند) پشتیبانی نمیکنند، بسیار مهم است.
پس از راهاندازی سرور Firebase MCP ، برخی از مثالهای زیر را امتحان کنید.
دریافت یک مشکل و زمینه خرابی
وقتی ابزار هوش مصنوعی شما به ابزارهای Crashlytics MCP دسترسی داشته باشد، میتواند دادههای مهم مربوط به مشکلات Crashlytics مانند تعداد کاربران و رویدادها، stacktraces، فرادادهها و اطلاعات نسخه برنامه را دریافت کند.
در اینجا چند نمونه از دستورالعملها آورده شده است:
- 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 را که از طریق سرور Firebase MCP در دسترس هستند، فهرست میکنند.
 پس از راهاندازی سرور Firebase MCP ، ابزار هوش مصنوعی شما میتواند از این ابزارهای MCP برای کمک به شما در درک، اشکالزدایی و مدیریت مشکلات استفاده کند. این ابزارهای MCP هم در گردش کار هدایتشده crashlytics:connect و هم در مکالمات آزاد با ابزار هوش مصنوعی شما استفاده میشوند.
در اکثر موارد استفاده، این ابزارهای MCP فقط برای استفاده LLM هستند و نه برای استفاده مستقیم توسط یک توسعهدهنده انسانی. LLM بر اساس تعامل شما با ابزار هوش مصنوعیتان تصمیم میگیرد که چه زمانی از این ابزارهای MCP استفاده کند.
مدیریت مشکلات Crashlytics
جدول زیر ابزارهای موجود برای مدیریت مشکلات Crashlytics شما را شرح میدهد.
| نام ابزار | گروه ویژه | توضیحات | 
|---|---|---|
| crashlytics_create_note | کراشلیتیک | اضافه کردن یادداشت به یک مشکل از crashlytics. | 
| crashlytics_delete_note | کراشلیتیک | حذف یادداشت از مشکل Crashlytics. | 
| crashlytics_update_issue | کراشلیتیک | از این برای بهروزرسانی وضعیت مشکل Crashlytics استفاده کنید. | 
واکشی دادههای Crashlytics
جدول زیر ابزارهای موجود برای دریافت اطلاعات مربوط به Crashlytics در مورد برنامههای شما را شرح میدهد.
| نام ابزار | گروه ویژه | توضیحات | 
|---|---|---|
| crashlytics_get_issue | کراشلیتیک | دادههای مربوط به یک مشکل Crashlytics را دریافت میکند که میتواند به عنوان نقطه شروع برای اشکالزدایی استفاده شود. | 
| crashlytics_list_events | کراشلیتیک | از این برای فهرست کردن جدیدترین رویدادهای منطبق با فیلترهای داده شده استفاده کنید. میتواند برای دریافت نمونهی خرابیها و استثنائات یک مشکل استفاده شود، که شامل ردپاهای پشته و سایر دادههای مفید برای اشکالزدایی خواهد بود. | 
| crashlytics_batch_get_events | کراشلیتیک | رویدادهای خاص را بر اساس نام منبع دریافت میکند. میتواند برای دریافت نمونهی خرابیها و استثنائات یک مشکل استفاده شود، که شامل ردپاهای پشته و سایر دادههای مفید برای اشکالزدایی خواهد بود. | 
| لیست_یادداشتهای_crashlytics | کراشلیتیک | از این برای فهرست کردن تمام یادداشتهای مربوط به یک مشکل در Crashlytics استفاده کنید. | 
| crashlytics_get_top_issues | کراشلیتیک | از این برای شمارش رویدادها و کاربران تحت تأثیر متمایز، گروهبندی شده بر اساس مشکل ، استفاده کنید. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. | 
| crashlytics_get_top_variants | کراشلیتیک | رویدادها و کاربران آسیبدیدهی متمایز را بر اساس نوع مشکل گروهبندی میکند. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. | 
| crashlytics_get_top_versions | کراشلیتیک | رویدادها و کاربران تحت تأثیر متمایز را بر اساس نسخه گروهبندی میکند. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. | 
| crashlytics_get_top_apple_devices | کراشلیتیک | رویدادها و کاربران تحت تأثیر متمایز را بر اساس دستگاه اپل گروهبندی میکند. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. فقط برای برنامههای iOS، iPadOS و MacOS مرتبط است. | 
| crashlytics_get_top_android_devices | کراشلیتیک | رویدادها و کاربران تحت تأثیر متمایز را بر اساس دستگاه اندروید گروهبندی میکند. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. فقط برای برنامههای اندروید مناسب است. | 
| crashlytics_get_top_operating_systems | کراشلیتیک | رویدادها و کاربران تحت تأثیر متمایز را بر اساس سیستم عامل گروهبندی میکند. گروهها بر اساس تعداد رویدادها و به ترتیب نزولی مرتب شدهاند. فقط رویدادهایی را که با فیلترهای داده شده مطابقت دارند، شمارش میکند. | 
اطلاعات تکمیلی
نحوه استفاده از دادههای شما
مدیریت دادهها توسط ابزار توسعه مبتنی بر هوش مصنوعی که شما استفاده میکنید تعیین میشود و تابع شرایط تعریفشده توسط آن ابزار هوش مصنوعی است.
قیمتگذاری
فایربیس برای استفاده از ابزارها و اعلانهای Crashlytics MCP یا دریافت دادههای Crashlytics از API عمومی ما، هیچ هزینهای از شما دریافت نمیکند.
هرگونه هزینهای توسط ابزار توسعه مبتنی بر هوش مصنوعی که استفاده میکنید تعیین میشود و میتواند توسط حجم دادههای Crashlytics که توسط ابزار هوش مصنوعی استفاده میشود، تعیین شود. توجه داشته باشید که Firebase روش صریحی برای کنترل میزان بارگذاری دادهها در context ارائه نمیدهد، اما ما راهنماییهای پیشفرض معقولی را برای مدل در نظر گرفتهایم.
عیبیابی و سوالات متداول
سرور Firebase MCP با بررسی وابستگیهای نصبشده، تلاش میکند تا تشخیص دهد که چه زمانی یک کدبیس از Crashlytics استفاده میکند. این قابلیت هنوز برای پروژههای Unity پشتیبانی نمیشود و برخی از سیستمهای مدیریت وابستگی غیراستاندارد برای سایر پلتفرمها را پوشش نمیدهد.
 اگر ابزارها و اعلانهای Crashlytics MCP برای شما بارگیری نمیشوند، به عنوان یک راه حل، میتوانید سرور Firebase MCP را به صورت دستی نصب کنید و از آرگومان --only crashlytics برای بارگیری ابزارها و اعلانهای Crashlytics MCP استفاده کنید.