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


With Firebase Crashlytics MCP tools and prompts, you can interact with your Crashlytics data using your MCP-capable AI-powered development tools, like Antigravity , Claude Code, or Cursor. These Crashlytics MCP tools and prompts provide critical context to your AI tool to help you manage, prioritize, debug, and fix issues.

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

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

اشکال‌زدایی مکالمه‌ای به صورت آزاد


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



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

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

پیش‌نیازها

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

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

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

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

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

ضد جاذبه

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

  1. در Antigravity ، روی منوی در پنل Agent > MCP Servers کلیک کنید.
  2. فایربیس > نصب را انتخاب کنید.

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

{
  "mcpServers": {
    "firebase-mcp-server": {
      "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"]
    }
  }
}

کلود

کلود کد

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

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

دسکتاپ کلود

To configure Claude Desktop to use the Firebase MCP server, edit the claude_desktop_config.json file. You can open or create this file from the Claude > Settings menu. Select the Developer tab, then click Edit Config .

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

کلاین

To configure Cline to use the Firebase MCP server, edit the cline_mcp_settings.json file. You can open or create this file by clicking the MCP Servers icon at the top of the Cline pane, then clicking the Configure MCP Servers button.

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

مکان نما

گزینه ۱: افزونه 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"]
  }
}

کمک خلبان کد 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 provides a guided workflow that's conversational and flexible to help you prioritize and fix Crashlytics issues in your app. For example, your AI tool can fetch issues, explain issues, identify potential fixes, and even make the code changes for you.

این گردش کار هدایت‌شده از طریق دستور crashlytics:connect MCP در دسترس است.

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

  1. اگر هنوز این کار را نکرده‌اید، سرور Firebase MCP را راه‌اندازی کنید و سپس ابزار هوش مصنوعی خود را اجرا کنید.

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

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

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

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



اشکال‌زدایی مکالمه‌ای به صورت آزاد

While we recommend using crashlytics:connect for the best debugging experience , you can also debug issues using a free-form conversation with an AI tool that has access to the Crashlytics MCP tools. This is especially important for AI tools that don't yet support MCP prompts (often referred to as slash commands or custom commands).

پس از راه‌اندازی سرور 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?

    • To answer this question, your AI tool will likely read your code to understand where login happens and use various Crashlytics MCP tools to retrieve issue data. Your AI tool will then try to determine whether an issue exists in the latest version that relates to the login flow.
  • 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.

    • To answer this question, your AI tool will use various Crashlytics MCP tools to retrieve issue context and any notes posted to the issue. It might also fetch example crashes to resume the investigation into the issue.

مستندسازی یک تحقیق اشکال‌زدایی

When debugging an issue, it's often helpful to maintain records for yourself or your team. Crashlytics offers this capability in the Firebase console, and your AI tool equipped with Crashlytics MCP tools can also help — for example: summarize an investigation, add a note with helpful metadata (like a link to a Jira or GitHub issue), or close an issue after it's fixed.

در اینجا چند نمونه از دستورالعمل‌ها آورده شده است:

  • 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 در دسترس هستند، فهرست می‌کنند.

After you've set up the Firebase MCP server , your AI tool can use these MCP tools to help you understand, debug, and manage issues. These MCP tools are used in both the crashlytics:connect guided workflow and in free-form conversations with your AI tool.

For the majority of use cases, these MCP tools are for LLM-use only and not for direct use by a human developer. The LLM decides when to use these MCP tools based on your interaction with your AI tool.

مدیریت مشکلات 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_report کراش‌لیتیک از این برای درخواست گزارش‌های عددی از Crashlytics استفاده کنید. نتیجه، مجموع رویدادها و کاربران تحت تأثیر را که بر اساس بُعد مناسب برای آن گزارش گروه‌بندی شده‌اند، جمع‌آوری می‌کند.



اطلاعات تکمیلی

نحوه استفاده از داده‌های شما

مدیریت داده‌ها توسط ابزار توسعه مبتنی بر هوش مصنوعی که شما استفاده می‌کنید تعیین می‌شود و تابع شرایط تعریف‌شده توسط آن ابزار هوش مصنوعی است.

قیمت‌گذاری

فایربیس برای استفاده از ابزارها و اعلان‌های Crashlytics MCP یا دریافت داده‌های Crashlytics از API عمومی ما، هیچ هزینه‌ای از شما دریافت نمی‌کند.

Any cost is determined by the AI-powered development tool that you use, and could be determined by the volume of Crashlytics data that's used by the AI tool. Note that Firebase doesn't offer an explicit way to control how much data is loaded into context, but we do include sensible default guidance for the model.

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