Với các câu lệnh và công cụ MCP Firebase Crashlytics, bạn có thể tương tác với dữ liệu Crashlytics bằng các công cụ phát triển dựa trên AI có hỗ trợ MCP, chẳng hạn như Gemini CLI, Claude Code hoặc Cursor. Các công cụ và câu lệnh MCP Crashlytics này cung cấp ngữ cảnh quan trọng cho công cụ AI để giúp bạn quản lý, ưu tiên, gỡ lỗi và khắc phục vấn đề.
Sau khi thiết lập máy chủ Firebase MCP, bạn có thể sử dụng các tính năng MCP cho Crashlytics:
Quy trình làm việc có hướng dẫn để ưu tiên và khắc phục vấn đề
Gỡ lỗi bằng cách trò chuyện tự do
MCP là gì? Giao thức ngữ cảnh mô hình (MCP) là một cách tiêu chuẩn hoá để các công cụ AI truy cập vào các công cụ và nguồn dữ liệu bên ngoài.
Trước khi bắt đầu: Thiết lập máy chủ Firebase MCP
Phần này mô tả cách thiết lập cơ bản máy chủ Firebase MCP để bạn có thể sử dụng các lệnh, câu lệnh và công cụ MCP dành riêng cho Crashlytics (tất cả đều được mô tả sau trên trang này).
Điều kiện tiên quyết
Đảm bảo môi trường của bạn đáp ứng các yêu cầu sau:
Đã cài đặt Node.js và npm. Việc cài đặt Node.js sẽ tự động cài đặt các công cụ lệnh npm.
Công cụ phát triển dựa trên AI của bạn hỗ trợ tích hợp MCP.
Nếu bạn đang làm việc với một dự án Unity, hãy xem câu hỏi thường gặp về việc tải Crashlytics các công cụ và câu lệnh MCP.
Định cấu hình công cụ AI để sử dụng máy chủ Firebase MCP
Antigravity
Cách định cấu hình Antigravity để sử dụng máy chủ Firebase MCP:
- Trong Antigravity, hãy nhấp vào trình đơn trong ngăn Agent (Tác nhân) > MCP Servers (Máy chủ MCP).
- Chọn Firebase > Install (Cài đặt).
Thao tác này sẽ tự động cập nhật tệp mcp_config.json. Bạn có thể xem tệp này bằng cách
nhấp vào Manage MCP Servers (Quản lý máy chủ MCP) ở đầu ngăn MCP Store (Cửa hàng MCP) >
View raw config (Xem cấu hình thô) với nội dung sau:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Gemini CLI
Cách được đề xuất để thiết lập Gemini CLI sử dụng máy chủ Firebase MCP là cài đặt tiện ích Firebase cho Gemini CLI:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/Việc cài đặt Tiện ích Firebase sẽ tự động định cấu hình máy chủ Firebase MCP và đi kèm với một tệp ngữ cảnh có thể cải thiện hiệu suất phát triển ứng dụng Firebase của Gemini.
Ngoài ra, bạn có thể định cấu hình Gemini CLI để sử dụng máy chủ Firebase MCP (nhưng không phải tệp ngữ cảnh tiện ích Firebase) bằng cách chỉnh sửa hoặc tạo một trong các tệp cấu hình:
- Trong dự án của bạn:
.gemini/settings.json - Trong thư mục gốc của bạn:
~/.gemini/settings.json
Nếu tệp chưa tồn tại, hãy tạo tệp bằng cách nhấp chuột phải vào thư mục mẹ rồi chọn New file (Tệp mới). Thêm nội dung sau vào tệp:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Gemini Code Assist
Cách được đề xuất để thiết lập Gemini Code Assist sử dụng máy chủ Firebase MCP là cài đặt tiện ích Firebase cho Gemini CLI:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/Việc cài đặt Tiện ích Firebase sẽ tự động định cấu hình máy chủ Firebase MCP và đi kèm với một tệp ngữ cảnh có thể cải thiện hiệu suất phát triển ứng dụng Firebase của Gemini.
Ngoài ra, bạn có thể định cấu hình Gemini Code Assist để sử dụng máy chủ Firebase MCP (nhưng không phải tệp ngữ cảnh tiện ích Firebase) bằng cách chỉnh sửa hoặc tạo một trong các tệp cấu hình:
- Trong dự án của bạn:
.gemini/settings.json - Trong thư mục gốc của bạn:
~/.gemini/settings.json
Nếu tệp chưa tồn tại, hãy tạo tệp bằng cách nhấp chuột phải vào thư mục mẹ rồi chọn New file (Tệp mới). Thêm nội dung sau vào tệp:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Firebase Studio
Để định cấu hình Firebase Studio sử dụng máy chủ Firebase MCP, hãy chỉnh sửa hoặc tạo tệp cấu hình: .idx/mcp.json.
Nếu tệp chưa tồn tại, hãy tạo tệp bằng cách nhấp chuột phải vào thư mục mẹ rồi chọn New file (Tệp mới). Thêm nội dung sau vào tệp:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Cách 1: Cài đặt thông qua trình bổ trợ (Nên dùng)
Cách dễ nhất để thiết lập máy chủ Firebase MCP trong Claude Code là cài đặt trình bổ trợ Firebase chính thức:
Thêm Firebase Marketplace cho các trình bổ trợ Claude:
claude plugin marketplace add firebase/firebase-toolsCài đặt trình bổ trợ Claude cho Firebase:
claude plugin install firebase@firebaseXác minh quá trình cài đặt:
claude plugin marketplace list
Cách 2: Định cấu hình máy chủ MCP theo cách thủ công
Ngoài ra, bạn có thể định cấu hình máy chủ Firebase MCP theo cách thủ công:
Chạy lệnh sau trong thư mục ứng dụng:
claude mcp add firebase npx -- -y firebase-tools@latest mcpXác minh quá trình cài đặt:
claude mcp listChương trình sẽ hiển thị:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Để định cấu hình Claude Desktop sử dụng máy chủ Firebase MCP, hãy chỉnh sửa tệp claude_desktop_config.json. Bạn có thể mở hoặc tạo tệp này trong trình đơn Claude > Settings (Claude > Cài đặt). Chọn thẻ Developer (Nhà phát triển), sau đó nhấp vào Edit Config (Chỉnh sửa cấu hình).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cline
Để định cấu hình Cline sử dụng máy chủ Firebase MCP, hãy chỉnh sửa tệp cline_mcp_settings.json. Bạn có thể mở hoặc tạo tệp này bằng cách nhấp vào biểu tượng MCP Servers (Máy chủ MCP) ở đầu ngăn Cline, sau đó nhấp vào nút Configure MCP Servers (Định cấu hình máy chủ MCP).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
Cursor
Cách 1: Trình bổ trợ Marketplace (nên dùng)
Cài đặt trình bổ trợ Firebase từ Cursor Marketplace. Thao tác này sẽ tự động định cấu hình máy chủ MCP và cung cấp quyền truy cập vào các kỹ năng của tác nhân Firebase.
Cách 2: Thiết lập MCP bằng một lần nhấp
Nếu chỉ muốn thêm máy chủ MCP vào cấu hình chung, hãy nhấp vào nút sau:
Cách 3: Định cấu hình thủ công
Nếu bạn muốn định cấu hình máy chủ cho một dự án cụ thể hoặc muốn chỉnh sửa chế độ cài đặt theo cách thủ công, hãy cập nhật tệp mcp.json:
- Đối với một dự án cụ thể, hãy chỉnh sửa
.cursor/mcp.json - Đối với tất cả các dự án (chung), hãy chỉnh sửa
~/.cursor/mcp.json
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
VS Code Copilot
Để định cấu hình một dự án, hãy chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc:
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Để cung cấp máy chủ trong mọi dự án mà bạn mở, hãy chỉnh sửa chế độ cài đặt người dùng, ví dụ:
"mcp": {
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Windsurf
Để định cấu hình Trình chỉnh sửa Windsurf, hãy chỉnh sửa tệp ~/.codeium/windsurf/mcp_config.json:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Ngoài cấu hình cơ bản được mô tả ở trên cho từng công cụ AI, bạn có thể chỉ định các tham số không bắt buộc.
(Nên dùng) Quy trình làm việc có hướng dẫn để ưu tiên và khắc phục vấn đề với crashlytics:connect
Crashlytics cung cấp một quy trình làm việc có hướng dẫn, mang tính trò chuyện và linh hoạt để giúp bạn ưu tiên và khắc phục các vấn đề về Crashlytics trong ứng dụng. Ví dụ: công cụ AI có thể tìm nạp vấn đề, giải thích vấn đề, xác định các bản sửa lỗi tiềm năng và thậm chí thực hiện các thay đổi về mã cho bạn.
Quy trình làm việc có hướng dẫn này có sẵn thông qua lệnh MCP crashlytics:connect.
Truy cập và sử dụng lệnh
crashlytics:connect quy trình làm việc có hướng dẫn.Nếu bạn chưa thiết lập máy chủ Firebase MCP, hãy thiết lập rồi bắt đầu công cụ AI.
Chạy lệnh MCP
crashlytics:connect.Hầu hết các công cụ AI đều cung cấp một cách để truy cập thuận tiện vào quy trình làm việc này. Ví dụ: nếu bạn đang sử dụng Gemini CLI, hãy chạy lệnh dấu gạch chéo
/crashlytics:connectSử dụng công cụ AI để giúp ưu tiên và khắc phục các vấn đề Crashlytics, ví dụ:
- Xem danh sách các vấn đề được ưu tiên.
- Gỡ lỗi một vấn đề cụ thể bằng cách cung cấp mã nhận dạng hoặc URL của vấn đề đó.
- Yêu cầu thêm thông tin về một sự cố.
- Hỏi tác nhân về suy luận của tác nhân đối với nguyên nhân gốc được đề xuất.
Gỡ lỗi bằng cách trò chuyện tự do
Mặc dù bạn nên
sử dụng crashlytics:connect để có trải nghiệm gỡ lỗi tốt nhất,
nhưng bạn cũng có thể gỡ lỗi bằng cách trò chuyện tự do với một công cụ AI có
quyền truy cập vào các công cụ MCP Crashlytics. Điều này đặc biệt quan trọng đối với các công cụ AI chưa hỗ trợ câu lệnh MCP (thường được gọi là lệnh dấu gạch chéo hoặc lệnh tuỳ chỉnh).
Sau khi bạn đã thiết lập máy chủ Firebase MCP, hãy thử một số ví dụ sau.
Tìm nạp vấn đề và ngữ cảnh sự cố
Khi có quyền truy cập vào các công cụ MCP của Crashlytics, công cụ AI có thể tìm nạp dữ liệu quan trọng về vấn đề của Crashlytics, chẳng hạn như số lượng người dùng và sự kiện, dấu vết ngăn xếp, siêu dữ liệu, và thông tin về phiên bản ứng dụng.
Sau đây là một số câu lệnh ví dụ:
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?- Để trả lời câu hỏi này, công cụ AI của bạn có thể sẽ đọc mã của bạn để hiểu vị trí đăng nhập và sử dụng nhiều công cụ MCP Crashlytics để truy xuất dữ liệu về vấn đề. Sau đó, công cụ AI sẽ cố gắng xác định xem có vấn đề nào trong phiên bản mới nhất liên quan đến quy trình đăng nhập hay không.
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.- Để trả lời câu hỏi này, công cụ AI sẽ sử dụng nhiều Crashlytics công cụ MCP để truy xuất ngữ cảnh vấn đề và mọi ghi chú được đăng cho vấn đề đó. Công cụ này cũng có thể tìm nạp các sự cố mẫu để tiếp tục điều tra vấn đề.
Ghi lại quá trình điều tra gỡ lỗi
Khi gỡ lỗi một vấn đề, bạn nên duy trì hồ sơ cho bản thân hoặc nhóm của mình. Crashlytics cung cấp tính năng này trong bảng điều khiển Firebase, và công cụ AI được trang bị các công cụ MCP của Crashlytics cũng có thể giúp bạn — ví dụ: tóm tắt một cuộc điều tra, thêm ghi chú có siêu dữ liệu hữu ích (như đường liên kết đến vấn đề Jira hoặc GitHub) hoặc đóng một vấn đề sau khi vấn đề đó được khắc phục.
Sau đây là một số câu lệnh ví dụ:
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.
Tài liệu tham khảo về công cụ MCP Crashlytics
Các bảng sau đây liệt kê các công cụ MCP Crashlytics có sẵn thông qua máy chủ Firebase MCP.
Sau khi thiết lập máy chủ Firebase MCP, công cụ
AI có thể sử dụng các công cụ MCP này để giúp bạn hiểu, gỡ lỗi và quản lý
vấn đề. Các công cụ MCP này được sử dụng trong cả quy trình làm việc có hướng dẫn crashlytics:connect và trong các cuộc trò chuyện tự do với công cụ AI.
Đối với phần lớn các trường hợp sử dụng, các công cụ MCP này chỉ dành cho việc sử dụng LLM và không dành cho việc sử dụng trực tiếp bởi nhà phát triển là người. LLM quyết định thời điểm sử dụng các công cụ MCP này dựa trên tương tác của bạn với công cụ AI.
Quản lý Crashlytics vấn đề
Bảng sau đây mô tả các công cụ có sẵn để quản lý vấn đề về Crashlytics.
| Tên công cụ | Nhóm tính năng | Mô tả |
|---|---|---|
| crashlytics_create_note | crashlytics | Thêm ghi chú vào một vấn đề từ crashlytics. |
| crashlytics_delete_note | crashlytics | Xoá ghi chú khỏi một vấn đề về Crashlytics. |
| crashlytics_update_issue | crashlytics | Sử dụng công cụ này để cập nhật trạng thái của vấn đề về Crashlytics. |
Tìm nạp dữ liệu Crashlytics
Bảng sau đây mô tả các công cụ có sẵn để lấy thông tin liên quan đến Crashlyticsvề ứng dụng của bạn.
| Tên công cụ | Nhóm tính năng | Mô tả |
|---|---|---|
| crashlytics_get_issue | crashlytics | Lấy dữ liệu cho một vấn đề về Crashlytics. Dữ liệu này có thể được dùng làm điểm xuất phát để gỡ lỗi. |
| crashlytics_list_events | crashlytics | Sử dụng công cụ này để liệt kê các sự kiện gần đây nhất khớp với các bộ lọc đã cho. Có thể dùng để tìm nạp các sự cố và ngoại lệ mẫu cho một vấn đề, sẽ bao gồm dấu vết ngăn xếp và các dữ liệu khác hữu ích cho việc gỡ lỗi. |
| crashlytics_batch_get_events | crashlytics | Lấy các sự kiện cụ thể theo tên tài nguyên. Có thể dùng để tìm nạp các sự cố và ngoại lệ mẫu cho một vấn đề, sẽ bao gồm dấu vết ngăn xếp và các dữ liệu khác hữu ích cho việc gỡ lỗi. |
| crashlytics_list_notes | crashlytics | Sử dụng công cụ này để liệt kê tất cả ghi chú cho một vấn đề trong Crashlytics. |
| crashlytics_get_report | crashlytics | Sử dụng công cụ này để yêu cầu báo cáo bằng số từ Crashlytics. Kết quả tổng hợp tổng số sự kiện và người dùng bị ảnh hưởng, được nhóm theo một phương diện phù hợp với báo cáo đó. |
Thông tin khác
Cách dữ liệu của bạn được sử dụng
Quy trình quản trị dữ liệu được xác định bởi công cụ phát triển dựa trên AI mà bạn sử dụng và tuân theo các điều khoản do công cụ AI đó xác định.
Giá
Firebase không tính phí bạn sử dụng các câu lệnh và công cụ MCP Crashlytics hoặc tìm nạp dữ liệu Crashlytics từ API công khai của chúng tôi.
Mọi chi phí đều do công cụ phát triển dựa trên AI mà bạn sử dụng xác định và có thể được xác định theo khối lượng dữ liệu Crashlytics mà công cụ AI sử dụng. Xin lưu ý rằng Firebase không cung cấp cách rõ ràng để kiểm soát lượng dữ liệu được tải vào ngữ cảnh, nhưng chúng tôi có đưa ra hướng dẫn mặc định hợp lý cho mô hình.