Với các công cụ và câu lệnh Firebase CrashlyticsMCP, bạn có thể tương tác với dữ liệu Crashlytics của mình 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. Những công cụ và lời nhắc Crashlytics MCP này cung cấp bối cảnh quan trọng cho công cụ AI của bạn để giúp bạn quản lý, ưu tiên, gỡ lỗi và khắc phục các vấn đề.
Sau khi thiết lập máy chủ MCP của Firebase, bạn có thể sử dụng các tính năng MCP cho Crashlytics:
Quy trình có hướng dẫn để ưu tiên và khắc phục vấn đề
MCP là gì? Giao thức ngữ cảnh mô hình (MCP) là một phương pháp 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ủ MCP Firebase
Phần này mô tả chế độ thiết lập cơ bản của máy chủ Firebase MCP để bạn có thể sử dụng các lệnh, lời nhắc 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:
Bạn phải 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ụ dòng lệnh npm.
Công cụ phát triển dựa trên AI của bạn hỗ trợ các tính năng 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ông cụ và lời nhắc MCP.
Định cấu hình công cụ AI để sử dụng máy chủ MCP của Firebase
Gemini CLI
Cách được đề xuất để thiết lập Gemini CLI nhằm sử dụng máy chủ MCP của Firebase 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ủ MCP của Firebase, đồng thời đi kèm với một tệp bối 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ủ MCP của Firebase (nhưng không phải tệp bối 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 sau:
- Trong dự án của bạn:
.gemini/settings.json - Trong thư mục gốc:
~/.gemini/settings.json
Nếu tệp này 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 thiết lập Gemini Code Assist để sử dụng máy chủ MCP của Firebase mà bạn nên dùng 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ủ MCP của Firebase, đồng thời đi kèm với một tệp bối 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 bối 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 sau:
- Trong dự án của bạn:
.gemini/settings.json - Trong thư mục gốc:
~/.gemini/settings.json
Nếu tệp này 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 này 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
Mã Claude
Để thiết lập Claude Code sử dụng máy chủ Firebase MCP, hãy chạy lệnh sau trong thư mục ứng dụng của bạn:
claude mcp add firebase npx -- -y firebase-tools@latest mcpBạn có thể xác minh quá trình cài đặt bằng cách chạy:
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 > Cài đặt. Chọn thẻ Nhà phát triển, rồi nhấp vào 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 Máy chủ MCP ở đầu ngăn Cline, sau đó nhấp vào nút Định cấu hình máy chủ MCP.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
Con trỏ
Để định cấu hình Cursor sử dụng máy chủ MCP của Firebase, hãy chỉnh sửa tệp .cursor/mcp.json (chỉ định cấu hình một dự án cụ thể) hoặc tệp ~/.cursor/mcp.json (để cung cấp máy chủ MCP trong tất cả các dự án):
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Copilot trong VS Code
Để đị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 của bạn:
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Để cung cấp máy chủ trong mọi dự án 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"]
}
}
}
Lướt ván buồm
Để định cấu hình Windsurf Editor, 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 mỗi 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 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 công 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 đề 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 giải pháp tiềm năng và thậm chí thực hiện các thay đổi về mã cho bạn.
Quy trình có hướng dẫn này có sẵn thông qua lệnh crashlytics:connect MCP.
Truy cập và sử dụng lệnh
crashlytics:connect.Nếu bạn chưa thực hiện, hãy thiết lập máy chủ MCP của Firebase, rồi khởi động công cụ AI.
Chạy lệnh
crashlytics:connectMCP.Hầu hết các công cụ AI đều cung cấp một cách thuận tiện để truy cập 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 đề về Crashlytics, chẳng hạn như:
- 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ề lý do của nguyên nhân gốc được đề xuất.
Gỡ lỗi trong cuộc 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ụ Crashlytics MCP. Điều này đặc biệt quan trọng đối với những công cụ AI chưa hỗ trợ câu lệnh MCP (thường được gọi là lệnh gạch chéo hoặc lệnh tuỳ chỉnh).
Sau khi bạn thiết lập máy chủ MCP của Firebase, hãy thử một số ví dụ sau.
Tìm nạp một vấn đề và bối cảnh sự cố
Khi có quyền truy cập vào các công cụ Crashlytics MCP, công cụ AI của bạn có thể tìm nạp dữ liệu quan trọng về vấn đề 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ụ Crashlytics MCP để 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 của bạn sẽ sử dụng nhiều công cụ CrashlyticsMCP để truy xuất bối cảnh của vấn đề và mọi ghi chú được đăng cho vấn đề đó. Thao tá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, việc lưu giữ hồ sơ cho bản thân hoặc nhóm của bạn thường rất hữu ích. Crashlytics cung cấp khả 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ụ Crashlytics MCP cũng có thể trợ giúp, chẳng hạn như: tóm tắt quá trình điều tra, thêm ghi chú có siêu dữ liệu hữu ích (chẳng hạn như đường liên kết đến vấn đề trên Jira hoặc GitHub) hoặc đóng 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.
Crashlytics Tài liệu tham khảo về công cụ MCP
Các bảng sau đây liệt kê các công cụ Crashlytics MCP có sẵn thông qua máy chủ Firebase MCP.
Sau khi bạn thiết lập máy chủ MCP của Firebase, công cụ AI có thể dùng các công cụ MCP này để giúp bạn hiểu, gỡ lỗi và quản lý các vấn đề. Các công cụ MCP này được dùng trong cả quy trình 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, những công cụ MCP này chỉ dành cho việc sử dụng LLM chứ không dành cho việc sử dụng trực tiếp của nhà phát triển là con người. LLM sẽ quyết định thời điểm sử dụng các công cụ MCP này dựa trên lượt tương tác của bạn với công cụ AI.
Quản lý vấn đề về Crashlytics
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 đề trong Crashlytics. |
| crashlytics_delete_note | crashlytics | Xoá ghi chú khỏi một vấn đề trên Crashlytics. |
| crashlytics_update_issue | crashlytics | Sử dụng phương thức này để cập nhật trạng thái của vấn đề trên 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 Crashlytics về ứ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 đề Crashlytics. Dữ liệu này có thể được dùng làm điểm bắt đầu để gỡ lỗi. |
| crashlytics_list_events | crashlytics | Sử dụng tham số này để liệt kê các sự kiện gần đây nhất khớp với 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 đề, 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 | Nhận 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 đề, 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 phương thức này để liệt kê tất cả ghi chú cho một vấn đề trong Crashlytics. |
| crashlytics_get_top_issues | crashlytics | Sử dụng thông tin này để tính số lượng sự kiện và số lượng người dùng riêng biệt chịu ảnh hưởng, được nhóm theo vấn đề. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. |
| crashlytics_get_top_variants | crashlytics | Đếm số sự kiện và số người dùng riêng biệt chịu ảnh hưởng, được nhóm theo biến thể của vấn đề. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. |
| crashlytics_get_top_versions | crashlytics | Đếm số sự kiện và số người dùng riêng biệt chịu ảnh hưởng, được nhóm theo phiên bản. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. |
| crashlytics_get_top_apple_devices | crashlytics | Đếm số sự kiện và số người dùng riêng biệt chịu ảnh hưởng, được nhóm theo thiết bị của Apple. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. Chỉ liên quan đến các ứng dụng iOS, iPadOS và macOS. |
| crashlytics_get_top_android_devices | crashlytics | Đếm số sự kiện và số người dùng riêng biệt chịu ảnh hưởng, được nhóm theo thiết bị Android. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. Chỉ áp dụng cho các ứng dụng Android. |
| crashlytics_get_top_operating_systems | crashlytics | Đếm số sự kiện và số người dùng riêng biệt chịu ảnh hưởng, được nhóm theo hệ điều hành. Các nhóm được sắp xếp theo số sự kiện, theo thứ tự giảm dần. Chỉ tính những sự kiện khớp với bộ lọc đã cho. |
Thông tin khác
Cách dữ liệu của bạn được sử dụng
Hoạt động quản trị dữ liệu được xác định bằng công cụ phát triển dựa trên AI mà bạn sử dụng và phải tuân theo các điều khoản do công cụ AI đó xác định.
Giá
Firebase không tính phí khi bạn sử dụng các công cụ và lời nhắc Crashlytics MCP hoặc khi bạn 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 thức 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.