Assistenza AI per Crashlytics tramite MCP


Con gli strumenti e i prompt MCP Firebase Crashlytics, puoi interagire con i tuoi dati Crashlyticsutilizzando gli strumenti di sviluppo basati sull'AI con funzionalità MCP, come Gemini CLI, Claude Code o Cursor. Questi Crashlytics strumenti e prompt MCP forniscono un contesto fondamentale allo strumento AI per aiutarti a gestire, assegnare la priorità, eseguire il debug, e risolvere i problemi.

Dopo aver configurato il server MCP di Firebase, puoi utilizzare le funzionalità MCP per Crashlytics:

Flusso di lavoro guidato per assegnare la priorità e risolvere i problemi

Debug conversazionale in formato libero


Che cos'è MCP? Model Context Protocol (MCP) è un modo standardizzato per gli strumenti AI di accedere a strumenti esterni e origini dati.



Prima di iniziare: configura il server MCP di Firebase

Questa sezione descrive la configurazione di base del server MCP di Firebase in modo che tu possa utilizzare Crashlytics-specifici comandi, prompt e strumenti MCP (che sono tutti descritti più avanti in questa pagina).

Prerequisiti

Assicurati che il tuo ambiente soddisfi questi requisiti:

  • Un'installazione funzionante di Node.js e npm. L'installazione di Node.js installa automaticamente gli strumenti di comando npm.

  • Lo strumento di sviluppo basato sull'AI supporta le integrazioni MCP.

Se stai lavorando con un progetto Unity, consulta le domande frequenti sul caricamento degli strumenti e dei prompt MCP.Crashlytics

Configura lo strumento AI per utilizzare il server MCP di Firebase

Antigravity

Per configurare Antigravity in modo che utilizzi il server MCP di Firebase:

  1. In Antigravity, fai clic sul menu nel riquadro Agente > Server MCP.
  2. Seleziona Firebase > Installa.

In questo modo, il file mcp_config.json viene aggiornato automaticamente con i seguenti contenuti. Puoi visualizzarlo facendo clic su Gestisci server MCP nella parte superiore del riquadro MCP Store > Visualizza configurazione non elaborata:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Gemini CLI

Il modo consigliato per configurare Gemini CLI in modo che utilizzi il server MCP di Firebase è installare l' estensione Firebase per Gemini CLI:

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

L'installazione dell'estensione Firebase configura automaticamente il server MCP di Firebase e include anche un file di contesto che può migliorare le prestazioni di sviluppo delle app Firebase di Gemini.

