עזרה מ-AI ל-Crashlytics דרך MCP


באמצעות Firebase Crashlytics כלי MCP והנחיות, אתם יכולים ליצור אינטראקציה עם נתוני Crashlytics באמצעות כלי פיתוח מבוססי-AI עם יכולות MCP, כמו Gemini CLI,‏ Claude Code או Cursor. כלי ה-MCP וההנחיות האלה מספקים הקשר חשוב לכלי ה-AI, כדי לעזור לכם לנהל, לתעדף, לנפות באגים ולתקן בעיות.Crashlytics

אחרי ההגדרה של שרת ה-MCP ב-Firebase, אפשר להשתמש בתכונות ה-MCP לCrashlytics:

תהליך עבודה מודרך לתעדוף בעיות ולפתרון שלהן

ניפוי באגים בשיחה חופשית


מה זה MCP? Model Context Protocol‏ (MCP) הוא דרך סטנדרטית לכלים מבוססי-AI לגשת לכלים ולמקורות נתונים חיצוניים.


לפני שמתחילים: הגדרת שרת Firebase MCP

בקטע הזה מוסבר איך להגדיר את שרת ה-MCP של Firebase כדי שתוכלו להשתמש בפקודות, בהנחיות ובכלים של MCP שספציפיים ל-Crashlytics (הסבר על כל אלה מופיע בהמשך הדף).

דרישות מוקדמות

חשוב לוודא שהסביבה שלכם עומדת בדרישות הבאות:

  • התקנה תקינה של Node.js ו-npm. התקנת Node.js מתקינה באופן אוטומטי את כלי הפקודה של npm.

  • כלי הפיתוח מבוסס ה-AI שלכם תומך בשילובים של MCP.

אם אתם עובדים עם פרויקט Unity, כדאי לעיין בשאלות הנפוצות בנושא טעינה של כלים והנחיות של Crashlytics MCP.

הגדרת כלי ה-AI לשימוש בשרת ה-MCP של Firebase

Antigravity

כדי להגדיר את Antigravity לשימוש בשרת ה-MCP של Firebase:

  1. ב-Antigravity, לוחצים על התפריט בחלונית של הסוכן > MCP Servers.
  2. בוחרים באפשרות Firebase > התקנה.

הפעולה הזו מעדכנת אוטומטית את קובץ mcp_config.json, שאפשר לראות אותו כך: לוחצים על Manage MCP Servers (ניהול שרתי MCP) בחלק העליון של חלונית MCP Store > View raw config (הצגת ההגדרות הגולמיות), עם התוכן הבא:

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

Gemini CLI

הדרך המומלצת להגדיר את Gemini CLI לשימוש בשרת Firebase MCP היא להתקין את התוסף Firebase ל-Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills/

התקנת התוסף של Firebase מגדירה באופן אוטומטי את שרת ה-MCP של Firebase, וכוללת גם קובץ הקשר שיכול לשפר את ביצועי פיתוח האפליקציות של Firebase ב-Gemini.

לחלופין, אפשר להגדיר את Gemini CLI כך שישתמש בשרת Firebase MCP (אבל לא בקובץ ההקשר של תוסף Firebase). לשם כך, צריך לערוך או ליצור אחד מקובצי ההגדרות:

  • בפרויקט: .gemini/settings.json
  • בספריית הבית: ~/.gemini/settings.json

אם הקובץ עדיין לא קיים, יוצרים אותו על ידי לחיצה ימנית על ספריית האב ובחירה באפשרות New file (קובץ חדש). מוסיפים את התוכן הבא לקובץ:

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

Gemini Code Assist

הדרך המומלצת להגדרת Gemini Code Assist לשימוש בשרת Firebase MCP היא להתקין את התוסף של Firebase ל-Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills/

התקנת התוסף של Firebase מגדירה באופן אוטומטי את שרת ה-MCP של Firebase, וכוללת גם קובץ הקשר שיכול לשפר את ביצועי פיתוח האפליקציות של Firebase ב-Gemini.

לחלופין, אפשר להגדיר את Gemini Code Assist כך שישתמש בשרת Firebase MCP (אבל לא בקובץ ההקשר של תוסף Firebase). לשם כך, צריך לערוך או ליצור אחד מקובצי ההגדרות:

  • בפרויקט: .gemini/settings.json
  • בספריית הבית: ~/.gemini/settings.json

