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:
- در Antigravity ، روی منوی در پنل Agent > MCP Servers کلیک کنید.
- فایربیس > نصب را انتخاب کنید.
این به طور خودکار فایل 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 است:
افزونههای بازار Firebase برای Claude را اضافه کنید:
claude plugin marketplace add firebase/firebase-toolsافزونه Claude را برای Firebase نصب کنید:
claude plugin install firebase@firebaseنصب را تأیید کنید:
claude plugin marketplace list
گزینه ۲ : پیکربندی دستی سرور MCP
از طرف دیگر، میتوانید سرور Firebase MCP را به صورت دستی پیکربندی کنید:
دستور زیر را در پوشه برنامه خود اجرا کنید:
claude mcp add firebase npx -- -y firebase-tools@latest mcpنصب را تأیید کنید:
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.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 در دسترس است.
دسترسی و استفاده از دستور
اگر هنوز این کار را نکردهاید، سرور Firebase MCP را راهاندازی کنید و سپس ابزار هوش مصنوعی خود را اجرا کنید.
دستور
crashlytics:connectMCP را اجرا کنید.اکثر ابزارهای هوش مصنوعی راهی برای دسترسی راحت به این گردش کار ارائه میدهند. اگر نماینده شما از دستورات MCP پشتیبانی نمیکند، توصیه میکنیم از اشکالزدایی مکالمهای به صورت آزاد استفاده کنید.
از ابزار هوش مصنوعی خود برای کمک به اولویتبندی و رفع مشکلات 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.
عیبیابی و سوالات متداول
The Firebase MCP server attempts to recognize when a codebase is using Crashlytics by inspecting installed dependencies. This capability isn't yet supported for Unity projects and doesn't cover some non-standard dependency management systems for other platforms.
If Crashlytics MCP tools and prompts aren't loading for you, then as a workaround, you can install the Firebase MCP server manually and use the --only crashlytics argument to load Crashlytics MCP tools and prompts.