In alternativa, puoi configurare Gemini CLI in modo che utilizzi il server MCP di Firebase (ma non il file di contesto dell'estensione Firebase) modificando o creando uno dei file di configurazione:

  • Nel progetto: .gemini/settings.json
  • Nella home directory: ~/.gemini/settings.json

Se il file non esiste ancora, crealo facendo clic con il tasto destro del mouse sulla directory principale e selezionando Nuovo file. Aggiungi i contenuti seguenti al file:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Gemini Code Assist

Il modo consigliato per configurare Gemini Code Assist in modo che utilizzi il server MCP di Firebase è installare l' estensione Firebase per Gemini CLI:

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

L'installazione dell'estensione Firebase configura automaticamente il server MCP di Firebase e include anche un file di contesto che può migliorare le prestazioni di sviluppo delle app Firebase di Gemini.

In alternativa, puoi configurare Gemini Code Assist in modo che utilizzi il server MCP di Firebase (ma non il file di contesto dell'estensione Firebase) modificando o creando uno dei file di configurazione:

  • Nel progetto: .gemini/settings.json
  • Nella home directory: ~/.gemini/settings.json

Se il file non esiste ancora, crealo facendo clic con il tasto destro del mouse sulla directory principale e selezionando Nuovo file. Aggiungi i contenuti seguenti al file:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Firebase Studio

Per configurare Firebase Studio in modo che utilizzi il server MCP di Firebase, modifica o crea il file di configurazione: .idx/mcp.json.

Se il file non esiste ancora, crealo facendo clic con il tasto destro del mouse sulla directory principale e selezionando Nuovo file. Aggiungi i contenuti seguenti al file:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Claude

Claude Code

  • Opzione 1: installa tramite il plug-in (consigliata)

    Il modo più semplice per configurare il server MCP di Firebase in Claude Code è installare il plug-in Firebase ufficiale:

    1. Aggiungi il marketplace Firebase per i plug-in Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Installa il plug-in Claude per Firebase:

      claude plugin install firebase@firebase
    3. Verifica l'installazione:

      claude plugin marketplace list
  • Opzione 2: configura manualmente il server MCP

    In alternativa, puoi configurare manualmente il server MCP di Firebase:

    1. Esegui il seguente comando nella cartella dell'app:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Verifica l'installazione:

      claude mcp list

      Dovrebbe essere visualizzato:

      firebase: npx -y firebase-tools@latest mcp - ✓ Connected
      

Claude Desktop

Per configurare Claude Desktop in modo che utilizzi il server MCP di Firebase, modifica il file claude_desktop_config.json. Puoi aprire o creare questo file dal menu Claude > Impostazioni. Seleziona la scheda Sviluppatore, quindi fai clic su Modifica configurazione.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Cline

Per configurare Cline in modo che utilizzi il server MCP di Firebase, modifica il file cline_mcp_settings.json. Puoi aprire o creare questo file facendo clic sull'icona Server MCP nella parte superiore del riquadro Cline, quindi facendo clic sul pulsante Configura server MCP.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

Cursor

Opzione 1: plug-in Marketplace (consigliata)

Installa il plug-in Firebase da Cursor Marketplace. In questo modo, il server MCP viene configurato automaticamente e viene fornito l'accesso alle competenze dell'agente Firebase.

Opzione 2: configurazione MCP con un clic

Se vuoi aggiungere il server MCP solo alla configurazione globale, fai clic sul pulsante seguente:

Installa il server MCP

Opzione 3: configurazione manuale

Se preferisci configurare il server per un progetto specifico o modificare manualmente le impostazioni, aggiorna il file mcp.json:

  • Per un progetto specifico, modifica .cursor/mcp.json
  • Per tutti i progetti (a livello globale), modifica ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

VS Code Copilot

Per configurare un singolo progetto, modifica il file .vscode/mcp.json nel tuo spazio di lavoro:

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Per rendere il server disponibile in ogni progetto che apri, modifica le impostazioni utente, ad esempio:

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Windsurf

Per configurare Windsurf Editor, modifica il file ~/.codeium/windsurf/mcp_config.json:

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Oltre alla configurazione di base descritta sopra per ogni strumento AI, puoi specificare parametri facoltativi.



(Consigliato) Flusso di lavoro guidato per assegnare la priorità e risolvere i problemi con crashlytics:connect

Crashlytics fornisce un flusso di lavoro guidato, conversazionale e flessibile per aiutarti ad assegnare la priorità e risolvere i problemi di Crashlytics nella tua app. Ad esempio, lo strumento AI può recuperare i problemi, spiegarli, identificare potenziali correzioni e persino apportare le modifiche al codice per te.

Questo flusso di lavoro guidato è disponibile tramite il comando MCP crashlytics:connect.

Accedi e utilizza il comando

Gemini CLI utilizzando il comando crashlytics:connect
Utilizza uno strumento AI, come Gemini CLI, con il crashlytics:connect flusso di lavoro guidato.
  1. Se non l'hai ancora fatto, configura il server MCP di Firebase, quindi avvia lo strumento AI.

  2. Esegui il comando MCP crashlytics:connect.

    La maggior parte degli strumenti AI offre un modo pratico per accedere a questo flusso di lavoro. Ad esempio, se utilizzi Gemini CLI, esegui il comando slash /crashlytics:connect

  3. Utilizza lo strumento AI per assegnare la priorità e risolvere i problemi Crashlytics, ad esempio:

    • Visualizza un elenco di problemi con priorità.
    • Esegui il debug di un problema specifico fornendo il relativo ID o URL.
    • Richiedi maggiori informazioni su un arresto anomalo.
    • Chiedi all'agente il ragionamento per una causa principale suggerita.



Debug conversazionale in formato libero

Sebbene consigliamo di utilizzare crashlytics:connect per un'esperienza di debug ottimale, puoi anche eseguire il debug dei problemi utilizzando una conversazione in formato libero con uno strumento AI che ha accesso agli strumenti MCP Crashlytics. Ciò è particolarmente importante per gli strumenti AI che non supportano ancora i prompt MCP (spesso chiamati comandi slash o comandi personalizzati).

Dopo aver configurato il server MCP di Firebase, prova alcuni degli esempi seguenti.

Recupera un problema e il contesto dell'arresto anomalo

Quando lo strumento AI ha accesso agli strumenti MCP Crashlytics, può recuperare dati critici sui problemi Crashlytics, come conteggi di utenti ed eventi, stacktrace, metadati, e informazioni sulla versione dell'app.

Ecco alcuni prompt di esempio:

  • 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?

    • Per rispondere a questa domanda, lo strumento AI probabilmente leggerà il codice per capire dove avviene l'accesso e utilizzerà vari Crashlytics strumenti MCP per recuperare i dati sui problemi. Lo strumento AI tenterà quindi di determinare se esiste un problema nella versione più recente relativo al flusso di accesso.
  • 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.

    • Per rispondere a questa domanda, lo strumento AI utilizzerà vari Crashlytics strumenti MCP per recuperare il contesto del problema e le eventuali note pubblicate su questo. Potrebbe anche recuperare arresti anomali di esempio per riprendere l'indagine sul problema.

Documenta un'indagine di debug

Quando esegui il debug di un problema, spesso è utile conservare i record per te o per il tuo team. Crashlytics offre questa funzionalità nella console Firebase, e anche lo strumento AI dotato di strumenti MCP di Crashlytics può aiutarti, ad esempio: riepilogare un'indagine, aggiungere una nota con metadati utili (come un link a un problema Jira o GitHub) o chiudere un problema dopo che è stato risolto.

Ecco alcuni prompt di esempio:

  • 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.



Riferimento agli strumenti MCP Crashlytics

Le tabel0/}le seguenti elencano gli strumenti MCP disponibili tramite il server MCP di Firebase.Crashlytics

Dopo aver configurato il server MCP di Firebase, lo strumento AI può utilizzare questi strumenti MCP per aiutarti a comprendere, eseguire il debug e gestire i problemi. Questi strumenti MCP vengono utilizzati sia nel flusso di lavoro guidato crashlytics:connect sia nelle conversazioni in formato libero con lo strumento AI.

Nella maggior parte dei casi d'uso, questi strumenti MCP sono destinati all'uso solo con i modelli LLM e non all'uso diretto da parte di uno sviluppatore umano. Il modello LLM decide quando utilizzare questi strumenti MCP in base alla tua interazione con lo strumento AI.

Gestisci i problemi Crashlytics

La tabella seguente descrive gli strumenti disponibili per gestire i problemi di Crashlytics.

Nome strumento Gruppo di caratteristiche Descrizione
crashlytics_create_note crashlytics Aggiungi una nota a un problema da Crashlytics.
crashlytics_delete_note crashlytics Elimina una nota da un problema di Crashlytics.
crashlytics_update_issue crashlytics Utilizza questo strumento per aggiornare lo stato del problema di Crashlytics.

Recupera i dati Crashlytics

La tabella seguente descrive gli strumenti disponibili per ottenere informazioni relative a Crashlytics-sulle tue app.

Nome strumento Gruppo di caratteristiche Descrizione
crashlytics_get_issue crashlytics Recupera i dati per un problema di Crashlytics, che possono essere utilizzati come punto di partenza per il debug.
crashlytics_list_events crashlytics Utilizza questo strumento per elencare gli eventi più recenti che corrispondono ai filtri specificati.
Può essere utilizzato per recuperare arresti anomali ed eccezioni di esempio per un problema,
che includerà stacktrace e altri dati utili per il debug.
crashlytics_batch_get_events crashlytics Recupera eventi specifici in base al nome della risorsa.
Può essere utilizzato per recuperare arresti anomali ed eccezioni di esempio per un problema,
che includerà stacktrace e altri dati utili per il debug.
crashlytics_list_notes crashlytics Utilizza questo strumento per elencare tutte le note relative a un problema in Crashlytics.
crashlytics_get_report crashlytics Utilizza questo strumento per richiedere report numerici da Crashlytics. Il risultato aggrega la somma degli eventi e degli utenti interessati, raggruppati in base a una dimensione appropriata per il report.



Informazioni aggiuntive

Come vengono usati i tuoi dati

La governance dei dati è determinata dallo strumento di sviluppo basato sull'AI che utilizzi ed è soggetta ai termini definiti da questo strumento AI.

Prezzi

Firebase non addebita costi per l'utilizzo degli strumenti e dei prompt MCP Crashlytics o per il recupero dei dati Crashlytics dalla nostra API pubblica.

Qualsiasi costo è determinato dallo strumento di sviluppo basato sull'AI che utilizzi e potrebbe essere determinato dal volume di Crashlytics dati utilizzati dallo strumento AI. Tieni presente che Firebase non offre un modo esplicito per controllare la quantità di dati caricati nel contesto, ma include indicazioni predefinite ragionevoli per il modello.

Risoluzione dei problemi e domande frequenti