אם הקובץ עדיין לא קיים, יוצרים אותו על ידי לחיצה ימנית על ספריית האב ובחירה באפשרות New file (קובץ חדש). מוסיפים את התוכן הבא לקובץ:

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

Firebase Studio

כדי להגדיר את Firebase Studio לשימוש בשרת Firebase MCP, עורכים או יוצרים את קובץ ההגדרה: .idx/mcp.json.

אם הקובץ עדיין לא קיים, יוצרים אותו על ידי לחיצה ימנית על ספריית האב ובחירה באפשרות New file (קובץ חדש). מוסיפים את התוכן הבא לקובץ:

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

Claude

Claude Code

  • אפשרות 1: התקנה באמצעות פלאגין (מומלץ)

    הדרך הכי קלה להגדיר את שרת ה-Firebase MCP ב-Cloud Code היא להתקין את הפלאגין הרשמי של Firebase:

    1. מוסיפים את Firebase marketplace לתוספים של Claude:

      claude plugin marketplace add firebase/firebase-tools

    2. מתקינים את הפלאגין Claude ל-Firebase:

      claude plugin install firebase@firebase

    3. מאמתים את ההתקנה:

      claude plugin marketplace list

  • אפשרות 2: הגדרה ידנית של שרת ה-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 > Settings. לוחצים על הכרטיסייה Developer (מפתח) ואז על Edit Config (עריכת ההגדרה).

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

קלין

כדי להגדיר את Cline כך שישתמש בשרת ה-MCP של Firebase, צריך לערוך את הקובץ cline_mcp_settings.json. אפשר לפתוח או ליצור את הקובץ הזה בלחיצה על סמל שרתי ה-MCP בחלק העליון של החלונית Cline, ואז ללחוץ על הלחצן Configure MCP Servers (הגדרת שרתי MCP).

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

סמן

אפשרות 1: פלאגין Marketplace (מומלץ)

מתקינים את הפלאגין של Firebase מ-Cursor Marketplace. הפעולה הזו מגדירה אוטומטית את שרת ה-MCP ומספקת גישה לכישורי סוכנים ב-Firebase.

אפשרות 2: הגדרה בלחיצה אחת של MCP

אם רוצים להוסיף את שרת ה-MCP רק להגדרה הגלובלית, לוחצים על הכפתור הבא:

התקנת שרת MCP

אפשרות 3: הגדרה ידנית

אם אתם מעדיפים להגדיר את השרת לפרויקט ספציפי או לערוך את ההגדרות באופן ידני, אתם צריכים לעדכן את הקובץ mcp.json:

  • בפרויקט ספציפי, עורכים את .cursor/mcp.json
  • לכל הפרויקטים (גלובלי), עורכים את ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

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

בנוסף להגדרה הבסיסית שמתוארת למעלה לכל כלי AI, אפשר לציין פרמטרים אופציונליים.


(מומלץ) תהליך עבודה מודרך לתעדוף ולפתרון בעיות ב-crashlytics:connect

Crashlytics מספק תהליך עבודה מודרך, גמיש ואינטראקטיבי, שיעזור לכם לקבוע סדר עדיפויות ולתקן בעיות באפליקציה. לדוגמה, כלי ה-AI יכול לאחזר בעיות, להסביר אותן, לזהות תיקונים פוטנציאליים ואפילו לבצע את שינויי הקוד בשבילכם.Crashlytics

תהליך העבודה המודרך הזה זמין באמצעות הפקודה crashlytics:connect MCP.

גישה לפקודה ושימוש בה

‫Gemini CLI באמצעות הפקודה crashlytics:connect
שימוש בכלי AI, כמו Gemini CLI, עם תהליך העבודה המודרך crashlytics:connect.

  1. אם עדיין לא עשיתם זאת, מגדירים את שרת ה-MCP של Firebase, ואז מפעילים את כלי ה-AI.

  2. מריצים את הפקודה crashlytics:connect MCP.

    רוב כלי ה-AI מספקים דרך נוחה לגשת לתהליך העבודה הזה. לדוגמה, אם משתמשים ב-Gemini CLI, מריצים את פקודה דרך שורת הפקודות /crashlytics:connect.

  3. אפשר להשתמש בכלי ה-AI כדי לתעדף ולפתור בעיות Crashlytics, למשל:

    • הצגת רשימה של בעיות לפי סדר עדיפות.
    • אפשר לנפות באגים בבעיה ספציפית על ידי ציון המזהה או כתובת ה-URL שלה.
    • בקשת מידע נוסף על קריסה.
    • אפשר לשאול את הסוכן מה ההיגיון שלו לגבי שורש הבעיה שהוא מציע.


