Assistance IA pour Crashlytics via MCP

Expérimental : les fonctionnalités MCP pour Crashlytics sont expérimentales, ce qui signifie qu'elles ne sont soumises à aucun contrat de niveau de service ni règlement relatif aux abandons, et qu'elles peuvent faire l'objet de modifications susceptibles d'affecter la rétrocompatibilité.

Grâce aux outils et aux invites MCP Firebase Crashlytics, vous pouvez interagir avec vos données Crashlytics à l'aide de vos outils de développement optimisés par l'IA et compatibles avec MCP, comme Gemini CLI, Claude Code ou Cursor. Ces Crashlytics outils et prompts MCP 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 que vous avez configuré le serveur MCP Firebase, vous pouvez utiliser les fonctionnalités MCP pour Crashlytics :

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

Débogage conversationnel de format libre

Important Les outils et les requêtes Crashlytics MCP actuellement disponibles sont destinés à être utilisés avec des applications qui utilisent déjà Crashlytics.

Qu'est-ce que le 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 commandes, les invites et les outils MCP spécifiques à Crashlytics (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 optimisé par l'IA est compatible avec les intégrations MCP.

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

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

CLI Gemini

La méthode recommandée pour configurer la CLI Gemini afin d'utiliser le serveur MCP Firebase consiste à installer l'extension Firebase pour la CLI Gemini :

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

L'installation de l'extension Firebase configure automatiquement le serveur Firebase MCP 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 la CLI Gemini pour qu'elle utilise le serveur MCP Firebase (mais pas le fichier de contexte d'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 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 d'utiliser le serveur MCP Firebase consiste à installer l'extension Firebase pour la CLI Gemini :

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

L'installation de l'extension Firebase configure automatiquement le serveur Firebase MCP 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 d'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 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 Nouveau fichier. Ajoutez le contenu suivant au fichier :

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

Claude

Claude Code

Pour configurer Claude Code afin qu'il utilise le serveur MCP Firebase, exécutez la commande suivante dans le dossier de votre application :

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

Vous pouvez vérifier l'installation en exécutant la commande suivante :

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 > Paramètres. Sélectionnez l'onglet Développeur, puis cliquez sur 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 Serveurs MCP en haut du volet Cline, puis sur le bouton Configurer les serveurs MCP.

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

Cursor

Pour configurer Cursor afin qu'il utilise le serveur MCP Firebase, modifiez le fichier .cursor/mcp.json (pour configurer uniquement un projet spécifique) ou le fichier ~/.cursor/mcp.json (pour rendre le serveur MCP disponible dans tous les projets) :

"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 l'éditeur Windsurf, modifiez le fichier ~/.codeium/windsurf/mcp_config.json :

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

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

Remarque : Lorsque le serveur Firebase MCP effectue des appels d'outils MCP, il utilise les mêmes identifiants utilisateur qui autorisent la CLI Firebase dans l'environnement dans lequel elle s'exécute. Selon l'environnement, il peut s'agir d'un utilisateur connecté ou des identifiants par défaut de l'application.

---

(Recommandé) Workflow guidé pour hiérarchiser et résoudre les problèmes liés à 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 les problèmes, les expliquer, identifier les solutions potentielles et même apporter les modifications de code pour vous.

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

Remarque : Tous les outils d'IA ne sont pas compatibles avec les commandes MCP comme celle-ci, mais vous pouvez toujours déboguer les problèmes à l'aide d'une conversation en mode texte libre.

Accéder à la commande et l'utiliser

Utilisez un outil d'IA, comme la CLI Gemini, avec le workflow guidé crashlytics:connect.

1. Si vous ne l'avez 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 permettent d'accéder facilement à 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 classés par ordre de priorité.
   • Déboguez un problème spécifique en fournissant son ID ou son URL.
   • Demander plus d'informations sur un plantage
   • Demandez à l'agent de justifier la cause première 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 résoudre les problèmes en discutant en langage naturel 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 requêtes MCP (souvent appelées commandes à barre oblique ou commandes personnalisées).

Après avoir configuré le serveur MCP Firebase, essayez certains des exemples suivants.

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

Lorsque votre outil d'IA a accès aux outils Crashlytics MCP, il peut récupérer des données critiques sur les problèmes Crashlytics, comme le nombre d'utilisateurs et d'événements, les stacktraces, 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ù se produit la connexion et utilisera divers outils MCP Crashlytics 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 outils MCP Crashlytics pour récupérer le contexte du problème et 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

