Помощь ИИ для Crashlytics через MCP

Экспериментальная функция: Функции MCP для Crashlytics являются экспериментальными, что означает, что на них не распространяются никакие соглашения об уровне обслуживания (SLA) или политика устаревания, и они могут изменяться несовместимым образом.

С помощью инструментов и подсказок Firebase Crashlytics MCP вы можете взаимодействовать с данными Crashlytics , используя инструменты разработки на основе ИИ, поддерживающие MCP, такие как Gemini CLI, Claude Code или Cursor. Эти инструменты и подсказки Crashlytics MCP предоставляют важный контекст для вашего инструмента ИИ, помогая вам управлять, расставлять приоритеты, отлаживать и исправлять проблемы.

После настройки сервера Firebase MCP вы сможете использовать функции MCP для Crashlytics :

Пошаговый алгоритм действий для определения приоритетов и устранения проблем.

Отладка в свободной форме посредством диалога

Важно: доступные в настоящее время инструменты и подсказки Crashlytics MCP предназначены для использования с приложениями, которые уже используют Crashlytics .

такое MCP? Протокол контекста модели (MCP) — это стандартизированный способ доступа инструментов искусственного интеллекта к внешним инструментам и источникам данных.

---

Перед началом работы: Настройте сервер Firebase MCP.

В этом разделе описывается базовая настройка сервера Firebase MCP , позволяющая использовать команды, подсказки и инструменты MCP, специфичные Crashlytics (все они описаны далее на этой странице).

Предварительные требования

Убедитесь, что ваша среда соответствует следующим требованиям:

• Рабочая установка Node.js и npm. Установка Node.js автоматически устанавливает инструменты командной строки npm.

• Ваш инструмент разработки на основе искусственного интеллекта поддерживает интеграцию с MCP.

Если вы работаете с проектом Unity, ознакомьтесь с разделом часто задаваемых вопросов (FAQ) о загрузке инструментов и подсказок Crashlytics MCP .

Настройте свой инструмент искусственного интеллекта для использования сервера Firebase MCP.

Антигравитация

Чтобы настроить Antigravity для использования сервера Firebase MCP:

1. В Antigravity в панели агентов выберите пункт меню > Серверы MCP .
2. Выберите Firebase > Установить .

Это автоматически обновит ваш файл mcp_config.json , который можно просмотреть, нажав «Управление серверами MCP» в верхней части панели «Магазин MCP» > «Просмотреть исходную конфигурацию» , следующим содержимым:

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

Gemini CLI

Рекомендуемый способ настройки Gemini CLI для использования сервера Firebase MCP — это установка расширения Firebase для Gemini CLI :

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

Установка расширения Firebase автоматически настраивает сервер Firebase MCP, а также включает в себя файл контекста, который может повысить производительность разработки приложений Firebase в Gemini.

В качестве альтернативы вы можете настроить Gemini CLI для использования сервера Firebase MCP (но не файла контекста расширения Firebase), отредактировав или создав один из конфигурационных файлов:

• В вашем проекте: .gemini/settings.json
• В вашей домашней директории: ~/.gemini/settings.json

Если файл еще не существует, создайте его, щелкнув правой кнопкой мыши по родительскому каталогу и выбрав «Новый файл» . Добавьте в файл следующее содержимое:

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

Gemini Code Assist

Рекомендуемый способ настройки Gemini Code Assist для использования сервера Firebase MCP — это установка расширения Firebase для Gemini CLI :

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

Установка расширения Firebase автоматически настраивает сервер Firebase MCP, а также включает в себя файл контекста, который может повысить производительность разработки приложений Firebase в Gemini.

В качестве альтернативы вы можете настроить Gemini Code Assist для использования сервера Firebase MCP (но не файла контекста расширения Firebase), отредактировав или создав один из конфигурационных файлов:

• В вашем проекте: .gemini/settings.json
• В вашей домашней директории: ~/.gemini/settings.json

Если файл еще не существует, создайте его, щелкнув правой кнопкой мыши по родительскому каталогу и выбрав «Новый файл» . Добавьте в файл следующее содержимое:

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

Firebase Studio

Чтобы настроить Firebase Studio для использования сервера Firebase MCP, отредактируйте или создайте конфигурационный файл: .idx/mcp.json .

Если файл еще не существует, создайте его, щелкнув правой кнопкой мыши по родительскому каталогу и выбрав «Новый файл» . Добавьте в файл следующее содержимое:

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

Клод

Кодекс Клода

• Вариант 1 : Установка через плагин (рекомендуется)

  Самый простой способ настроить сервер Firebase MCP в Claude Code — установить официальный плагин Firebase:

  1. Добавьте Firebase Marketplace для плагинов Claude:

     claude plugin marketplace add firebase/firebase-tools

  2. Установите плагин Claude для Firebase:

     claude plugin install firebase@firebase

  3. Проверьте установку:

     claude plugin marketplace list

• Вариант 2 : Настройка сервера MCP вручную.

  В качестве альтернативы вы можете настроить сервер Firebase MCP вручную:

  1. Выполните следующую команду в папке вашего приложения:

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

  2. Проверьте установку:

     claude mcp list

     Должно отобразиться:

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

