С помощью инструментов и подсказок MCP Firebase Crashlytics вы можете взаимодействовать с данными Crashlytics , используя инструменты разработки на базе ИИ с поддержкой MCP, такие как Gemini CLI, Claude Code или Cursor. Эти инструменты и подсказки MCP Crashlytics предоставляют вашему инструменту ИИ критически важный контекст, помогая вам управлять проблемами, расставлять приоритеты, отлаживать и устранять их.
После настройки сервера Firebase MCP вы можете использовать функции MCP для Crashlytics :
Управляемый рабочий процесс для определения приоритетов и устранения проблем
Отладка в свободной форме в режиме диалога
такое MCP? Протокол контекста модели (MCP) — это стандартизированный способ доступа инструментов ИИ к внешним инструментам и источникам данных.
Прежде чем начать: настройте сервер Firebase MCP
В этом разделе описывается базовая настройка сервера Firebase MCP, чтобы вы могли использовать специфичные для Crashlytics команды, подсказки и инструменты MCP (которые описаны далее на этой странице).
Предпосылки
Убедитесь, что ваша среда соответствует следующим требованиям:
Рабочая установка Node.js и npm. Установка Node.js автоматически устанавливает инструменты командной строки npm.
Ваш инструмент разработки на базе ИИ поддерживает интеграцию MCP.
Если вы работаете с проектом Unity, ознакомьтесь с часто задаваемыми вопросами о загрузке инструментов и подсказок Crashlytics MCP .
Настройте свой инструмент ИИ для использования сервера Firebase MCP
Gemini CLI
Рекомендуемый способ настройки Gemini CLI для использования сервера Firebase MCP — установка расширения Firebase для Gemini CLI :
gemini extensions install https://github.com/gemini-cli-extensions/firebase/Установка расширения Firebase автоматически настраивает сервер Firebase MCP, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
В качестве альтернативы вы можете настроить 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, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
Кроме того, вы можете настроить Gemini Code Assist на использование сервера Firebase MCP (но не файла контекста расширения Firebase), отредактировав или создав один из файлов конфигурации:
- В вашем проекте:
.gemini/settings.json - В вашем домашнем каталоге:
~/.gemini/settings.json
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Студия Firebase
Чтобы настроить Firebase Studio для использования сервера Firebase MCP, отредактируйте или создайте файл конфигурации: .idx/mcp.json .
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Клод
Клод Код
Чтобы настроить Claude Code для использования сервера Firebase MCP, выполните следующую команду в папке вашего приложения:
claude mcp add firebase npx -- -y firebase-tools@latest mcpПроверить установку можно, выполнив:
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 Editor, отредактируйте файл ~/.codeium/windsurf/mcp_config.json :
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Помимо базовой конфигурации, описанной выше, для каждого инструмента ИИ можно указать дополнительные параметры .
(Рекомендуется) Пошаговый рабочий процесс для определения приоритетов и устранения проблем с crashlytics:connect
Crashlytics предлагает гибкий и управляемый рабочий процесс, основанный на диалоговом взаимодействии, который поможет вам приоритизировать и устранять проблемы Crashlytics в вашем приложении. Например, ваш инструмент на основе искусственного интеллекта может выявлять проблемы, объяснять их, определять потенциальные пути решения и даже вносить изменения в код.
Этот управляемый рабочий процесс доступен с помощью команды crashlytics:connect MCP.
Доступ и использование команды

