Con las herramientas y las instrucciones de Firebase Crashlytics MCP, puedes interactuar con tus datos de Crashlytics usando tus herramientas de desarrollo potenciadas por IA compatibles con MCP, como la CLI de Gemini, Claude Code o Cursor. Estas Crashlytics herramientas y mensajes de MCP proporcionan contexto fundamental a tu herramienta de IA para ayudarte a administrar, priorizar, depurar y corregir problemas.
Después de configurar el servidor de MCP de Firebase, puedes usar las funciones de MCP para Crashlytics:
Flujo de trabajo guiado para priorizar y corregir problemas
Depuración conversacional de formato libre
¿Qué es el MCP? El Protocolo de contexto del modelo (MCP) es una forma estandarizada para que las herramientas de IA accedan a herramientas y fuentes de datos externas.
Antes de comenzar: Configura el servidor de MCP de Firebase
En esta sección, se describe la configuración básica del servidor de MCP de Firebase para que puedas usar comandos, instrucciones y herramientas de MCP específicos de Crashlytics (todos se describen más adelante en esta página).
Requisitos previos
Asegúrate de que tu entorno cumpla con estos requisitos:
Una instalación funcional de Node.js y npm Cuando lo hagas, se instalarán automáticamente las herramientas del comando npm.
Tu herramienta de desarrollo potenciada por IA admite integraciones de MCP.
Si trabajas con un proyecto de Unity, consulta las preguntas frecuentes sobre la carga de herramientas y mensajes de Crashlytics MCP.
Configura tu herramienta de IA para que use el servidor de MCP de Firebase
CLI de Gemini
La forma recomendada de configurar Gemini CLI para que use el servidor de MCP de Firebase es instalar la extensión de Firebase para Gemini CLI:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/La instalación de la extensión de Firebase configura automáticamente el servidor de MCP de Firebase y también incluye un archivo de contexto que puede mejorar el rendimiento del desarrollo de apps de Firebase con Gemini.
Como alternativa, puedes configurar Gemini CLI para que use el servidor de MCP de Firebase (pero no el archivo de contexto de la extensión de Firebase) editando o creando uno de los archivos de configuración:
- En tu proyecto:
.gemini/settings.json - En tu directorio principal:
~/.gemini/settings.json
Si el archivo aún no existe, créalo haciendo clic con el botón derecho en el directorio principal y seleccionando Nuevo archivo. Agrega el siguiente contenido al archivo:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Gemini Code Assist
La forma recomendada de configurar Gemini Code Assist para que use el servidor de MCP de Firebase es instalar la extensión de Firebase para Gemini CLI:
gemini extensions install https://github.com/gemini-cli-extensions/firebase/La instalación de la extensión de Firebase configura automáticamente el servidor de MCP de Firebase y también incluye un archivo de contexto que puede mejorar el rendimiento del desarrollo de apps de Firebase con Gemini.
Como alternativa, puedes configurar Gemini Code Assist para que use el servidor de MCP de Firebase (pero no el archivo de contexto de la extensión de Firebase) editando o creando uno de los archivos de configuración:
- En tu proyecto:
.gemini/settings.json - En tu directorio principal:
~/.gemini/settings.json
Si el archivo aún no existe, créalo haciendo clic con el botón derecho en el directorio principal y seleccionando Nuevo archivo. Agrega el siguiente contenido al archivo:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Firebase Studio
Para configurar Firebase Studio para que use el servidor de MCP de Firebase, edita o crea el archivo de configuración: .idx/mcp.json.
Si el archivo aún no existe, créalo haciendo clic con el botón derecho en el directorio principal y seleccionando Nuevo archivo. Agrega el siguiente contenido al archivo:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Para configurar Claude Code para que use el servidor de MCP de Firebase, ejecuta el siguiente comando en la carpeta de tu app:
claude mcp add firebase npx -- -y firebase-tools@latest mcpPara verificar la instalación, ejecuta el siguiente comando:
claude mcp listDebería mostrar lo siguiente:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude para computadoras de escritorio
Para configurar Claude Desktop para que use el servidor MCP de Firebase, edita el archivo claude_desktop_config.json. Puedes abrir o crear este archivo desde el menú Claude > Configuración. Selecciona la pestaña Desarrollador y, luego, haz clic en Editar configuración.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cline
Para configurar Cline para que use el servidor MCP de Firebase, edita el archivo cline_mcp_settings.json. Para abrir o crear este archivo, haz clic en el ícono de los servidores de MCP en la parte superior del panel de Cline y, luego, en el botón Configure MCP Servers.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
Cursor
Para configurar Cursor para que use el servidor de MCP de Firebase, edita el archivo .cursor/mcp.json (para configurar solo un proyecto específico) o el archivo ~/.cursor/mcp.json (para que el servidor de MCP esté disponible en todos los proyectos):
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Copilot en VS Code
Para configurar un solo proyecto, edita el archivo .vscode/mcp.json en tu espacio de trabajo:
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Para que el servidor esté disponible en todos los proyectos que abras, edita la configuración del usuario, por ejemplo:
"mcp": {
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Windsurf
Para configurar Windsurf Editor, edita el archivo ~/.codeium/windsurf/mcp_config.json:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Además de la configuración básica que se describió anteriormente para cada herramienta de IA, puedes especificar parámetros opcionales.
(Recomendado) Flujo de trabajo guiado para priorizar y corregir problemas con crashlytics:connect
Crashlytics proporciona un flujo de trabajo guiado que es conversacional y flexible para ayudarte a priorizar y corregir los problemas de Crashlytics en tu app. Por ejemplo, tu herramienta de IA puede recuperar problemas, explicarlos, identificar posibles correcciones y hasta realizar los cambios de código por ti.
Este flujo de trabajo guiado está disponible a través del comando crashlytics:connect de MCP.
Accede al comando y úsalo
crashlytics:connect.Si aún no lo has hecho, configura el servidor de MCP de Firebase y, luego, inicia tu herramienta de IA.
Ejecuta el comando
crashlytics:connectde MCP.La mayoría de las herramientas de IA proporcionan una forma de acceder a este flujo de trabajo de manera conveniente. Por ejemplo, si usas Gemini CLI, ejecuta el comando de barra
/crashlytics:connectUsa tu herramienta de IA para priorizar y corregir problemas de Crashlytics, por ejemplo:
- Consulta una lista de problemas priorizados.
- Depura un problema específico proporcionando su ID o URL.
- Solicita más información sobre una falla.
- Pregúntale al agente por qué sugiere una causa raíz.
Depuración conversacional de formato libre
Si bien te recomendamos usar crashlytics:connect para obtener la mejor experiencia de depuración, también puedes depurar problemas con una conversación de formato libre con una herramienta de IA que tenga acceso a las herramientas de MCP de Crashlytics. Esto es especialmente importante para las herramientas de IA que aún no admiten instrucciones de MCP (a menudo denominadas comandos de barra o comandos personalizados).
Después de configurar el servidor de MCP de Firebase, prueba algunos de los siguientes ejemplos.
Cómo recuperar el contexto de un problema y una falla
Cuando tu herramienta de IA tiene acceso a las herramientas de Crashlytics MCP, puede recuperar datos críticos de problemas de Crashlytics, como recuentos de usuarios y eventos, registros de seguimiento de pila, metadatos y la información de la versión de la app.
Estos son algunos ejemplos de instrucciones:
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?- Para responder esta pregunta, es probable que tu herramienta de IA lea tu código para comprender dónde se produce el acceso y use varias herramientas de MCP de Crashlytics para recuperar datos de problemas. Luego, la herramienta de IA intentará determinar si existe un problema en la versión más reciente relacionado con el flujo de acceso.
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.- Para responder esta pregunta, tu herramienta de IA usará varias herramientas de Crashlytics MCP para recuperar el contexto del problema y las notas publicadas en él. También puede recuperar ejemplos de fallas para reanudar la investigación del problema.
Documenta una investigación de depuración
Cuando depuras un problema, suele ser útil mantener registros para ti o tu equipo. Crashlytics ofrece esta capacidad en la consola de Firebase, y tu herramienta de IA equipada con herramientas de MCP de Crashlytics también puede ayudarte, por ejemplo, a resumir una investigación, agregar una nota con metadatos útiles (como un vínculo a un problema de Jira o GitHub) o cerrar un problema después de que se solucione.
Estos son algunos ejemplos de instrucciones:
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.
Referencia de la herramienta de MCP de Crashlytics
En las siguientes tablas, se enumeran las herramientas de Crashlytics de MCP que están disponibles a través del servidor de MCP de Firebase.
Después de configurar el servidor de MCP de Firebase, tu herramienta de IA puede usar estas herramientas de MCP para ayudarte a comprender, depurar y administrar problemas. Estas herramientas de MCP se usan tanto en el flujo de trabajo guiado de crashlytics:connect como en las conversaciones de formato libre con tu herramienta de IA.
En la mayoría de los casos de uso, estas herramientas de MCP son solo para el uso de LLM y no para el uso directo por parte de un desarrollador humano. El LLM decide cuándo usar estas herramientas de MCP según tu interacción con la herramienta de IA.
Administra problemas de Crashlytics
En la siguiente tabla, se describen las herramientas disponibles para administrar tus problemas de Crashlytics.
| Nombre de la herramienta | Grupo de funciones | Descripción |
|---|---|---|
| crashlytics_create_note | crashlytics | Agrega una nota a un problema de Crashlytics. |
| crashlytics_delete_note | crashlytics | Borra una nota de un problema de Crashlytics. |
| crashlytics_update_issue | crashlytics | Se usa para actualizar el estado del problema de Crashlytics. |
Cómo obtener datos de Crashlytics
En la siguiente tabla, se describen las herramientas disponibles para obtener información relacionada con Crashlytics sobre tus apps.
| Nombre de la herramienta | Grupo de funciones | Descripción |
|---|---|---|
| crashlytics_get_issue | crashlytics | Obtiene datos sobre un problema de Crashlytics, que se puede usar como punto de partida para la depuración. |
| crashlytics_list_events | crashlytics | Usa este comando para enumerar los eventos más recientes que coinciden con los filtros proporcionados. Se puede usar para recuperar muestras de fallas y excepciones de un problema, que incluirán seguimientos de pila y otros datos útiles para la depuración. |
| crashlytics_batch_get_events | crashlytics | Obtiene eventos específicos por nombre de recurso. Se puede usar para recuperar muestras de fallas y excepciones de un problema, que incluirán seguimientos de pila y otros datos útiles para la depuración. |
| crashlytics_list_notes | crashlytics | Usa este comando para enumerar todas las notas de un problema en Crashlytics. |
| crashlytics_get_top_issues | crashlytics | Usa este comando para registrar eventos y usuarios afectados distintos, agrupados por problema. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. |
| crashlytics_get_top_variants | crashlytics | Registra los eventos y los usuarios afectados distintos, agrupados por variante del problema. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. |
| crashlytics_get_top_versions | crashlytics | Registra los eventos y los usuarios afectados distintos, agrupados por versión. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. |
| crashlytics_get_top_apple_devices | crashlytics | Registra los eventos y los usuarios afectados distintos, agrupados por dispositivo de Apple. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. Solo es relevante para las aplicaciones de iOS, iPadOS y macOS. |
| crashlytics_get_top_android_devices | crashlytics | Registra los eventos y los usuarios afectados distintos, agrupados por dispositivo Android. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. Solo es pertinente para las aplicaciones para Android. |
| crashlytics_get_top_operating_systems | crashlytics | Registra los eventos y los usuarios afectados distintos, agrupados por sistema operativo. Los grupos se ordenan por recuento de eventos en orden descendente. Solo registra los eventos que coinciden con los filtros especificados. |
Información adicional
Cómo se usan tus datos
La administración de datos está determinada por la herramienta de desarrollo potenciada por IA que uses y está sujeta a las condiciones definidas por esa herramienta.
Precios
Firebase no te cobra por usar las herramientas y las instrucciones de Crashlytics MCP ni por recuperar datos de Crashlytics de nuestra API pública.
El costo lo determina la herramienta de desarrollo potenciada por IA que uses, y podría depender de la cantidad de datos de Crashlytics que utilice la herramienta de IA. Ten en cuenta que Firebase no ofrece una forma explícita de controlar la cantidad de datos que se cargan en el contexto, pero sí incluimos una guía predeterminada razonable para el modelo.