Với các lời nhắc 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 được hỗ trợ bởi AI có khả năng MCP, chẳng hạn như Gemini CLI, Claude Code hoặc Cursor. Các lời nhắc và công cụ 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 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 rằng môi trường của bạn đáp ứng những yêu cầu sau:
Một bản cài đặt Node.js và npm đang hoạt động. Khi bạn cài đặt Node.js, các công cụ lệnh npm sẽ tự động được cài đặt.
Công cụ phát triển được hỗ trợ bởi 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ác công cụ và lời nhắc 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 Tác nhân > Máy chủ MCP.
- Chọn Firebase > 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 Quản lý máy chủ MCP ở đầu ngăn Cửa hàng MCP >
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 nên dùng để 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/firebase/agent-skills/Khi bạn cài đặt tiện ích Firebase, máy chủ Firebase MCP sẽ tự động được định cấu hình 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 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 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 nên dùng để 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/firebase/agent-skills/Khi bạn cài đặt tiện ích Firebase, máy chủ Firebase MCP sẽ tự động được định cấu hình 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 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 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 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 > Cài đặt. Chọn thẻ Nhà phát triển, sau đó 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
}
}
}
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à 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 bạn 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 theo cách 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 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 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, linh hoạt và có thể trò chuyện để giúp bạn ưu tiên và khắc phục các vấn đề về Crashlytics trong ứng dụng của mình. 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 và thậm chí thực hiện các thay đổi về mã cho bạn.
Bạn có thể sử dụng quy trình làm việc có hướng dẫn này 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 khởi động 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 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ợ lời nhắc 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ông cụ AI có quyền truy cập vào các công cụ MCP Crashlytics, công cụ này 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 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ó 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 lưu giữ 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 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 đề 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 chứ không phải để nhà phát triển sử dụng trực tiếp. LLM sẽ 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ý các vấn đề về Crashlytics
Bảng sau đây mô tả các công cụ có sẵn để quản lý các 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 đề 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. Bạn có thể sử dụng dữ liệu này 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 đề, trong đó sẽ có 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 đề, trong đó sẽ có 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ả cá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 các 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
Việc quản trị dữ liệu được xác định bởi công cụ phát triển được hỗ trợ bởi 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 khi sử dụng các lời nhắc và công cụ MCP Crashlytics hoặc khi 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 được hỗ trợ bởi 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.