crashlytics:connect .Если вы еще этого не сделали, настройте сервер Firebase MCP , а затем запустите свой инструмент ИИ.
Запустите команду
crashlytics:connectMCP.Большинство инструментов ИИ предоставляют удобный способ доступа к этому рабочему процессу. Например, если вы используете Gemini CLI, выполните команду
/crashlytics:connectИспользуйте инструмент ИИ для определения приоритетов и устранения проблем Crashlytics , например:
- Просмотреть список приоритетных проблем.
- Устраните конкретную проблему, указав ее идентификатор или URL.
- Запросите дополнительную информацию о сбое.
- Спросите агента, как он обосновывает предполагаемую основную причину.
Отладка в свободной форме в режиме диалога
Хотя мы рекомендуем использовать crashlytics:connect для оптимальной отладки , вы также можете отлаживать проблемы, используя свободное общение с инструментом ИИ, имеющим доступ к инструментам MCP Crashlytics . Это особенно важно для инструментов ИИ, которые пока не поддерживают запросы 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, а не для непосредственного использования разработчиком-человеком. LLM решает, когда использовать эти инструменты MCP, основываясь на вашем взаимодействии с инструментом ИИ.
Управление проблемами 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 не предлагает явного способа управления объёмом данных, загружаемых в контекст, но мы предоставляем разумные рекомендации по умолчанию для модели.
Устранение неполадок и часто задаваемые вопросы
Сервер Firebase MCP пытается определить, использует ли кодовая база Crashlytics , проверяя установленные зависимости. Эта возможность пока не поддерживается для проектов Unity и не охватывает некоторые нестандартные системы управления зависимостями для других платформ.
Если инструменты и подсказки Crashlytics MCP не загружаются, то в качестве обходного пути вы можете вручную установить сервер Firebase MCP и использовать аргумент --only crashlytics для загрузки инструментов и подсказок Crashlytics MCP.
С помощью инструментов и подсказок MCP Firebase Crashlytics вы можете взаимодействовать с данными Crashlytics , используя инструменты разработки на базе ИИ с поддержкой MCP, такие как Gemini CLI, Claude Code или Cursor. Эти инструменты и подсказки MCP Crashlytics предоставляют вашему инструменту ИИ критически важный контекст, помогая вам управлять проблемами, расставлять приоритеты, отлаживать и устранять их.
После настройки сервера Firebase MCP вы можете использовать функции MCP для Crashlytics :
Управляемый рабочий процесс для определения приоритетов и устранения проблем
Отладка в свободной форме в режиме диалога
такое MCP? Протокол контекста модели (MCP) — это стандартизированный способ доступа инструментов ИИ к внешним инструментам и источникам данных.
Прежде чем начать: настройте сервер Firebase MCP
В этом разделе описывается базовая настройка сервера Firebase MCP, чтобы вы могли использовать специфичные для Crashlytics команды, подсказки и инструменты MCP (которые описаны далее на этой странице).
Предпосылки
Убедитесь, что ваша среда соответствует следующим требованиям:
Рабочая установка Node.js и npm. Установка Node.js автоматически устанавливает инструменты командной строки npm.
Ваш инструмент разработки на базе ИИ поддерживает интеграцию MCP.
Если вы работаете с проектом Unity, ознакомьтесь с часто задаваемыми вопросами о загрузке инструментов и подсказок Crashlytics MCP .
Настройте свой инструмент ИИ для использования сервера Firebase MCP
Gemini CLI
Рекомендуемый способ настройки Gemini CLI для использования сервера Firebase MCP — установка расширения Firebase для Gemini CLI :
gemini extensions install https://github.com/gemini-cli-extensions/firebase/Установка расширения Firebase автоматически настраивает сервер Firebase MCP, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
В качестве альтернативы вы можете настроить 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, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
Кроме того, вы можете настроить Gemini Code Assist на использование сервера Firebase MCP (но не файла контекста расширения Firebase), отредактировав или создав один из файлов конфигурации:
- В вашем проекте:
.gemini/settings.json - В вашем домашнем каталоге:
~/.gemini/settings.json
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Студия Firebase
Чтобы настроить Firebase Studio для использования сервера Firebase MCP, отредактируйте или создайте файл конфигурации: .idx/mcp.json .
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Клод
Клод Код
Чтобы настроить Claude Code для использования сервера Firebase MCP, выполните следующую команду в папке вашего приложения:
claude mcp add firebase npx -- -y firebase-tools@latest mcpПроверить установку можно, выполнив:
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 Editor, отредактируйте файл ~/.codeium/windsurf/mcp_config.json :
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Помимо базовой конфигурации, описанной выше, для каждого инструмента ИИ можно указать дополнительные параметры .
(Рекомендуется) Пошаговый рабочий процесс для определения приоритетов и устранения проблем с crashlytics:connect
Crashlytics предлагает гибкий и управляемый рабочий процесс, основанный на диалоговом взаимодействии, который поможет вам приоритизировать и устранять проблемы Crashlytics в вашем приложении. Например, ваш инструмент на основе искусственного интеллекта может выявлять проблемы, объяснять их, определять потенциальные пути решения и даже вносить изменения в код.
Этот управляемый рабочий процесс доступен с помощью команды crashlytics:connect MCP.
Доступ и использование команды

