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


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

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

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

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


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



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

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

پیش‌نیازها

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

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

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

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

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

Antigravity

برای پیکربندی Antigravity برای استفاده از سرور Firebase MCP:

  1. در Antigravity، روی منو در قاب «کارگزار» > سرورهای MCP کلیک کنید.
  2. Firebase > نصب را انتخاب کنید.

این کار به‌طور خودکار فایل mcp_config.json شما را به‌روزرسانی می‌کند، که می‌توانید با کلیک کردن روی مدیریت سرورهای MCP در بالای قاب «فروشگاه MCP» > مشاهده پیکربندی خام، با محتوای زیر، آن را مشاهده کنید:

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

Claude

کد Claude

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

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

    یا می‌توانید سرور Firebase MCP را به‌صورت دستی پیکربندی کنید:

    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 برای استفاده از سرور Firebase MCP، فایل 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

برای پیکربندی 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"]
    }
  }
}

بادسوار

برای پیکربندی «ویرایشگر موج‌سواری با باد»، فایل ~/.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. فرمان crashlytics:connect MCP را اجرا کنید.

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

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

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



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

اگرچه توصیه می‌کنیم برای بهترین تجربه اشکال‌زدایی از crashlytics:connect استفاده کنید، اما می‌توانید بااستفاده از مکالمه آزاد با ابزار هوش مصنوعی که به ابزارهای Crashlytics MCP دسترسی دارد، مشکلات را اشکال‌زدایی کنید. این موضوع به‌ویژه برای ابزارهای هوش مصنوعی که هنوز از پیام‌واره‌های MCP پشتیبانی نمی‌کنند (که اغلب به‌عنوان فرمان‌های خط‌مشی یا فرمان‌های سفارشی شناخته می‌شوند) اهمیت دارد.

پس‌از راه‌اندازی سرور Firebase MCP، برخی‌از نمونه‌های زیر را امتحان کنید.

واکشی مشکل و بافت خرابی

وقتی ابزار هوش مصنوعی شما به ابزارهای 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 برای بازیابی داده‌های مشکل استفاده می‌کند. سپس ابزار هوش مصنوعی شما تلاش می‌کند تعیین کند آیا مشکلی در جدیدترین نسخه وجود دارد که به جریان ورود مربوط باشد یا نه.
  • 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 هستند و برای استفاده مستقیم توسط توسعه‌دهنده انسانی نیستند. «مدل زبانی بزرگ» براساس تعامل شما با ابزار هوش مصنوعی‌تان تصمیم می‌گیرد چه زمانی از این ابزارهای 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 برای استفاده از ابزارها و پیام‌واره‌های Crashlytics MCP یا برای واکشی داده‌های Crashlytics از میانای برنامه‌سازی کاربردی عمومی ما از شما هزینه دریافت نمی‌کند.

هر هزینه‌ای توسط ابزار توسعه با بهره‌گیری از هوش مصنوعی که استفاده می‌کنید تعیین می‌شود و می‌تواند براساس حجم داده‌های Crashlytics که توسط ابزار هوش مصنوعی استفاده می‌شود تعیین شود. توجه داشته باشید که Firebase روش صریحی برای کنترل میزان داده بارگذاری‌شده در بافت ارائه نمی‌دهد، اما راهنمایی‌های پیش‌فرض معقولی برای مدل ارائه می‌دهیم.

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