Assistência de IA para o Crashlytics via MCP

Experimental: os recursos do MCP para Crashlytics são experimentais, o que significa que não estão sujeitos a SLAs ou políticas de descontinuação e podem mudar de maneira incompatível com versões anteriores.

Com as ferramentas e os comandos do Firebase Crashlytics MCP, você pode interagir com seus dados do Crashlytics usando ferramentas de desenvolvimento com tecnologia de IA compatíveis com o MCP, como a CLI do Gemini, o Claude Code ou o Cursor. Essas Crashlytics ferramentas e comandos do MCP fornecem contexto essencial para sua ferramenta de IA, ajudando você a gerenciar, priorizar, depurar e corrigir problemas.

Depois de configurar o servidor MCP do Firebase, você pode usar os recursos do MCP para Crashlytics:

Fluxo de trabalho guiado para priorizar e corrigir problemas

Depuração de conversas em formato livre

Importante: as ferramentas e os comandos do Crashlytics MCP disponíveis no momento são para uso com apps que já usam Crashlytics.

O que é o MCP? O Protocolo de Contexto de Modelo (MCP) é uma maneira padronizada de as ferramentas de IA acessarem ferramentas e fontes de dados externas.

---

Antes de começar: configure o servidor MCP do Firebase

Esta seção descreve a configuração básica do servidor MCP do Firebase para que você possa usar comandos, solicitações e ferramentas do MCP específicos do Crashlytics, que serão descritos mais adiante nesta página.

Pré-requisitos

Verifique se o ambiente atende a estes requisitos:

• Uma instalação funcional do Node.js e do npm. Esse processo instala automaticamente as ferramentas de comando do npm.

• Sua ferramenta de desenvolvimento com tecnologia de IA é compatível com integrações do MCP.

Se você estiver trabalhando com um projeto do Unity, consulte as perguntas frequentes sobre como carregar ferramentas e solicitações do MCP Crashlytics.

Configurar sua ferramenta de IA para usar o servidor MCP do Firebase

CLI do Gemini

A configuração recomendada para que a CLI do Gemini use o servidor MCP do Firebase é instalar a extensão do Firebase para a CLI do Gemini:

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

Instalar a extensão do Firebase configura automaticamente o servidor MCP do Firebase e também disponibiliza um arquivo de contexto que pode melhorar o desempenho do desenvolvimento de Apps do Firebase com o Gemini.

Outra possibilidade para configurar a CLI do Gemini com servidor MCP do Firebase (mas não o arquivo de contexto da extensão do Firebase) é editar ou criar um dos arquivos de configuração:

• No seu projeto: .gemini/settings.json
• No diretório principal: ~/.gemini/settings.json

Se o arquivo ainda não existir, crie-o clicando com o botão direito do mouse no diretório principal e selecionando Novo arquivo. Adicione o seguinte conteúdo ao arquivo:

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

Gemini Code Assist

A configuração recomendada para que o Gemini Code Assist use o servidor MCP do Firebase é instalar a extensão do Firebase para a CLI do Gemini:

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

Instalar a extensão do Firebase configura automaticamente o servidor MCP do Firebase e também disponibiliza um arquivo de contexto que pode melhorar o desempenho do desenvolvimento de Apps do Firebase com o Gemini.

Outra possibilidade para configurar o Gemini Code Assist com servidor MCP do Firebase (mas não o arquivo de contexto da extensão do Firebase) é editar ou criar um dos arquivos de configuração:

• No seu projeto: .gemini/settings.json
• No diretório principal: ~/.gemini/settings.json

Se o arquivo ainda não existir, crie-o clicando com o botão direito do mouse no diretório principal e selecionando Novo arquivo. Adicione o seguinte conteúdo ao arquivo:

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

Firebase Studio

Para configurar o Firebase Studio para usar o servidor MCP do Firebase, edite ou crie os arquivos de configuração: .idx/mcp.json

Se o arquivo ainda não existir, crie-o clicando com o botão direito do mouse no diretório principal e selecionando Novo arquivo. Adicione o seguinte conteúdo ao arquivo:

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

Claude

Claude Code

Para configurar o Claude Code para usar o servidor MCP do Firebase, execute o seguinte comando na pasta do app:

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

Para verificar a instalação, execute:

claude mcp list

Ela vai ser:

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

Claude Desktop

Para configurar o Claude Desktop para usar o servidor MCP, do Firebase edite o arquivo claude_desktop_config.json. Você pode abrir ou criar esse arquivo no menu Claude > Configurações. Selecione a guia Desenvolvedor e clique em Editar configuração.

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

Cline