ניפוי באגים בשיחה בפריסה חופשית

מומלץ להשתמש ב-crashlytics:connect כדי ליהנות מחוויית ניפוי הבאגים הטובה ביותר, אבל אפשר גם לנפות באגים באמצעות שיחה חופשית עם כלי AI שיש לו גישה לכלים של Crashlytics MCP. זה חשוב במיוחד לכלים מבוססי-AI שעדיין לא תומכים בהנחיות MCP (שנקראות לעיתים קרובות פקודות לוכסן או פקודות מותאמות אישית).

אחרי ההגדרה של שרת ה-MCP של Firebase, אפשר לנסות כמה מהדוגמאות הבאות.

אחזור של בעיה והקשר של קריסה

אם לכלי ה-AI יש גישה ל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?

    • כדי לענות על השאלה הזו, כלי ה-AI כנראה יקרא את הקוד כדי להבין איפה מתבצעת ההתחברות, וישתמש בכלי MCP שונים של Crashlytics כדי לאחזר נתוני בעיות. לאחר מכן, כלי ה-AI ינסה לקבוע אם קיימת בעיה בגרסה האחרונה שקשורה לתהליך ההתחברות.

  • 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.

    • כדי לענות על השאלה הזו, כלי ה-AI ישתמש במגוון Crashlyticsכלים של MCP כדי לאחזר את ההקשר של הבעיה וכל הערה שפורסמה לגבי הבעיה. יכול להיות שהכלי יאחזר גם דוגמאות לקריסות כדי להמשיך את החקירה של הבעיה.

תיעוד של חקירת ניפוי באגים

כשמנסים לפתור בעיה, לעיתים קרובות כדאי לשמור רשומות לעצמכם או לצוות. Crashlytics מציע את האפשרות הזו במסוף Firebase, וגם כלי ה-AI שלכם שמצויד בכלים של 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

בטבלאות הבאות מפורטים כלי ה-MCP שזמינים דרך שרת ה-MCP של Firebase.Crashlytics

אחרי שמגדירים את שרת ה-MCP של Firebase, כלי ה-AI יכול להשתמש בכלי ה-MCP האלה כדי לעזור לכם להבין בעיות, לנפות באגים ולנהל אותן. כלי ה-MCP האלה משמשים גם בcrashlytics:connectתהליך העבודה המודרך וגם בשיחות חופשיות עם כלי ה-AI.

ברוב תרחישי השימוש, כלי ה-MCP האלה מיועדים לשימוש במודלים גדולים של שפה (LLM) בלבד, ולא לשימוש ישיר על ידי מפתח אנושי. המודל הגדול של השפה מחליט מתי להשתמש בכלי ה-MCP האלה על סמך האינטראקציה שלכם עם כלי ה-AI.

ניהול בעיות ב-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. התוצאה היא צבירה של סכום האירועים והמשתמשים שהושפעו, מקובצים לפי מאפיין שמתאים לדוח.


מידע נוסף

איך נעשה שימוש בנתונים שלכם

משילות מידע נקבעת על ידי כלי הפיתוח מבוסס-AI שבו אתם משתמשים, והיא כפופה לתנאים שמוגדרים על ידי כלי ה-AI הזה.

תמחור

‫Firebase לא מחייבת אתכם על השימוש Crashlytics בהנחיות ובכלים של MCP או על שליפת נתונים מ-API ציבורי.Crashlytics

העלות נקבעת על ידי כלי הפיתוח מבוסס ה-AI שבו אתם משתמשים, ויכולה להיקבע לפי נפח הנתונים שמשמשים את כלי ה-AI. שימו לב: ב-Firebase אין דרך מפורשת לשלוט בכמות הנתונים שנטענים להקשר, אבל אנחנו כן כוללים הנחיות ברירת מחדל הגיוניות למודל.Crashlytics

פתרון בעיות ושאלות נפוצות