کمک هوش مصنوعی برای Crashlytics از طریق MCP


با ابزارها و اعلان‌های 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 در دسترس است.

دسترسی و استفاده از دستور

رابط خط فرمان Gemini با استفاده از دستور crashlytics:connect
از یک ابزار هوش مصنوعی، مانند Gemini CLI، به همراه گردش کار هدایت‌شده‌ی crashlytics:connect استفاده کنید.
  1. اگر هنوز این کار را نکرده‌اید، سرور Firebase MCP را راه‌اندازی کنید و سپس ابزار هوش مصنوعی خود را اجرا کنید.

  2. دستور crashlytics:connect MCP را اجرا کنید.

    بیشتر ابزارهای هوش مصنوعی راهی برای دسترسی راحت به این گردش کار ارائه می‌دهند. برای مثال، اگر از رابط خط فرمان Gemini استفاده می‌کنید، دستور slash را اجرا کنید. /crashlytics:connect

  3. از ابزار هوش مصنوعی خود برای کمک به اولویت‌بندی و رفع مشکلات 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 ارائه نمی‌دهد، اما ما راهنمایی‌های پیش‌فرض معقولی را برای مدل در نظر گرفته‌ایم.

عیب‌یابی و سوالات متداول