crashlytics:connect .Если вы еще этого не сделали, настройте сервер Firebase MCP , а затем запустите свой инструмент ИИ.
Запустите команду
crashlytics:connectMCP.Большинство инструментов ИИ предоставляют удобный способ доступа к этому рабочему процессу. Например, если вы используете Gemini CLI, выполните команду
/crashlytics:connectИспользуйте инструмент ИИ для определения приоритетов и устранения проблем Crashlytics , например:
- Просмотреть список приоритетных проблем.
- Устраните конкретную проблему, указав ее идентификатор или URL.
- Запросите дополнительную информацию о сбое.
- Спросите агента, как он обосновывает предполагаемую основную причину.
Отладка в свободной форме в режиме диалога
Хотя мы рекомендуем использовать crashlytics:connect для оптимальной отладки , вы также можете отлаживать проблемы, используя свободное общение с инструментом ИИ, имеющим доступ к инструментам MCP Crashlytics . Это особенно важно для инструментов ИИ, которые пока не поддерживают запросы 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, а не для непосредственного использования разработчиком-человеком. LLM решает, когда использовать эти инструменты MCP, основываясь на вашем взаимодействии с инструментом ИИ.
Управление проблемами 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 не предлагает явного способа управления объёмом данных, загружаемых в контекст, но мы предоставляем разумные рекомендации по умолчанию для модели.
Устранение неполадок и часто задаваемые вопросы
Сервер Firebase MCP пытается определить, использует ли кодовая база Crashlytics , проверяя установленные зависимости. Эта возможность пока не поддерживается для проектов Unity и не охватывает некоторые нестандартные системы управления зависимостями для других платформ.
Если инструменты и подсказки Crashlytics MCP не загружаются, то в качестве обходного пути вы можете вручную установить сервер Firebase MCP и использовать аргумент --only crashlytics для загрузки инструментов и подсказок Crashlytics MCP.
С помощью инструментов и подсказок MCP Firebase Crashlytics вы можете взаимодействовать с данными Crashlytics , используя инструменты разработки на базе ИИ с поддержкой MCP, такие как Gemini CLI, Claude Code или Cursor. Эти инструменты и подсказки MCP Crashlytics предоставляют вашему инструменту ИИ критически важный контекст, помогая вам управлять проблемами, расставлять приоритеты, отлаживать и устранять их.
После настройки сервера Firebase MCP вы можете использовать функции MCP для Crashlytics :
Управляемый рабочий процесс для определения приоритетов и устранения проблем
Отладка в свободной форме в режиме диалога
такое MCP? Протокол контекста модели (MCP) — это стандартизированный способ доступа инструментов ИИ к внешним инструментам и источникам данных.
Прежде чем начать: настройте сервер Firebase MCP
В этом разделе описывается базовая настройка сервера Firebase MCP, чтобы вы могли использовать специфичные для Crashlytics команды, подсказки и инструменты MCP (которые описаны далее на этой странице).
Предпосылки
Убедитесь, что ваша среда соответствует следующим требованиям:
Рабочая установка Node.js и npm. Установка Node.js автоматически устанавливает инструменты командной строки npm.
Ваш инструмент разработки на базе ИИ поддерживает интеграцию MCP.
Если вы работаете с проектом Unity, ознакомьтесь с часто задаваемыми вопросами о загрузке инструментов и подсказок Crashlytics MCP .
Настройте свой инструмент ИИ для использования сервера Firebase MCP
Gemini CLI
Рекомендуемый способ настройки Gemini CLI для использования сервера Firebase MCP — установка расширения Firebase для Gemini CLI :
gemini extensions install https://github.com/gemini-cli-extensions/firebase/Установка расширения Firebase автоматически настраивает сервер Firebase MCP, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
В качестве альтернативы вы можете настроить 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, а также содержит файл контекста, который может повысить производительность разработки приложений Gemini Firebase.
Кроме того, вы можете настроить Gemini Code Assist на использование сервера Firebase MCP (но не файла контекста расширения Firebase), отредактировав или создав один из файлов конфигурации:
- В вашем проекте:
.gemini/settings.json - В вашем домашнем каталоге:
~/.gemini/settings.json
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Студия Firebase
Чтобы настроить Firebase Studio для использования сервера Firebase MCP, отредактируйте или создайте файл конфигурации: .idx/mcp.json .
Если файл ещё не существует, создайте его, щёлкнув правой кнопкой мыши родительский каталог и выбрав «Новый файл» . Добавьте в файл следующее содержимое:
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Клод
Клод Код
Чтобы настроить Claude Code для использования сервера Firebase MCP, выполните следующую команду в папке вашего приложения:
claude mcp add firebase npx -- -y firebase-tools@latest mcpПроверить установку можно, выполнив:
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 Editor, отредактируйте файл ~/.codeium/windsurf/mcp_config.json :
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Помимо базовой конфигурации, описанной выше, для каждого инструмента ИИ можно указать дополнительные параметры .
(Рекомендуется) Пошаговый рабочий процесс для определения приоритетов и устранения проблем с crashlytics:connect
Crashlytics предлагает гибкий и управляемый рабочий процесс, основанный на диалоговом взаимодействии, который поможет вам приоритизировать и устранять проблемы Crashlytics в вашем приложении. Например, ваш инструмент на основе искусственного интеллекта может выявлять проблемы, объяснять их, определять потенциальные пути решения и даже вносить изменения в код.
Этот управляемый рабочий процесс доступен с помощью команды crashlytics:connect MCP.
Доступ и использование команды

