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 :
- Dans Antigravity, cliquez sur le menu dans le volet "Agent" > MCP Servers (Serveurs MCP).
- 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 :
Ajoutez le marketplace Firebase pour les plug-ins Claude :
claude plugin marketplace add firebase/firebase-toolsInstallez le plug-in Claude pour Firebase :
claude plugin install firebase@firebaseVérifiez l'installation :
claude plugin marketplace list
Option 2 : Configurer manuellement le serveur MCP
Vous pouvez également configurer manuellement le serveur MCP Firebase :
Exécutez la commande suivante dans le dossier de votre application :
claude mcp add firebase npx -- -y firebase-tools@latest mcpVérifiez l'installation :
claude mcp listVoici 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 :
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
crashlytics:connect workflow guidé.Si ce n'est pas déjà fait, configurez le serveur MCP Firebase, puis démarrez votre outil d'IA.
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:connectUtilisez 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.