Pomoc AI w Crashlytics za pomocą MCP


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

CrashlyticsCrashlytics


Co 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:

  1. W Antigravity kliknij menu w panelu Agent > MCP Servers (Serwery MCP).
  2. 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:

    1. Dodaj Firebase Marketplace dla wtyczek Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Zainstaluj wtyczkę Claude dla Firebase:

      claude plugin install firebase@firebase
    3. Sprawdź instalację:

      claude plugin marketplace list
  • Opcja 2: Skonfiguruj serwer MCP ręcznie

    Możesz też ręcznie skonfigurować serwer Firebase MCP:

    1. W folderze aplikacji uruchom to polecenie:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Sprawdź instalację:

      claude mcp list

      Powinien 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:

Instalowanie serwera MCP

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

Interfejs wiersza poleceń Gemini za pomocą polecenia crashlytics:connect
Użyj narzędzia AI, takiego jak interfejs wiersza poleceń Gemini, z crashlytics:connect procesem z przewodnikiem.
  1. Jeśli jeszcze tego nie zrobisz, skonfiguruj serwer Firebase MCP, a potem uruchom narzędzie AI.

  2. 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:connect

  3. Uż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.

Rozwiązywanie problemów i najczęstsze pytania