透過 Firebase Crashlytics MCP 工具和提示,您可以使用支援 MCP 的 AI 輔助開發人員工具 (例如 Antigravity、Claude Code 或 Cursor) 與 Crashlytics 資料互動。這些 Crashlytics MCP 工具和提示詞可為 AI 工具提供重要背景資訊,協助您管理、排定優先順序、偵錯及修正問題。
設定 Firebase MCP 伺服器後,即可在 Crashlytics 使用 MCP 功能:
什麼是 MCP? Model Context Protocol (MCP) 是 AI 工具存取外部工具和資料來源的標準化方式。
事前準備:設定 Firebase MCP 伺服器
本節說明 Firebase MCP 伺服器的基本設定,以便您使用 Crashlytics 專屬的 MCP 指令、提示和工具 (本頁稍後會說明)。
必要條件
請確認環境符合下列需求:
已安裝 Node.js 和 npm。安裝 Node.js 時,系統會自動安裝 npm 指令工具。
您的 AI 輔助開發人員工具支援 MCP 整合。
如果您使用的是 Unity 專案,請參閱載入 Crashlytics MCP 工具和提示的常見問題。
設定 AI 工具,使用 Firebase MCP 伺服器
Antigravity
如要設定 Antigravity 使用 Firebase MCP 伺服器,請按照下列步驟操作:
- 在 Antigravity 中,依序點選「代理程式」窗格中的 選單 >「MCP 伺服器」。
- 依序選取「Firebase」 >「安裝」。
這會自動更新 mcp_config.json 檔案,您可以依序點選 MCP Store 窗格頂端的「Manage MCP Servers」 >「View raw config」,查看下列內容:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
方法 1:透過外掛程式安裝 (建議)
如要在 Claude Code 中設定 Firebase MCP 伺服器,最簡單的方法是安裝官方 Firebase 外掛程式:
新增 Claude 外掛程式的 Firebase 市集:
claude plugin marketplace add firebase/firebase-tools安裝 Claude 的 Firebase 外掛程式:
claude plugin install firebase@firebase驗證安裝項目:
claude plugin marketplace list
選項 2:手動設定 MCP 伺服器
或者,您也可以手動設定 Firebase MCP 伺服器:
在應用程式資料夾下執行下列指令:
claude mcp add firebase npx -- -y firebase-tools@latest mcp驗證安裝項目:
claude mcp list應該顯示:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude 電腦版
如要設定 Claude Desktop 使用 Firebase MCP 伺服器,請編輯 claude_desktop_config.json 檔案。您可以從「Claude」>「Settings」選單開啟或建立這個檔案。選取「Developer」(開發人員) 分頁標籤,然後按一下「Edit Config」(編輯設定)。
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cursor
方法 1:Marketplace 外掛程式(建議)
從 Cursor Marketplace 安裝 Firebase 外掛程式。這會自動設定 MCP 伺服器,並提供 Firebase 代理技能的存取權。
方法 2:一鍵設定 MCP
如果只想將 MCP 伺服器新增至全域設定,請點選下列按鈕:
選項 3:手動設定
如果您想為特定專案設定伺服器,或想手動編輯設定,請更新 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 檔案。如要開啟或建立這個檔案,請按一下 Cline 窗格頂端的 MCP 伺服器圖示,然後點選「Configure MCP Servers」按鈕。
{
"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
如要設定 Windsurf Editor,請編輯 ~/.codeium/windsurf/mcp_config.json 檔案:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
除了上述各項 AI 工具的基本設定外,您也可以指定選用參數。
(建議) 逐步操作流程,可排定 crashlytics:connect 問題的優先順序並加以修正
Crashlytics 提供對話式且靈活的引導式工作流程,協助您排定應用程式中 Crashlytics 問題的優先順序並加以修正。舉例來說,AI 工具可以擷取問題、說明問題、找出可能的修正方式,甚至為您變更程式碼。
您可以透過 crashlytics:connect MCP 指令使用這個引導式工作流程。
存取及使用指令
如果尚未設定 Firebase MCP 伺服器,請先完成設定,然後啟動 AI 工具。
執行
crashlytics:connectMCP 指令。大多數 AI 工具都提供便利的方式,讓您存取這項工作流程。如果代理不支援 MCP 指令,建議使用任意形式的對話式偵錯。
使用 AI 工具排定 Crashlytics 問題的優先順序並加以修正,例如:
- 查看優先處理的問題清單。
- 提供 ID 或網址,對特定問題進行偵錯。
- 要求提供當機事件的詳細資訊。
- 詢問代理,瞭解建議根本原因的推論過程。
自由對話式偵錯
雖然我們建議使用 crashlytics:connect 取得最佳偵錯體驗,但您也可以與可存取 Crashlytics MCP 工具的 AI 工具進行自由形式的對話,藉此偵錯問題。對於尚未支援 MCP 提示詞 (通常稱為斜線指令或自訂指令) 的 AI 工具,這點尤其重要。
設定 Firebase MCP 伺服器後,請嘗試下列範例。
擷取問題和當機背景資訊
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 工具可能會讀取程式碼,瞭解登入作業發生的位置,並使用各種 Crashlytics MCP 工具擷取問題資料。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 控制台中提供這項功能,而配備 Crashlytics MCP 工具的 AI 工具也能提供協助,例如:總結調查結果、新增附有實用中繼資料的附註 (例如 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 工具參考資料
下表列出可透過 Firebase MCP 伺服器使用的 Crashlytics MCP 工具。
設定 Firebase MCP 伺服器後,AI 工具就能使用這些 MCP 工具,協助您瞭解、偵錯及管理問題。這些 MCP 工具會用於 crashlytics:connect 引導式工作流程,以及與 AI 工具的自由形式對話。
在大多數情況下,這些 MCP 工具僅供 LLM 使用,不適合由人類開發人員直接使用。LLM 會根據您與 AI 工具的互動,決定何時使用這些 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 要求數字報表。結果會匯總事件總數和受影響的使用者,並依適合該報表的維度分組。 |
其他資訊
資料的使用方式
資料治理方式取決於您使用的 AI 輔助開發工具,並受該 AI 工具定義的條款規範。
定價
Firebase 不會向您收取使用 Crashlytics MCP 工具和提示,或從公開 API 擷取 Crashlytics 資料的費用。
費用取決於您使用的 AI 輔助開發人員工具,以及 AI 工具使用的 Crashlytics 資料量。請注意,Firebase 並未提供明確的方法來控制載入脈絡的資料量,但我們確實為模型提供了合理的預設指引。