Para configurar o Cline para usar o servidor MCP do Firebase, edite o arquivo cline_mcp_settings.json. Você pode abrir ou criar esse arquivo clicando no ícone Servidores MCP na parte superior do painel Cline e clicando no botão Configurar servidores MCP.

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

Cursor

Para configurar o Cursor para usar o servidor MCP do Firebase, edite o arquivo .cursor/mcp.json(para configurar apenas um projeto específico) ou o arquivo ~/.cursor/mcp.json (para tornar o servidor MCP disponível em todos os projetos):

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

VS Code Copilot

Para configurar um único projeto, edite o arquivo .vscode/mcp.json em seu espaço de trabalho:

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

Para tornar o servidor disponível em todos os projetos que abrir, edite as configurações do usuário, por exemplo:

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

Windsurf

Para configurar o Windsurf Editor, edite o arquivo ~/.codeium/windsurf/mcp_config.json:

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

Além da configuração básica descrita acima para cada ferramenta de IA, é possível especificar parâmetros opcionais.

Observação: quando o servidor MCP do Firebase faz chamadas de função do MCP, ele usa as mesmas credenciais de usuário que autorizam a CLI do Firebase no ambiente em que ela está sendo executada. Dependendo do ambiente, pode ser um usuário conectado ou Application Default Credentials.

---

(Recomendado) Fluxo de trabalho guiado para priorizar e corrigir problemas com crashlytics:connect

Crashlytics oferece um fluxo de trabalho guiado, conversacional e flexível para ajudar você a priorizar e corrigir problemas de Crashlytics no app. Por exemplo, sua ferramenta de IA pode buscar e explicar problemas, identificar possíveis correções e até mesmo fazer as mudanças no código para você.

Esse fluxo de trabalho guiado está disponível pelo comando crashlytics:connect do MCP.

Observação: nem todas as ferramentas de IA são compatíveis com comandos do MCP como este, mas ainda é possível depurar problemas usando conversas livres.

Acessar e usar o comando

Use uma ferramenta de IA, como a CLI do Gemini, com o fluxo de trabalho guiado crashlytics:connect.

1. Configure o servidor MCP do Firebase, caso ainda não tenha feito isso, e inicie a ferramenta de IA.

2. Execute o comando crashlytics:connect MCP.

   A maioria das ferramentas de IA oferece uma maneira prática de acessar esse fluxo de trabalho. Por exemplo, se você estiver usando a CLI do Gemini, execute o comando de barra /crashlytics:connect

3. Use sua ferramenta de IA para priorizar e corrigir problemas de Crashlytics, por exemplo:

   • Confira uma lista de problemas priorizados.
   • Depure um problema específico fornecendo o ID ou URL dele.
   • Solicitar mais informações sobre uma falha.
   • Pergunte ao agente o raciocínio dele para uma causa raiz sugerida.

---

Depuração conversacional de formato livre

Recomendamos usar crashlytics:connect para ter a melhor experiência de depuração, mas você também pode depurar problemas usando uma conversa livre com uma ferramenta de IA que tenha acesso às ferramentas do MCP Crashlytics. Isso é especialmente importante para ferramentas de IA que ainda não são compatíveis com comandos do MCP (geralmente chamados de comandos de barra ou personalizados).

Depois de configurar o servidor MCP do Firebase, teste alguns dos exemplos a seguir.

Buscar um problema e o contexto de falha

Quando sua ferramenta de IA tem acesso às ferramentas do Crashlytics MCP, ela pode buscar dados críticos de problemas do Crashlytics, como contagens de usuários e eventos, rastreamentos de pilha, metadados e informações da versão do app.

Confira alguns exemplos:

• 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 a essa pergunta, a ferramenta de IA provavelmente vai ler seu código para entender onde o login acontece e usar várias ferramentas de Crashlytics MCP para recuperar dados de problemas. Em seguida, a ferramenta de IA vai tentar determinar se há um problema na versão mais recente relacionado ao fluxo de login.

• 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 a essa pergunta, sua ferramenta de IA vai usar várias ferramentas do MCP Crashlytics para recuperar o contexto do problema e todas as observações postadas nele. Ele também pode buscar exemplos de falhas para retomar a investigação do problema.

Documentar uma investigação de depuração

Ao depurar um problema, é útil manter registros para você ou sua equipe. O Crashlytics oferece essa capacidade no console Firebase, e sua ferramenta de IA equipada com ferramentas do MCP do Crashlytics também pode ajudar. Por exemplo, resumir uma investigação, adicionar uma observação com metadados úteis (como um link para um problema do Jira ou do GitHub) ou fechar um problema depois que ele for corrigido.

