با 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:
- در Antigravity، روی منو در قاب «نماینده» > سرورهای MCP کلیک کنید.
- 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 است:
افزودن بازار Firebase برای افزایههای Claude:
claude plugin marketplace add firebase/firebase-toolsافزایه Claude را برای Firebase نصب کنید:
claude plugin install firebase@firebaseنصب را درستیسنجی کنید:
claude plugin marketplace list
گزینه ۲: پیکربندی دستی سرور MCP
یا میتوانید سرور MCP Firebase را بهصورت دستی پیکربندی کنید:
فرمان زیر را در پوشه برنامهتان اجرا کنید:
claude mcp add firebase npx -- -y firebase-tools@latest mcpنصب را درستیسنجی کنید:
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.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 دردسترس است.
دسترسی به فرمان و استفاده از آن
اگر قبلاً این کار را نکردهاید، سرور Firebase MCP را راهاندازی کنید، و سپس ابزار هوش مصنوعی خود را راهاندازی کنید.
فرمان MCP
crashlytics:connectرا اجرا کنید.اکثر ابزارهای هوش مصنوعی راهی برای دسترسی راحت به این گردش کار ارائه میدهند. اگر نماینده شما از فرمانهای MCP پشتیبانی نمیکند، توصیه میکنیم از اشکالزدایی مکالمهای آزاد استفاده کنید.
از ابزار هوش مصنوعیتان برای کمک به اولویتبندی و رفع 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 روش صریحی برای کنترل میزان دادهای که در بافت بار میشود ارائه نمیدهد، اما ما راهنمایی پیشفرض معقولی برای مدل ارائه میدهیم.