Assistance IA pour Crashlytics via MCP


Avec les outils et les invites MCP Firebase Crashlytics, vous pouvez interagir avec vos données Crashlytics à l'aide de vos outils de développement basés sur l'IA compatibles avec MCP, tels que Gemini CLI, Claude Code ou Cursor. Ces outils et invites MCP Crashlytics fournissent un contexte essentiel à votre outil d'IA pour vous aider à gérer, hiérarchiser, déboguer, et résoudre les problèmes.

Une fois le serveur MCP Firebase configuré, vous pouvez utiliser les fonctionnalités MCP pour Crashlytics :

Workflow guidé pour hiérarchiser et résoudre les problèmes

Débogage conversationnel au format libre


Qu'est-ce que MCP ? Le Model Context Protocol (MCP) est une méthode standardisée permettant aux outils d'IA d'accéder à des outils et des sources de données externes.



Avant de commencer : configurer le serveur MCP Firebase

Cette section décrit la configuration de base du serveur MCP Firebase afin que vous puissiez utiliser les Crashlytics-spécifiques commandes, invites et outils MCP (tous décrits plus loin sur cette page).

Prérequis

Assurez-vous que votre environnement répond aux exigences suivantes :

  • Une installation fonctionnelle de Node.js et npm. L'installation de Node.js installe automatiquement les outils de commande npm.

  • Votre outil de développement basé sur l'IA est compatible avec les intégrations MCP.

Si vous travaillez sur un projet Unity, consultez les questions fréquentes sur le chargement des Crashlytics outils et des invites MCP.

Configurer votre outil d'IA pour qu'il utilise le serveur MCP Firebase

Antigravity

Pour configurer Antigravity afin qu'il utilise le serveur MCP Firebase :

  1. Dans Antigravity, cliquez sur le menu dans le volet "Agent" > MCP Servers (Serveurs MCP).
  2. Sélectionnez Firebase > Install (Installer).

Votre fichier mcp_config.json est alors automatiquement mis à jour. Vous pouvez l'afficher en cliquant sur Manage MCP Servers (Gérer les serveurs MCP) en haut du volet "MCP Store" > View raw config (Afficher la configuration brute), avec le contenu suivant :

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

Gemini CLI

La méthode recommandée pour configurer Gemini CLI afin qu'il utilise le serveur MCP Firebase consiste à installer l' extension Firebase pour Gemini CLI :

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

L'installation de l'extension Firebase configure automatiquement le serveur MCP Firebase et inclut également un fichier de contexte qui peut améliorer les performances de développement d'applications Firebase de Gemini.

Vous pouvez également configurer Gemini CLI pour qu'il utilise le serveur MCP Firebase (mais pas le fichier de contexte de l'extension Firebase) en modifiant ou en créant l'un des fichiers de configuration suivants :

  • Dans votre projet : .gemini/settings.json
  • Dans votre répertoire d'accueil : ~/.gemini/settings.json

Si le fichier n'existe pas encore, créez-le en effectuant un clic droit sur le répertoire parent, puis en sélectionnant New file (Nouveau fichier). Ajoutez le contenu suivant au fichier :

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

Gemini Code Assist

La méthode recommandée pour configurer Gemini Code Assist afin qu'il utilise le serveur MCP Firebase consiste à installer l' extension Firebase pour Gemini CLI :

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

L'installation de l'extension Firebase configure automatiquement le serveur MCP Firebase et inclut également un fichier de contexte qui peut améliorer les performances de développement d'applications Firebase de Gemini.

Vous pouvez également configurer Gemini Code Assist pour qu'il utilise le serveur MCP Firebase (mais pas le fichier de contexte de l'extension Firebase) en modifiant ou en créant l'un des fichiers de configuration suivants :

  • Dans votre projet : .gemini/settings.json
  • Dans votre répertoire d'accueil : ~/.gemini/settings.json

Si le fichier n'existe pas encore, créez-le en effectuant un clic droit sur le répertoire parent, puis en sélectionnant New file (Nouveau fichier). Ajoutez le contenu suivant au fichier :

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

Firebase Studio

Pour configurer Firebase Studio afin qu'il utilise le serveur MCP Firebase, modifiez ou créez le fichier de configuration : .idx/mcp.json.

Si le fichier n'existe pas encore, créez-le en effectuant un clic droit sur le répertoire parent, puis en sélectionnant New file (Nouveau fichier). Ajoutez le contenu suivant au fichier :

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

Claude