Клод Рабочий стол

Чтобы настроить Claude Desktop для использования сервера Firebase MCP, отредактируйте файл claude_desktop_config.json . Вы можете открыть или создать этот файл в меню Claude > Настройки . Выберите вкладку «Разработчик» , затем нажмите «Редактировать конфигурацию» .

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

Клайн

Чтобы настроить Cline для использования сервера Firebase MCP, отредактируйте файл cline_mcp_settings.json . Вы можете открыть или создать этот файл, щелкнув значок «Серверы MCP» в верхней части панели Cline, а затем нажав кнопку «Настроить серверы MCP» .

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

Курсор

Нажмите следующую кнопку, чтобы добавить сервер Firebase MCP в глобальную конфигурацию курсора.

Если вы предпочитаете добавлять конфигурацию вручную или хотите настроить ее для конкретного проекта, вы можете отредактировать файл mcp.json .

• Для конкретного проекта : отредактируйте .cursor/mcp.json
• Для всех проектов (глобально) : отредактируйте файл ~/.cursor/mcp.json

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

VS Code Copilot

Для настройки отдельного проекта отредактируйте файл .vscode/mcp.json в вашей рабочей области:

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

Чтобы сервер был доступен в каждом открытом вами проекте, отредактируйте пользовательские настройки, например:

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

Виндсёрфинг

Для настройки редактора Windsurf отредактируйте файл ~/.codeium/windsurf/mcp_config.json :

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

В дополнение к базовой конфигурации, описанной выше для каждого инструмента ИИ, вы можете указать дополнительные параметры .

Примечание: Когда сервер Firebase MCP выполняет вызовы инструментов MCP, он использует те же учетные данные пользователя, которые авторизуют Firebase CLI в среде, где он запущен. В зависимости от среды это может быть авторизованный пользователь или учетные данные приложения по умолчанию .

---

(Рекомендуется) Пошаговый алгоритм действий для определения приоритетов и устранения проблем с crashlytics:connect

Crashlytics предоставляет гибкий и управляемый рабочий процесс, который помогает расставлять приоритеты и исправлять проблемы, обнаруженные Crashlytics в вашем приложении. Например, ваш инструмент на основе ИИ может получать информацию о проблемах, объяснять их, определять потенциальные решения и даже вносить изменения в код за вас.

Этот пошаговый алгоритм доступен через команду MCP crashlytics:connect .

Примечание: Не все инструменты ИИ поддерживают подобные команды MCP, но вы все равно можете отлаживать проблемы, используя свободный диалог .

Получите доступ к команде и используйте её.

Используйте инструмент искусственного интеллекта, например Gemini CLI, в сочетании с пошаговым рабочим процессом crashlytics:connect .

1. Если вы еще этого не сделали, настройте сервер Firebase MCP , а затем запустите свой инструмент искусственного интеллекта.

2. Выполните команду crashlytics:connect MCP.

   Большинство инструментов искусственного интеллекта предоставляют удобный способ доступа к этому рабочему процессу. Например, если вы используете Gemini CLI, выполните команду с косой чертой. /crashlytics:connect

3. Используйте свой инструмент искусственного интеллекта, чтобы, например, расставить приоритеты и устранить проблемы Crashlytics :

   • Просмотрите список приоритетных вопросов.
   • Для устранения конкретной проблемы укажите ее идентификатор или URL-адрес.
   • Запросите дополнительную информацию об аварии.
   • Поинтересуйтесь у агента, почему он предложил именно такую ​​первопричину проблемы.

---

Отладка в свободной форме посредством диалога

Хотя мы рекомендуем использовать crashlytics:connect для наилучшего опыта отладки , вы также можете отлаживать проблемы, используя свободный диалог с инструментом искусственного интеллекта, имеющим доступ к инструментам Crashlytics MCP. Это особенно важно для инструментов ИИ, которые еще не поддерживают запросы MCP (часто называемые слэш-командами или пользовательскими командами).

После настройки сервера Firebase MCP попробуйте выполнить некоторые из следующих примеров.

Получение информации о проблеме и контекст сбоя

Когда ваш инструмент искусственного интеллекта получает доступ к инструментам Crashlytics MCP, он может получать важные данные о проблемах Crashlytics , такие как количество пользователей и событий, трассировки стека, метаданные и информация о версиях приложений.

Вот несколько примеров вопросов:

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

  • Чтобы ответить на этот вопрос, ваш инструмент искусственного интеллекта, скорее всего, проанализирует ваш код, чтобы понять, где происходит авторизация, и использует различные инструменты Crashlytics MCP для получения данных о проблемах. Затем ваш инструмент ИИ попытается определить, существует ли в последней версии проблема, связанная с процессом авторизации.

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

  • Чтобы ответить на этот вопрос, ваш инструмент искусственного интеллекта будет использовать различные инструменты Crashlytics MCP для получения контекста проблемы и любых заметок, опубликованных к ней. Он также может получить примеры сбоев, чтобы возобновить расследование проблемы.

Документируйте расследование по устранению неполадок.

