Assistenza AI per Crashlytics tramite MCP


Con gli strumenti e i prompt MCP di Firebase Crashlytics, puoi interagire con i tuoi dati Crashlytics utilizzando i tuoi strumenti per sviluppatori basati sull'AI compatibili con MCP, come Antigravity, Claude Code o Cursor. Questi strumenti e prompt MCP di Crashlytics 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 priorità e risolvere i problemi

Debug conversazionale in formato libero


Che cos'è l'MCP? Il Model Context Protocol (MCP) è un modo standardizzato per consentire agli 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 Firebase in modo da poter utilizzare comandi, prompt e strumenti MCP specifici di Crashlytics (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.

  • Il tuo strumento per sviluppatori 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 di 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"]
    }
  }
}

Claude

Claude Code

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

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

    1. Aggiungi il marketplace di 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 questo comando nella cartella dell'app:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp

    2. Verifica l'installazione:

      claude mcp list

      Dovrebbe mostrare:

      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 > Settings. Seleziona la scheda Sviluppatore, quindi fai clic su Modifica configurazione.

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

Cursore

Opzione 1: plug-in Marketplace (consigliato)

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

Opzione 2: configurazione di MCP con un solo clic

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

Installa il server MCP

Opzione 3: configurazione manuale

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

  • Per un progetto specifico, modifica .cursor/mcp.json
  • Per tutti i progetti (globali), modifica ~/.cursor/mcp.json
"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 sul pulsante Configura server MCP.

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

VS Code Copilot

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

"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 priorità e risolvere i problemi con crashlytics:connect

Crashlytics fornisce un flusso di lavoro guidato, conversazionale e flessibile per aiutarti a dare 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

  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 per accedere comodamente a questo flusso di lavoro. Se l'agente non supporta i comandi MCP, ti consigliamo di utilizzare il debug conversazionale in formato libero.

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

    • Visualizzare un elenco di problemi con priorità.
    • Eseguire il debug di un problema specifico fornendo il relativo ID o URL.
    • Richiedi maggiori informazioni su un arresto anomalo.
    • Chiedi all'agente il ragionamento alla base di 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 di Crashlytics. Questo è 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 Firebase, prova alcuni dei seguenti esempi.

Recupera il contesto di un problema e di un arresto anomalo

Quando lo strumento AI ha accesso agli strumenti MCP di Crashlytics, può recuperare dati critici sui problemi di Crashlytics, come il numero 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 tuo codice per capire dove avviene l'accesso e utilizzerà vari strumenti MCP di Crashlytics per recuperare i dati del problema. Lo strumento AI tenterà quindi di determinare se nell'ultima versione esiste un problema 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 strumenti MCP Crashlytics per recuperare il contesto del problema e le eventuali note pubblicate. Potrebbe anche recuperare esempi di arresti anomali 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, ma anche il tuo strumento AI dotato di strumenti MCP di Crashlytics può aiutarti, ad esempio riassumendo un'indagine, aggiungendo una nota con metadati utili (come un link a un problema di Jira o GitHub) o chiudendo 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 dello strumento MCP Crashlytics

Le seguenti tabelle elencano gli strumenti MCP di Crashlytics disponibili tramite il server MCP di Firebase.

Dopo aver configurato il server MCP di Firebase, il tuo 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 workflow guidato di crashlytics:connect sia nelle conversazioni in formato libero con lo strumento AI.

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

Gestisci Crashlytics problemi

La tabella seguente descrive gli strumenti disponibili per gestire i problemi relativi a 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 Utilizzalo per aggiornare lo stato del problema di Crashlytics.

Recupera i dati di 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 di un problema di Crashlytics, che possono essere utilizzati come punto di partenza per il debug.
crashlytics_list_events crashlytics Utilizza questa opzione 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 includeranno analisi dello stack 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 includeranno analisi dello stack e altri dati utili per il debug.
crashlytics_list_notes crashlytics Utilizzala per elencare tutte le note relative a un problema in Crashlytics.
crashlytics_get_report crashlytics Utilizza questa opzione 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 per sviluppatori 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 di Crashlytics o per il recupero dei dati di Crashlytics dalla nostra API pubblica.

I costi sono determinati dallo strumento per sviluppatori basato sull'AI che utilizzi e potrebbero essere determinati dal volume di dati di Crashlytics utilizzato dallo strumento AI. Tieni presente che Firebase non offre un modo esplicito per controllare la quantità di dati caricati nel contesto, ma include linee guida predefinite ragionevoli per il modello.

Risoluzione dei problemi e domande frequenti