Claude Code

  • Option 1 : Installer via un plug-in (recommandé)

    Le moyen le plus simple de configurer le serveur MCP Firebase dans Claude Code consiste à installer le plug-in Firebase officiel :

    1. Ajoutez le marketplace Firebase pour les plug-ins Claude :

      claude plugin marketplace add firebase/firebase-tools
    2. Installez le plug-in Claude pour Firebase :

      claude plugin install firebase@firebase
    3. Vérifiez l'installation :

      claude plugin marketplace list
  • Option 2 : Configurer manuellement le serveur MCP

    Vous pouvez également configurer manuellement le serveur MCP Firebase :

    1. Exécutez la commande suivante dans le dossier de votre application :

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Vérifiez l'installation :

      claude mcp list

      Voici ce qui devrait s'afficher :

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

Claude Desktop

Pour configurer Claude Desktop afin qu'il utilise le serveur MCP Firebase, modifiez le fichier claude_desktop_config.json. Vous pouvez ouvrir ou créer ce fichier à partir du menu Claude > Settings (Claude > Paramètres). Sélectionnez l'onglet Developer (Développeur), puis cliquez sur Edit Config (Modifier la configuration).

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

Cline

Pour configurer Cline afin qu'il utilise le serveur MCP Firebase, modifiez le fichier cline_mcp_settings.json. Vous pouvez ouvrir ou créer ce fichier en cliquant sur l'icône "MCP Servers" (Serveurs MCP) en haut du volet Cline, puis sur le bouton Configure MCP Servers (Configurer les serveurs MCP).

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

Cursor

Option 1 : Plug-in Marketplace (recommandé)

Installez le plug-in Firebase à partir du marketplace Cursor. Le serveur MCP est alors automatiquement configuré et vous avez accès aux compétences de l'agent Firebase.

Option 2 : Configuration MCP en un clic

Si vous ne souhaitez ajouter le serveur MCP qu'à votre configuration globale, cliquez sur le bouton suivant :

Installer le serveur MCP

Option 3 : Configuration manuelle

Si vous préférez configurer le serveur pour un projet spécifique ou modifier vos paramètres manuellement, mettez à jour votre fichier mcp.json :

  • Pour un projet spécifique, modifiez .cursor/mcp.json
  • Pour tous les projets (au niveau mondial), modifiez ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

VS Code Copilot

Pour configurer un seul projet, modifiez le fichier .vscode/mcp.json dans votre espace de travail :

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

Pour rendre le serveur disponible dans chaque projet que vous ouvrez, modifiez vos paramètres utilisateur, par exemple :

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

Windsurf

Pour configurer Windsurf Editor, modifiez le fichier ~/.codeium/windsurf/mcp_config.json :

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

Outre la configuration de base décrite ci-dessus pour chaque outil d'IA, vous pouvez spécifier des paramètres facultatifs.



(Recommandé) Workflow guidé pour hiérarchiser et résoudre les problèmes avec crashlytics:connect

Crashlytics fournit un workflow guidé conversationnel et flexible pour vous aider à hiérarchiser et à résoudre les problèmes Crashlytics dans votre application. Par exemple, votre outil d'IA peut récupérer des problèmes, les expliquer, identifier des correctifs potentiels et même apporter les modifications de code à votre place.

Ce workflow guidé est disponible via la commande MCP crashlytics:connect.

Accéder à la commande et l'utiliser

Gemini CLI utilisant la commande crashlytics:connect
Utilisez un outil d'IA, tel que Gemini CLI, avec le crashlytics:connect workflow guidé.
  1. Si ce n'est pas déjà fait, configurez le serveur MCP Firebase, puis démarrez votre outil d'IA.

  2. Exécutez la commande MCP crashlytics:connect.

    La plupart des outils d'IA offrent un moyen pratique d'accéder à ce workflow. Par exemple, si vous utilisez Gemini CLI, exécutez la commande barre oblique /crashlytics:connect

  3. Utilisez votre outil d'IA pour hiérarchiser et résoudre les problèmes Crashlytics, par exemple :

    • Affichez une liste des problèmes hiérarchisés.
    • Déboguez un problème spécifique en fournissant son ID ou son URL.
    • Demandez plus d'informations sur un plantage.
    • Demandez à l'agent son raisonnement pour une cause racine suggérée.



Débogage conversationnel au format libre

Bien que nous vous recommandions d'utiliser crashlytics:connect pour une expérience de débogage optimale, vous pouvez également déboguer les problèmes à l'aide d'une conversation au format libre avec un outil d'IA ayant accès aux outils MCP Crashlytics. Cela est particulièrement important pour les outils d'IA qui ne sont pas encore compatibles avec les invites MCP (souvent appelées commandes barre oblique ou commandes personnalisées).

Une fois le serveur MCP Firebase configuré, essayez les exemples suivants.

