کمک هوشواره‌ای برای Crashlytics ازطریق MCP


با Firebase Crashlytics ابزارها و پیام‌واره‌های MCP، می‌توانید بااستفاده از ابزارهای توسعه هوش مصنوعی با قابلیت MCP، مانند Antigravity، Claude Code، یا Cursor، با داده‌های Crashlytics خود تعامل داشته باشید. این Crashlytics ابزار و پیام‌واره MCP بافتار مهمی را برای ابزار هوش مصنوعی شما فراهم می‌کنند تا به شما در مدیریت، اولویت‌بندی، اشکال‌زدایی، و رفع مشکلات کمک کنند.

پس‌از راه‌اندازی سرور Firebase MCP، می‌توانید از ویژگی‌های MCP برای Crashlytics استفاده کنید:

گردش کار راهنمایی‌شده برای اولویت‌بندی و رفع مشکلات

اشکال‌زدایی مکالمه‌ای با قالب آزاد


MCP چیست؟ پروتکل بافتار مدل (MCP) روشی استانداردشده برای ابزارهای هوش مصنوعی است تا به ابزارها و منابع داده خارجی دسترسی پیدا کنند.



قبل‌از شروع: سرور Firebase MCP را راه‌اندازی کنید

این بخش راه‌اندازی اولیه سرور MCP در Firebase را شرح می‌دهد تا بتوانید از فرمان‌ها، پیام‌واره‌ها، و ابزارهای MCP مختص Crashlytics (که همه آن‌ها در ادامه این صفحه شرح داده شده‌اند) استفاده کنید.

پیش‌نیازها

مطمئن شوید محیط شما این الزامات را برآورده می‌کند:

  • نصب فعال Node.js و npm. با نصب Node.js، ابزارهای فرمان npm به‌طور خودکار نصب می‌شوند.

  • ابزار توسعه مجهز به هوش مصنوعی شما از ادغام‌های MCP پشتیبانی می‌کند.

اگر با پروژه Unity کار می‌کنید، پرسشگان مربوط به بار کردن ابزارها و پیام‌واره‌های Crashlytics MCP را مرور کنید.

پیکربندی کردن ابزار هوش مصنوعی برای استفاده از سرور Firebase MCP

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"]
    }
  }
}

Claude

Claude Code

  • گزینه ۱: نصب ازطریق افزایه (توصیه‌شده)

    ساده‌ترین راه برای راه‌اندازی سرور 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
  • گزینه ۲: پیکربندی دستی سرور 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"]
    }
  }
}

مکان‌نما

گزینه ۱: افزایه Marketplace (توصیه‌شده)

افزایه Firebase را از Cursor Marketplace نصب کنید. این کار به‌طور خودکار سرور MCP را پیکربندی می‌کند و دسترسی به مهارت‌های عامل Firebase را فراهم می‌کند.

گزینه ۲: راه‌اندازی MCP با یک کلیک

اگر فقط می‌خواهید سرور MCP را به پیکربندی سراسری‌تان اضافه کنید، روی دکمه زیر کلیک کنید:

نصب کردن سرور MCP

گزینه ۳: پیکربندی دستی

اگر ترجیح می‌دهید سرور را برای پروژه خاصی پیکربندی کنید یا می‌خواهید تنظیماتتان را به‌صورت دستی ویرایش کنید، فایل mcp.json را به‌روز کنید:

  • برای پروژه‌ای خاص، .cursor/mcp.json را ویرایش کنید
  • برای همه پروژه‌ها (سراسری)، ~/.cursor/mcp.json را ویرایش کنید
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

کلین

برای پیکربندی 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. فرمان MCP‏ crashlytics:connect را اجرا کنید.

    اکثر ابزارهای هوش مصنوعی راهی برای دسترسی راحت به این گردش کار ارائه می‌دهند. اگر نماینده شما از فرمان‌های MCP پشتیبانی نمی‌کند، توصیه می‌کنیم از اشکال‌زدایی مکالمه‌ای آزاد استفاده کنید.

  3. از ابزار هوش مصنوعی‌تان برای کمک به اولویت‌بندی و رفع Crashlytics مشکل استفاده کنید، برای مثال:

    • فهرست مشکلات اولویت‌بندی‌شده را مشاهده کنید.
    • با ارائه شناسه یا نشانی وب مشکل، آن را اشکال‌زدایی کنید.
    • درخواست اطلاعات بیشتر درباره خرابی.
    • از عامل بخواهید استدلال خود را برای علت ریشه‌ای پیشنهادی ارائه دهد.



اشکال‌زدایی مکالمه‌ای قالب آزاد

درحالی‌که توصیه می‌کنیم برای داشتن بهترین تجربه اشکال‌زدایی از 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.



‫Crashlytics مرجع ابزار MCP

جدول‌های زیر Crashlytics ابزار MCP را که ازطریق سرور Firebase MCP دردسترس هستند فهرست می‌کند.

پس‌از راه‌اندازی سرور Firebase MCP، ابزار هوش مصنوعی شما می‌تواند از این ابزارهای MCP برای کمک به شما در درک، اشکال‌زدایی، و مدیریت مشکلات استفاده کند. این ابزارهای MCP هم در گردش کار راهنمایی‌شده crashlytics:connect و هم در مکالمه‌های قالب آزاد با ابزار هوش مصنوعی شما استفاده می‌شوند.

در اکثر موارد استفاده، این ابزارهای MCP فقط برای استفاده LLM هستند و برای استفاده مستقیم توسعه‌دهنده انسانی نیستند. مدل زبانی بزرگ براساس تعامل شما با ابزار هوش مصنوعی تصمیم می‌گیرد که چه زمانی از این ابزارهای MCP استفاده کند.

مدیریت کردن مشکلات Crashlytics

جدول زیر ابزارهای دردسترس برای مدیریت مشکلات Crashlytics را شرح می‌دهد.

نام ابزار گروه ویژگی شرح
crashlytics_create_note crashlytics یادداشتی به مشکل از crashlytics اضافه کنید.
با حذف این پروژه، همه داده‌های Crashlytics مرتبط با آن برای همیشه حذف خواهد شد. crashlytics حذف یادداشت از مشکل Crashlytics.
مشکل به‌روزرسانی Crashlytics 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 روش صریحی برای کنترل میزان داده‌ای که در بافت بار می‌شود ارائه نمی‌دهد، اما ما راهنمایی پیش‌فرض معقولی برای مدل ارائه می‌دهیم.

عیب‌یابی و پرسشگان