Confira alguns exemplos:

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

---

Referência da ferramenta MCP Crashlytics

As tabelas a seguir listam as ferramentas do Crashlytics MCP disponíveis no servidor MCP do Firebase.

Depois de configurar o servidor MCP do Firebase, sua ferramenta de IA poderá usar essas ferramentas do MCP para ajudar você a entender, depurar e gerenciar problemas. Essas ferramentas do MCP são usadas no fluxo de trabalho guiado crashlytics:connect e nas conversas livres com sua ferramenta de IA.

Na maioria dos casos de uso, essas ferramentas de MCP são apenas para uso de LLM e não para uso direto por um desenvolvedor humano. O LLM decide quando usar essas ferramentas do MCP com base na sua interação com a ferramenta de IA.

Observação: você também pode ver essas informações usando o comando: npx firebase-tools@latest mcp --generate-tool-list

Gerenciar problemas de Crashlytics

A tabela a seguir descreve as ferramentas disponíveis para gerenciar seus problemas de Crashlytics.

Nome da ferramenta	Grupo de atributos	Descrição
crashlytics_create_note	crashlytics	Adicione uma nota a um problema do Crashlytics.
crashlytics_delete_note	crashlytics	Exclua uma observação de um problema do Crashlytics.
crashlytics_update_issue	crashlytics	Use-a para atualizar o estado do problema do Crashlytics.

Buscar dados do Crashlytics

A tabela a seguir descreve as ferramentas disponíveis para receber informações relacionadas ao Crashlytics sobre seus apps.

Nome da ferramenta	Grupo de atributos	Descrição
crashlytics_get_issue	crashlytics	Recebe dados de um problema do Crashlytics, que podem ser usados como ponto de partida para depuração.
crashlytics_list_events	crashlytics	Use-a para listar os eventos mais recentes que correspondem aos filtros especificados. Pode ser usada para buscar exemplos de falhas e exceções de um problema, incluindo stack traces e outros dados úteis para depuração.
crashlytics_batch_get_events	crashlytics	Recebe eventos específicos pelo nome do recurso. Pode ser usada para buscar exemplos de falhas e exceções de um problema, incluindo stack traces e outros dados úteis para depuração.
crashlytics_list_notes	crashlytics	Use-a para listar todas as observações de um problema do Crashlytics.
crashlytics_get_top_issues	crashlytics	Use-a para contar eventos e usuários afetados distintos, agrupados por problema. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados.
crashlytics_get_top_variants	crashlytics	Conta eventos e usuários afetados distintos, agrupados por variante do problema. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados.
crashlytics_get_top_versions	crashlytics	Conta eventos e usuários afetados distintos, agrupados por versão. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados.
crashlytics_get_top_apple_devices	crashlytics	Conta eventos e usuários afetados distintos, agrupados por dispositivo da Apple. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados. Relevante apenas para aplicativos iOS, iPadOS e macOS.
crashlytics_get_top_android_devices	crashlytics	Conta eventos e usuários afetados distintos, agrupados por dispositivo Android. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados. Relevante apenas para apps Android.
crashlytics_get_top_operating_systems	crashlytics	Conta eventos e usuários distintos afetados, agrupados por sistema operacional. Os grupos são ordenados pela contagem de eventos, em ordem decrescente. Conta apenas eventos que correspondem aos filtros especificados.

---

Mais informações

Como seus dados são usados

A governança de dados é determinada pela ferramenta de desenvolvimento com tecnologia de IA que você usa e está sujeita aos termos definidos por essa ferramenta.

Preços

O Firebase não cobra pelo uso de comandos e ferramentas do MCP Crashlytics ou pela busca de dados Crashlytics na nossa API pública.

O custo é determinado pela ferramenta de desenvolvimento com tecnologia de IA que você usa e pode ser determinado pelo volume de dados Crashlytics usados pela ferramenta de IA. O Firebase não oferece uma maneira explícita de controlar a quantidade de dados carregados no contexto, mas incluímos orientações padrão razoáveis para o modelo.

Solução de problemas e perguntas frequentes

Crashlytics As ferramentas e solicitações do MCP não estão carregando

O servidor MCP do Firebase tenta reconhecer quando uma base de código está usando Crashlytics inspecionando as dependências instaladas. Esse recurso ainda não é compatível com projetos do Unity e não abrange alguns sistemas de gerenciamento de dependências não padrão para outras plataformas.

Se as ferramentas e os comandos do MCP Crashlytics não estiverem carregando, instale o servidor MCP do Firebase manualmente e use o argumento --only crashlytics para carregar as ferramentas e os comandos do MCP Crashlytics.