Récupérer un problème et le contexte du plantage

Lorsque votre outil d'IA a accès aux outils MCP Crashlytics, il peut récupérer des données critiques sur les problèmes Crashlytics, telles que le nombre d'utilisateurs et d'événements, les traces de pile, les métadonnées et les informations sur la version de l'application.

Voici quelques exemples de requêtes :

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

    • Pour répondre à cette question, votre outil d'IA lira probablement votre code pour comprendre où la connexion a lieu et utilisera divers Crashlytics outils MCP pour récupérer les données du problème. Votre outil d'IA tentera ensuite de déterminer si un problème existe dans la dernière version et s'il est lié au flux de connexion.
  • 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.

    • Pour répondre à cette question, votre outil d'IA utilisera divers Crashlytics outils MCP pour récupérer le contexte du problème et toutes les notes publiées sur le problème. Il peut également récupérer des exemples de plantages pour reprendre l'enquête sur le problème.

Documenter une enquête de débogage

Lors du débogage d'un problème, il est souvent utile de conserver des enregistrements pour vous ou votre équipe. Crashlytics offre cette fonctionnalité dans la console Firebase, et votre outil d'IA équipé des outils MCP Crashlytics peut également vous aider. Par exemple, il peut résumer une enquête, ajouter une note avec des métadonnées utiles (comme un lien vers un problème Jira ou GitHub) ou fermer un problème une fois qu'il est résolu.

Voici quelques exemples de requêtes :

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



Référence des outils MCP Crashlytics

Les tableaux suivants répertorient les outils MCP Crashlytics disponibles via le serveur MCP Firebase.

Une fois le serveur MCP Firebase configuré, votre outil d'IA peut utiliser ces outils MCP pour vous aider à comprendre, déboguer et gérer les problèmes. Ces outils MCP sont utilisés à la fois dans le workflow guidé crashlytics:connect et dans les conversations au format libre avec votre outil d'IA.

Dans la majorité des cas d'utilisation, ces outils MCP sont destinés à être utilisés uniquement par le LLM et non par un développeur humain directement. Le LLM décide quand utiliser ces outils MCP en fonction de votre interaction avec votre outil d'IA.

Gérer les problèmes Crashlytics

Le tableau suivant décrit les outils disponibles pour gérer vos Crashlytics problèmes.

Nom de l'outil Groupe de caractéristiques Description
crashlytics_create_note crashlytics Ajoutez une note à un problème à partir de Crashlytics.
crashlytics_delete_note crashlytics Supprimez une note d'un problème Crashlytics.
crashlytics_update_issue crashlytics Utilisez cette option pour mettre à jour l'état du problème Crashlytics.

Récupérer des données Crashlytics

Le tableau suivant décrit les outils disponibles pour obtenir des informations liées à Crashlytics-sur vos applications.

Nom de l'outil Groupe de caractéristiques Description
crashlytics_get_issue crashlytics Obtient les données d'un problème Crashlytics, qui peuvent servir de point de départ pour le débogage.
crashlytics_list_events crashlytics Utilisez cette option pour afficher la liste des événements les plus récents correspondant aux filtres donnés.
Peut être utilisé pour récupérer des exemples de plantages et d'exceptions pour un problème,
y compris les traces de pile et d'autres données utiles pour le débogage.
crashlytics_batch_get_events crashlytics Obtient des événements spécifiques par nom de ressource.
Peut être utilisé pour récupérer des exemples de plantages et d'exceptions pour un problème,
y compris les traces de pile et d'autres données utiles pour le débogage.
crashlytics_list_notes crashlytics Utilisez cette option pour afficher la liste de toutes les notes d'un problème dans Crashlytics.
crashlytics_get_report crashlytics Utilisez cette option pour demander des rapports numériques à Crashlytics. Le résultat agrège la somme des événements et des utilisateurs concernés, regroupés par une dimension appropriée pour ce rapport.



Informations supplémentaires

Utilisation de vos données

La gouvernance des données est déterminée par l'outil de développement basé sur l'IA que vous utilisez et est soumise aux conditions définies par cet outil d'IA.

Tarifs

Firebase ne vous facture pas l'utilisation des outils et des invites MCP Crashlytics ni la récupération des données Crashlytics à partir de notre API publique.

Tous les coûts sont déterminés par l'outil de développement basé sur l'IA que vous utilisez et peuvent être déterminés par le volume de Crashlytics données utilisé par l' outil d'IA. Notez que Firebase n'offre pas de moyen explicite de contrôler la quantité de données chargées dans le contexte, mais nous incluons des conseils par défaut raisonnables pour le modèle.

Dépannage et FAQ