Za pomocą narzędzi i promptów MCP w Firebase Crashlytics możesz wchodzić w interakcję z danymi Crashlytics przy użyciu narzędzi programistycznych opartych na AI i obsługujących MCP, takich jak Gemini CLI, Claude Code czy Cursor. Te Crashlytics narzędzia i prompty MCP zapewniają narzędziu AI kluczowy kontekst, który pomaga zarządzać problemami, ustalać ich priorytety, debugować je i rozwiązywać.
Po skonfigurowaniu serwera Firebase MCP, możesz korzystać z funkcji MCP w Crashlytics:
Proces z przewodnikiem, który pomaga ustalać priorytety problemów i je rozwiązywać
Debugowanie konwersacyjne w dowolnym formacie
CrashlyticsCrashlyticsCo to jest MCP? Model Context Protocol (MCP) to standardowy sposób, w jaki narzędzia AI mogą uzyskiwać dostęp do narzędzi zewnętrznych i źródeł danych.
Zanim zaczniesz: skonfiguruj serwer Firebase MCP
W tej sekcji opisujemy podstawową konfigurację serwera Firebase MCP, dzięki której możesz używać poleceń, promptów i narzędzi MCP specyficznych dla Crashlytics (które są opisane w dalszej części tej strony).
Wymagania wstępne
Upewnij się, że Twoje środowisko spełnia te wymagania:
Działająca instalacja Node.js i npm. Instalacja Node.js automatycznie instaluje narzędzia wiersza poleceń npm.
Narzędzie programistyczne oparte na AI obsługuje integracje MCP.
Jeśli pracujesz nad projektem Unity, zapoznaj się z najczęstszymi pytaniami dotyczącymi wczytywania Crashlytics narzędzi i promptów MCP.
Skonfiguruj narzędzie AI tak, aby korzystało z serwera Firebase MCP
Antigravity
Aby skonfigurować Antigravity tak, aby korzystało z serwera Firebase MCP:
- W Antigravity kliknij menu w panelu Agent > MCP Servers (Serwery MCP).
- Kliknij Firebase > Install (Zainstaluj).
Spowoduje to automatyczne zaktualizowanie pliku mcp_config.json, który możesz wyświetlić, klikając Manage MCP Servers u góry panelu MCP Store > View raw config, o tę zawartość:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Interfejs wiersza poleceń Gemini
Zalecany sposób skonfigurowania interfejsu wiersza poleceń Gemini tak, aby korzystał z serwera Firebase MCP, to zainstalowanie rozszerzenia Firebase dla interfejsu wiersza poleceń Gemini:
gemini extensions install https://github.com/firebase/agent-skills/Zainstalowanie rozszerzenia Firebase automatycznie konfiguruje serwer Firebase MCP i zawiera plik kontekstu, który może poprawić wydajność Gemini w zakresie tworzenia aplikacji Firebase.
Możesz też skonfigurować interfejs wiersza poleceń Gemini tak, aby korzystał z serwera Firebase MCP (ale nie z pliku kontekstu rozszerzenia Firebase), edytując lub tworząc jeden z plików konfiguracji:
- W projekcie:
.gemini/settings.json - W katalogu głównym:
~/.gemini/settings.json
Jeśli plik jeszcze nie istnieje, utwórz go, klikając prawym przyciskiem myszy katalog nadrzędny i wybierając New file (Nowy plik). Dodaj do pliku te wiersze:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Gemini Code Assist
Zalecany sposób skonfigurowania Gemini Code Assist tak, aby korzystał z serwera Firebase MCP, to zainstalowanie rozszerzenia Firebase dla interfejsu wiersza poleceń Gemini:
gemini extensions install https://github.com/firebase/agent-skills/Zainstalowanie rozszerzenia Firebase automatycznie konfiguruje serwer Firebase MCP i zawiera plik kontekstu, który może poprawić wydajność Gemini w zakresie tworzenia aplikacji Firebase.
Możesz też skonfigurować Gemini Code Assist tak, aby korzystał z serwera Firebase MCP (ale nie z pliku kontekstu rozszerzenia Firebase), edytując lub tworząc jeden z plików konfiguracji:
- W projekcie:
.gemini/settings.json - W katalogu głównym:
~/.gemini/settings.json
Jeśli plik jeszcze nie istnieje, utwórz go, klikając prawym przyciskiem myszy katalog nadrzędny i wybierając New file (Nowy plik). Dodaj do pliku te wiersze:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Firebase Studio
Aby skonfigurować Firebase Studio tak, aby korzystało z serwera Firebase MCP, edytuj lub utwórz plik konfiguracji: .idx/mcp.json.
Jeśli plik jeszcze nie istnieje, utwórz go, klikając prawym przyciskiem myszy katalog nadrzędny i wybierając New file (Nowy plik). Dodaj do pliku te wiersze:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Opcja 1: Zainstaluj za pomocą wtyczki (zalecane)
Najłatwiejszym sposobem skonfigurowania serwera Firebase MCP w Claude Code jest zainstalowanie oficjalnej wtyczki Firebase:
Dodaj Firebase Marketplace dla wtyczek Claude:
claude plugin marketplace add firebase/firebase-toolsZainstaluj wtyczkę Claude dla Firebase:
claude plugin install firebase@firebaseSprawdź instalację:
claude plugin marketplace list
Opcja 2: Skonfiguruj serwer MCP ręcznie
Możesz też ręcznie skonfigurować serwer Firebase MCP:
W folderze aplikacji uruchom to polecenie:
claude mcp add firebase npx -- -y firebase-tools@latest mcpSprawdź instalację:
claude mcp listPowinien on wyglądać tak:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Aby skonfigurować Claude Desktop tak, aby korzystał z serwera Firebase MCP, edytuj plik claude_desktop_config.json. Możesz otworzyć lub utworzyć ten plik w menu Claude > Settings (Claude > Ustawienia). Kliknij kartę Developer (Deweloper), a potem Edit Config (Edytuj konfigurację).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cline
Aby skonfigurować Cline'a tak, aby korzystał z serwera Firebase MCP, edytuj plik cline_mcp_settings.json. Możesz otworzyć lub utworzyć ten plik, klikając ikonę MCP Servers (Serwery MCP) u góry panelu Cline, a potem klikając przycisk Configure MCP Servers (Skonfiguruj serwery MCP).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
Cursor
Opcja 1. Wtyczka Marketplace (zalecana)
Zainstaluj wtyczkę Firebase z Cursor Marketplace. Spowoduje to automatyczne skonfigurowanie serwera MCP i zapewni dostęp do umiejętności agenta Firebase.
Opcja 2. Konfiguracja MCP jednym kliknięciem
Jeśli chcesz tylko dodać serwer MCP do konfiguracji globalnej, kliknij ten przycisk:
Opcja 3. Konfiguracja ręczna
Jeśli wolisz skonfigurować serwer dla konkretnego projektu lub chcesz ręcznie edytować ustawienia, zaktualizuj plik mcp.json:
- W przypadku konkretnego projektu edytuj plik
.cursor/mcp.json - W przypadku wszystkich projektów (globalnie) edytuj plik
~/.cursor/mcp.json
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
VS Code Copilot
Aby skonfigurować pojedynczy projekt, edytuj plik .vscode/mcp.json w obszarze roboczym:
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Aby serwer był dostępny w każdym otwieranym projekcie, edytuj ustawienia użytkownika, np.:
"mcp": {
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Windsurfing
Aby skonfigurować edytor Windsurf, edytuj plik ~/.codeium/windsurf/mcp_config.json:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Oprócz podstawowej konfiguracji opisanej powyżej dla każdego narzędzia AI możesz określić parametry opcjonalne.
(Zalecane) Proces z przewodnikiem, który pomaga ustalać priorytety problemów i je rozwiązywać za pomocą crashlytics:connect
Crashlytics udostępnia proces z przewodnikiem, który jest konwersacyjny i elastyczny aby pomóc Ci ustalać priorytety problemów z Crashlytics w aplikacji i je rozwiązywać. Narzędzie AI może na przykład pobierać problemy, wyjaśniać je, identyfikować potencjalne rozwiązania, a nawet wprowadzać zmiany w kodzie.
Ten proces z przewodnikiem jest dostępny za pomocą polecenia MCP crashlytics:connect.
Dostęp do polecenia i jego używanie
crashlytics:connect procesem z przewodnikiem.Jeśli jeszcze tego nie zrobisz, skonfiguruj serwer Firebase MCP, a potem uruchom narzędzie AI.
Uruchom polecenie MCP
crashlytics:connect.Większość narzędzi AI umożliwia wygodny dostęp do tego procesu. Jeśli na przykład używasz interfejsu wiersza poleceń Gemini, uruchom polecenie po ukośniku
/crashlytics:connectUżyj narzędzia AI, aby ustalać priorytety problemów z Crashlytics i je rozwiązywać, np.:
- Wyświetl listę problemów posortowanych według priorytetu.
- Debuguj konkretny problem, podając jego identyfikator lub adres URL.
- Poproś o więcej informacji o awarii.
- Zapytaj agenta o powody sugerowanej przyczyny głównej.
Debugowanie konwersacyjne w dowolnym formacie
Chociaż do debugowania zalecamy
używanie crashlytics:connect w celu uzyskania najlepszych wyników debugowania,
możesz też debugować problemy za pomocą konwersacji w dowolnym formacie z narzędziem AI, które
ma dostęp do narzędzi MCP w Crashlytics. Jest to szczególnie ważne w przypadku narzędzi AI, które nie obsługują jeszcze promptów MCP (często nazywanych poleceniami ukośnikowymi lub niestandardowymi).
Po skonfigurowaniu serwera Firebase MCP wypróbuj te przykłady.
Pobieranie kontekstu problemu i awarii
Gdy narzędzie AI ma dostęp do Crashlytics narzędzi MCP, może pobierać krytyczne Crashlytics dane o problemach, takie jak liczba użytkowników i zdarzeń, ślady stosu, metadane i informacje o wersji aplikacji.
Oto kilka przykładowych promptów:
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?- Aby odpowiedzieć na to pytanie, narzędzie AI prawdopodobnie odczyta Twój kod, aby zrozumieć, gdzie następuje logowanie, i użyje różnych Crashlytics narzędzi MCP do pobrania danych o problemie. Następnie narzędzie AI spróbuje ustalić, czy w najnowszej wersji występuje problem związany z procesem logowania.
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.- Aby odpowiedzieć na to pytanie, narzędzie AI użyje różnych Crashlytics narzędzi MCP do pobrania kontekstu problemu i wszelkich notatek opublikowanych w związku z tym problemem. Może też pobrać przykładowe awarie, aby wznowić analizę problemu.
Dokumentowanie analizy debugowania
Podczas debugowania problemu często przydatne jest prowadzenie dokumentacji dla siebie lub zespołu. Crashlytics oferuje tę funkcję w konsoli Firebase, a narzędzie AI wyposażone w narzędzia MCP w Crashlytics też może Ci pomóc – np. podsumować analizę, dodać notatkę z przydatnymi metadanymi (takimi jak link do problemu w Jira lub GitHub) albo zamknąć problem po jego rozwiązaniu.
Oto kilka przykładowych promptów:
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.
Informacje o narzęd0/}ziach MCPCrashlytics
W tabelach poniżej znajdziesz listę narzędzi Crashlytics MCP, które są dostępne za pomocą serwera Firebase MCP.
Po skonfigurowaniu serwera Firebase MCP narzędzie AI może używać tych narzędzi MCP, aby pomóc Ci zrozumieć problemy, debugować je i nimi zarządzać. Te narzędzia MCP są używane zarówno w procesie z przewodnikiem crashlytics:connect, jak i w konwersacjach w dowolnym formacie z narzędziem AI.
W większości przypadków te narzędzia MCP są przeznaczone tylko do użytku przez LLM, a nie do bezpośredniego użytku przez dewelopera. LLM decyduje, kiedy użyć tych narzędzi MCP, na podstawie Twojej interakcji z narzędziem AI.
Zarządzanie problemami z Crashlytics
W tabeli poniżej znajdziesz opis narzędzi dostępnych do zarządzania problemami z Crashlytics.
| Nazwa narzędzia | Grupa cech | Opis |
|---|---|---|
| crashlytics_create_note | crashlytics | Dodaj notatkę do problemu z Crashlytics. |
| crashlytics_delete_note | crashlytics | Usuń notatkę z problemu z Crashlytics. |
| crashlytics_update_issue | crashlytics | Użyj tego narzędzia, aby zaktualizować stan problemu z Crashlytics. |
Pobieranie danych Crashlytics
W tabeli poniżej znajdziesz opis narzędzi dostępnych do uzyskiwania informacji o aplikacjach związanych z Crashlytics.
| Nazwa narzędzia | Grupa cech | Opis |
|---|---|---|
| crashlytics_get_issue | crashlytics | Pobiera dane problemu z Crashlytics, które mogą posłużyć jako punkt początkowy do debugowania. |
| crashlytics_list_events | crashlytics | Użyj tego narzędzia, aby wyświetlić listę najnowszych zdarzeń pasujących do podanych filtrów. Może służyć do pobierania przykładowych awarii i wyjątków związanych z problemem, które będą zawierać ślady stosu i inne dane przydatne do debugowania. |
| crashlytics_batch_get_events | crashlytics | Pobiera konkretne zdarzenia według nazwy zasobu. Może służyć do pobierania przykładowych awarii i wyjątków związanych z problemem, które będą zawierać ślady stosu i inne dane przydatne do debugowania. |
| crashlytics_list_notes | crashlytics | Użyj tego narzędzia, aby wyświetlić listę wszystkich notatek dotyczących problemu w Crashlytics. |
| crashlytics_get_report | crashlytics | Użyj tego narzędzia, aby poprosić o raporty liczbowe z Crashlytics. Wynik agreguje sumę zdarzeń i użytkowników, których dotyczy problem, pogrupowanych według wymiaru odpowiedniego dla danego raportu. |
Dodatkowe informacje
Jak są używane Twoje dane
Zasady zarządzania danymi są określane przez narzędzie programistyczne oparte na AI, z którego korzystasz, i podlegają warunkom określonym przez to narzędzie AI.
Ceny
Firebase nie pobiera opłat za korzystanie z narzędzi i promptów MCP w Crashlytics ani za pobieranie danych z Crashlytics z naszego publicznego interfejsu API.
Wszelkie koszty są określane przez narzędzie programistyczne oparte na AI, z którego korzystasz, i mogą zależeć od ilości danych Crashlyticsużywanych przez narzędzie AI. Pamiętaj, że Firebase nie oferuje wyraźnego sposobu kontrolowania ilości danych wczytywanych do kontekstu, ale udostępniamy rozsądne domyślne wskazówki dla modelu.