crashlytics:connect .Если вы еще этого не сделали, настройте сервер Firebase MCP , а затем запустите свой инструмент ИИ.
Запустите команду
crashlytics:connectMCP.Большинство инструментов ИИ предоставляют удобный способ доступа к этому рабочему процессу. Например, если вы используете Gemini CLI, выполните команду
/crashlytics:connectИспользуйте инструмент ИИ для определения приоритетов и устранения проблем Crashlytics , например:
- Просмотреть список приоритетных проблем.
- Устраните конкретную проблему, указав ее идентификатор или URL.
- Запросите дополнительную информацию о сбое.
- Спросите агента, как он обосновывает предполагаемую основную причину.
Отладка в свободной форме в режиме диалога
Хотя мы рекомендуем использовать crashlytics:connect для оптимальной отладки , вы также можете отлаживать проблемы, используя свободное общение с инструментом ИИ, имеющим доступ к инструментам MCP Crashlytics . Это особенно важно для инструментов ИИ, которые пока не поддерживают запросы 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 для извлечения контекста проблемы и любых опубликованных примечаний к ней. Он также может извлечь примеры сбоев, чтобы продолжить расследование проблемы.
Документ расследования отладки
When debugging an issue, it's often helpful to maintain records for yourself or your team. Crashlytics offers this capability in the Firebase console, and your AI tool equipped with Crashlytics MCP tools can also help — for example: summarize an investigation, add a note with helpful metadata (like a link to a Jira or GitHub issue), or close an issue after it's fixed.
Here are some example prompts:
-
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 tool reference
The following tables list the Crashlytics MCP tools that are available via the Firebase MCP server.
After you've set up the Firebase MCP server , your AI tool can use these MCP tools to help you understand, debug, and manage issues. These MCP tools are used in both the crashlytics:connect guided workflow and in free-form conversations with your AI tool.
For the majority of use cases, these MCP tools are for LLM-use only and not for direct use by a human developer. The LLM decides when to use these MCP tools based on your interaction with your AI tool.
Manage Crashlytics issues
The following table describes the tools available to manage your Crashlytics issues.
| Название инструмента | Группа функций | Описание |
|---|---|---|
| crashlytics_create_note | крашлитики | Add a note to an issue from crashlytics. |
| crashlytics_delete_note | крашлитики | Delete a note from a Crashlytics issue. |
| crashlytics_update_issue | крашлитики | Use this to update the state of Crashlytics issue. |
Fetch Crashlytics data
The following table describes the tools available to get Crashlytics -related information about your apps.
| Название инструмента | Группа функций | Описание |
|---|---|---|
| crashlytics_get_issue | крашлитики | Gets data for a Crashlytics issue, which can be used as a starting point for debugging. |
| crashlytics_list_events | крашлитики | Use this to list the most recent events matching the given filters. Can be used to fetch sample crashes and exceptions for an issue, which will include stack traces and other data useful for debugging. |
| crashlytics_batch_get_events | крашлитики | Gets specific events by resource name. Can be used to fetch sample crashes and exceptions for an issue, which will include stack traces and other data useful for debugging. |
| crashlytics_list_notes | крашлитики | Use this to list all notes for an issue in Crashlytics. |
| crashlytics_get_top_issues | крашлитики | Use this to count events and distinct impacted users, grouped by issue . Groups are sorted by event count, in descending order. Only counts events matching the given filters. |
| crashlytics_get_top_variants | крашлитики | Counts events and distinct impacted users, grouped by issue variant . Groups are sorted by event count, in descending order. Only counts events matching the given filters. |
| crashlytics_get_top_versions | крашлитики | Counts events and distinct impacted users, grouped by version . Groups are sorted by event count, in descending order. Only counts events matching the given filters. |
| crashlytics_get_top_apple_devices | крашлитики | Counts events and distinct impacted users, grouped by apple device . Groups are sorted by event count, in descending order. Only counts events matching the given filters. Only relevant for iOS, iPadOS and MacOS applications. |
| crashlytics_get_top_android_devices | крашлитики | Counts events and distinct impacted users, grouped by android device . Groups are sorted by event count, in descending order. Only counts events matching the given filters. Only relevant for Android applications. |
| crashlytics_get_top_operating_systems | крашлитики | Counts events and distinct impacted users, grouped by operating system . Groups are sorted by event count, in descending order. Only counts events matching the given filters. |
Дополнительная информация
Как используются ваши данные
Data governance is determined by the AI-powered development tool that you use, and is subject to the terms defined by that AI tool.
Цены
Firebase doesn't charge you to use Crashlytics MCP tools and prompts or to fetch Crashlytics data from our public API.
Any cost is determined by the AI-powered development tool that you use, and could be determined by the volume of Crashlytics data that's used by the AI tool. Note that Firebase doesn't offer an explicit way to control how much data is loaded into context, but we do include sensible default guidance for the model.
Troubleshooting and FAQ
The Firebase MCP server attempts to recognize when a codebase is using Crashlytics by inspecting installed dependencies. This capability isn't yet supported for Unity projects and doesn't cover some non-standard dependency management systems for other platforms.
If Crashlytics MCP tools and prompts aren't loading for you, then as a workaround, you can install the Firebase MCP server manually and use the --only crashlytics argument to load Crashlytics MCP tools and prompts.