Lorsque vous déboguez un problème, il est souvent utile de conserver des enregistrements pour vous ou votre équipe. Crashlytics offre cette fonctionnalité dans la console Firebase. Votre outil d'IA équipé des outils MCP Crashlytics peut également vous aider, par exemple en résumant une investigation, en ajoutant une note avec des métadonnées utiles (comme un lien vers un problème Jira ou GitHub) ou en clôturant 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.

---

Documentation de référence sur l'outil MCP Crashlytics

Les tableaux suivants listent les outils MCP Crashlytics disponibles via le serveur Firebase MCP.

Une fois que vous avez configuré le serveur MCP Firebase, 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 en mode libre avec votre outil d'IA.

Pour la majorité des cas d'utilisation, ces outils MCP sont réservés aux LLM et ne sont pas destinés à une utilisation directe par un développeur humain. Le LLM décide quand utiliser ces outils MCP en fonction de votre interaction avec votre outil d'IA.

Remarque : Vous pouvez également afficher ces informations à l'aide de la commande suivante : npx firebase-tools@latest mcp --generate-tool-list

Gérer les problèmes Crashlytics

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

Nom de l'outil	Groupe de caractéristiques	Description
crashlytics_create_note	crashlytics	Ajoutez une note à un problème depuis Crashlytics.
crashlytics_delete_note	crashlytics	Supprimez une note d'un problème Crashlytics.
crashlytics_update_issue	crashlytics	Permet de modifier l'état d'un problème Crashlytics.

Récupérer les données Crashlytics

Le tableau suivant décrit les outils disponibles pour obtenir des informations sur Crashlytics concernant 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 lister les événements les plus récents correspondant aux filtres spécifiés. Peut être utilisé pour récupérer des exemples de plantages et d'exceptions pour un problème, qui incluront des traces de pile et d'autres données utiles pour le débogage.
crashlytics_batch_get_events	crashlytics	Récupère 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, qui incluront des traces de pile et d'autres données utiles pour le débogage.
crashlytics_list_notes	crashlytics	Utilisez cette option pour lister toutes les notes d'un problème dans Crashlytics.
crashlytics_get_top_issues	crashlytics	Utilisez-le pour comptabiliser les événements et les utilisateurs uniques concernés, regroupés par problème. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés.
crashlytics_get_top_variants	crashlytics	Comptabilise les événements et les utilisateurs uniques concernés, regroupés par variante du problème. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés.
crashlytics_get_top_versions	crashlytics	Comptabilise les événements et les utilisateurs uniques concernés, regroupés par version. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés.
crashlytics_get_top_apple_devices	crashlytics	Comptabilise les événements et les utilisateurs concernés distincts, regroupés par appareil Apple. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés. Ne s'applique qu'aux applications iOS, iPadOS et macOS.
crashlytics_get_top_android_devices	crashlytics	Comptabilise les événements et les utilisateurs concernés distincts, regroupés par appareil Android. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés. Uniquement pertinent pour les applications Android.
crashlytics_get_top_operating_systems	crashlytics	Comptabilise les événements et les utilisateurs distincts concernés, regroupés par système d'exploitation. Les groupes sont triés par nombre d'événements, par ordre décroissant. Ne comptabilise que les événements correspondant aux filtres spécifiés.

---

Informations supplémentaires

Utilisation de vos données

La gouvernance des données est déterminée par l'outil de développement optimisé par 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 requêtes Crashlytics MCP, ni la récupération des données Crashlytics à partir de notre API publique.

Les coûts sont déterminés par l'outil de développement optimisé par l'IA que vous utilisez. Ils peuvent également être déterminés par le volume de données Crashlytics 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 judicieux pour le modèle.

Dépannage et questions fréquentes

Crashlytics Les outils et les requêtes MCP ne se chargent pas

Le serveur MCP Firebase tente de reconnaître quand une base de code utilise Crashlytics en inspectant les dépendances installées. Cette fonctionnalité n'est pas encore disponible pour les projets Unity et ne couvre pas certains systèmes de gestion des dépendances non standards pour d'autres plates-formes.

Si les outils et les invites MCP Crashlytics ne se chargent pas, vous pouvez installer manuellement le serveur MCP Firebase et utiliser l'argument --only crashlytics pour charger les outils et les invites MCP Crashlytics.