При отладке проблем часто бывает полезно вести записи для себя или своей команды. Crashlytics предоставляет такую ​​возможность в консоли Firebase , и ваш инструмент искусственного интеллекта, оснащенный инструментами Crashlytics MCP, также может помочь — например: обобщить результаты расследования, добавить заметку с полезными метаданными (например, ссылку на задачу в Jira или GitHub) или закрыть проблему после ее решения.

Вот несколько примеров вопросов:

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

---

Справочник по инструменту Crashlytics MCP

В приведенных ниже таблицах перечислены инструменты Crashlytics MCP, доступные через сервер Firebase MCP.

После настройки сервера Firebase MCP ваш инструмент искусственного интеллекта сможет использовать эти инструменты MCP, чтобы помочь вам понять, отладить и управлять проблемами. Эти инструменты MCP используются как в пошаговом рабочем процессе crashlytics:connect так и в свободных диалогах с вашим инструментом ИИ.

В большинстве случаев эти инструменты MCP предназначены только для использования студентами магистратуры по информационным технологиям (LLM) и не предназначены для непосредственного использования разработчиками-людьми. Решение о том, когда использовать эти инструменты MCP, принимает LLM на основе вашего взаимодействия с инструментом ИИ.

Примечание: Вы также можете просмотреть эту информацию с помощью команды: npx firebase-tools@latest mcp --generate-tool-list

Управление проблемами Crashlytics

В таблице ниже описаны инструменты, доступные для решения проблем, Crashlytics .

Название инструмента	Группа функций	Описание
crashlytics_create_note	крашлитики	Добавить примечание к проблеме из Crashlytics.
crashlytics_delete_note	крашлитики	Удалить заметку из задачи Crashlytics.
crashlytics_update_issue	крашлитики	Используйте это для обновления статуса проблемы в Crashlytics.

Получить данные Crashlytics

В таблице ниже описаны инструменты, доступные для получения информации о ваших приложениях, связанной с Crashlytics .

Название инструмента	Группа функций	Описание
crashlytics_get_issue	крашлитики	Получает данные по проблеме в Crashlytics, которые можно использовать в качестве отправной точки для отладки.
crashlytics_list_events	крашлитики	Используйте эту строку для отображения списка последних событий, соответствующих заданным фильтрам. Может использоваться для получения примеров сбоев и исключений, связанных с проблемой. которые будут включать трассировку стека и другие данные, полезные для отладки.
crashlytics_batch_get_events	крашлитики	Получает конкретные события по имени ресурса. Может использоваться для получения примеров сбоев и исключений, связанных с проблемой. которые будут включать трассировку стека и другие данные, полезные для отладки.
crashlytics_list_notes	крашлитики	Используйте это для отображения всех заметок по проблеме в Crashlytics.
crashlytics_get_top_issues	крашлитики	Используйте это для подсчета событий и уникальных затронутых пользователей, сгруппированных по проблеме . Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам.
crashlytics_get_top_variants	крашлитики	Подсчитывает количество событий и уникальных затронутых пользователей, сгруппированных по варианту проблемы. Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам.
crashlytics_get_top_versions	крашлитики	Подсчитывает количество событий и уникальных затронутых пользователей, сгруппированных по версии . Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам.
crashlytics_get_top_apple_devices	крашлитики	Подсчитывает количество событий и уникальных затронутых пользователей, сгруппированных по устройствам Apple. Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам. Подходит только для приложений iOS, iPadOS и MacOS.
crashlytics_get_top_android_devices	крашлитики	Подсчитывает количество событий и уникальных затронутых пользователей, сгруппированных по типу устройства Android. Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам. Актуально только для приложений Android.
crashlytics_get_top_operating_systems	крашлитики	Подсчитывает количество событий и уникальных затронутых пользователей, сгруппированных по операционной системе . Группы отсортированы по количеству событий в порядке убывания. Учитываются только события, соответствующие заданным фильтрам.

---

Дополнительная информация

Как используются ваши данные

Управление данными определяется используемым вами инструментом разработки на основе ИИ и регулируется условиями, установленными этим инструментом.

Цены

Firebase не взимает плату за использование инструментов и подсказок Crashlytics MCP, а также за получение данных Crashlytics из нашего общедоступного API.

Любые затраты определяются используемым вами инструментом разработки на основе ИИ и могут зависеть от объема данных Crashlytics , используемых этим инструментом. Обратите внимание, что Firebase не предоставляет явного способа контролировать объем данных, загружаемых в контекст, но мы предлагаем разумные рекомендации по умолчанию для этой модели.

Устранение неполадок и часто задаваемые вопросы

Инструменты и подсказки Crashlytics MCP не загружаются.

Сервер Firebase MCP пытается определить, использует ли кодовая база Crashlytics , путем проверки установленных зависимостей. Эта возможность пока не поддерживается для проектов Unity и не охватывает некоторые нестандартные системы управления зависимостями для других платформ.

Если инструменты и подсказки Crashlytics MCP у вас не загружаются, то в качестве обходного пути вы можете установить сервер Firebase MCP вручную и использовать аргумент --only crashlytics для загрузки инструментов и подсказок Crashlytics MCP.