С помощью инструментов и запросов Firebase Crashlytics MCP вы можете взаимодействовать с данными Crashlytics, используя ИИ-инструменты для разработки с поддержкой MCP, такие как Antigravity, Claude Code или Cursor. Эти Crashlyticsинструменты и запросы MCP предоставляют ИИ-инструменту важную информацию, которая помогает управлять проблемами, определять их приоритет, отлаживать и устранять их.
После того как вы настроите MCP-сервер Firebase, вы сможете использовать функции MCP для Crashlytics:
Пошаговое руководство по приоритизации и устранению неполадок
Что такое MCP? Протокол контекста модели (MCP) – это стандартизированный способ доступа ИИ-инструментов к внешним инструментам и источникам данных.
Подготовка: настройте сервер Firebase MCP
В этом разделе описана базовая настройка сервера MCP Firebase, которая позволяет использовать команды, запросы и инструменты MCP, относящиеся к Crashlytics (все они описаны ниже на этой странице).
Требования
Убедитесь, что ваша среда соответствует следующим требованиям:
Установленная и работающая версия Node.js и npm. При установке Node.js автоматически устанавливаются инструменты командной строки npm.
Ваш инструмент разработки на основе ИИ поддерживает интеграцию с MCP.
Если вы работаете с проектом Unity, ознакомьтесь с часто задаваемыми вопросами о загрузке Crashlytics инструментов и запросов MCP.
Как настроить ИИ-инструмент для использования MCP-сервера Firebase
Antigravity
Чтобы настроить Antigravity для использования MCP-сервера Firebase:
- В Antigravity нажмите на меню на панели агента > Серверы MCP.
- Выберите Firebase > Установить.
Это автоматически обновит файл mcp_config.json, который можно посмотреть, нажав Управление серверами MCP в верхней части панели магазина MCP > Посмотреть необработанную конфигурацию. В файле будет следующее содержимое:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Вариант 1. Установите плагин (рекомендуется)
Самый простой способ настроить сервер Firebase MCP в Claude Code – установить официальный плагин Firebase:
Добавьте каталог Firebase для плагинов Claude:
claude plugin marketplace add firebase/firebase-toolsУстановите плагин Claude для Firebase:
claude plugin install firebase@firebaseПроверьте установку:
claude plugin marketplace list
Вариант 2. Настройте MCP-сервер вручную
Вы также можете настроить сервер MCP Firebase вручную:
Выполните следующую команду в папке приложения:
claude mcp add firebase npx -- -y firebase-tools@latest mcpПроверьте установку:
claude mcp listНа нем должны быть указаны:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Чтобы настроить Claude Desktop на использование сервера MCP Firebase, измените файл claude_desktop_config.json. Вы можете открыть или создать этот файл в меню Claude > Настройки. Откройте вкладку Разработчик и нажмите Изменить конфигурацию.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Курсор
Вариант 1. Плагин Marketplace (рекомендуется)
Установите плагин Firebase из Cursor Marketplace. При этом автоматически настраивается MCP-сервер и предоставляется доступ к навыкам агента Firebase.
Вариант 2. Настройка MCP одним нажатием
Если вы хотите добавить MCP-сервер только в глобальную конфигурацию, нажмите кнопку ниже.
Вариант 3. Настройка вручную
Если вы хотите настроить сервер для определенного проекта или изменить настройки вручную, обновите файл mcp.json:
- Чтобы изменить настройки для определенного проекта, нажмите
.cursor/mcp.json. - Для всех проектов (глобально) – изменить
~/.cursor/mcp.json
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Cline
Чтобы настроить Cline на использование MCP-сервера Firebase, измените файл cline_mcp_settings.json. Вы можете открыть или создать этот файл, нажав на значок MCP-серверов в верхней части панели Cline, а затем на кнопку Настроить MCP-серверы.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
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 проблемы в приложении. Например, ИИ-инструмент может находить проблемы, объяснять их, предлагать варианты решения и даже вносить изменения в код.
Этот рабочий процесс доступен с помощью команды MCP crashlytics:connect.
Как получить доступ к команде и использовать ее
Если вы ещё этого не сделали, настройте MCP-сервер Firebase, а затем запустите инструмент на основе ИИ.
Выполните команду
crashlytics:connectMCP.Большинство ИИ-инструментов позволяют удобно получить доступ к этому рабочему процессу. Если ваш агент не поддерживает команды MCP, рекомендуем использовать отладку в свободной форме.
Используйте ИИ-инструмент, чтобы определить приоритет и устранить проблемы с Crashlytics, например:
- Посмотреть список проблем с приоритетами.
- Укажите идентификатор или URL, чтобы отладить определенную проблему.
- Запросить дополнительную информацию о сбое.
- Спросите у агента, почему он предложил именно эту основную причину.
Отладка в свободной форме
Мы рекомендуем использовать crashlytics:connect для отладки, но вы также можете использовать для этого ИИ-инструмент, у которого есть доступ к инструментам Crashlytics MCP. Это особенно важно для инструментов на основе ИИ, которые пока не поддерживают запросы MCP (часто называемые командами со слешем или пользовательскими командами).
После того как вы настроите MCP-сервер Firebase, попробуйте выполнить некоторые из приведенных ниже примеров.
Как получить информацию о проблеме и сбое
Если у вашего ИИ-инструмента есть доступ к инструментам 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
В таблицах ниже перечислены инструменты MCP Crashlytics, доступные через сервер MCP Firebase.
После того как вы настроите MCP-сервер Firebase, ваш ИИ-инструмент сможет использовать инструменты MCP, чтобы помогать вам выявлять и устранять проблемы, а также управлять ими. Эти инструменты MCP используются как в пошаговом рабочем процессе crashlytics:connect, так и в свободных беседах с ИИ-инструментом.
В большинстве случаев эти инструменты MCP предназначены для использования только большими языковыми моделями, а не для прямого использования разработчиками. Когда использовать эти инструменты, решает LLM на основе вашего взаимодействия с ИИ-инструментом.
Устранение проблем с Crashlytics
В таблице ниже описаны инструменты, которые помогут вам устранить проблемы с Crashlytics.
| Название инструмента | Группа функций | Описание |
|---|---|---|
| crashlytics_create_note | crashlytics | Как добавить примечание к проблеме из Crashlytics |
| crashlytics_delete_note | crashlytics | Удалять заметки из проблем Crashlytics. |
| crashlytics_update_issue | crashlytics | Используйте этот параметр, чтобы изменить статус проблемы Crashlytics. |
Как получить данные Crashlytics
В таблице ниже описаны инструменты, с помощью которых можно получить информацию о соответствии приложений требованиям Crashlytics.
| Название инструмента | Группа функций | Описание |
|---|---|---|
| crashlytics_get_issue | crashlytics | Получает данные о проблеме Crashlytics, которые можно использовать в качестве отправной точки для отладки. |
| crashlytics_list_events | crashlytics | Используйте этот метод, чтобы получить список последних событий, соответствующих заданным фильтрам. Позволяет получить примеры сбоев и исключений для проблемы, включая трассировки стека и другие данные, полезные для отладки. |
| crashlytics_batch_get_events | crashlytics | Получает определенные события по названию ресурса. Позволяет получить примеры сбоев и исключений для проблемы, включая трассировки стека и другие данные, полезные для отладки. |
| crashlytics_list_notes | crashlytics | Используйте этот параметр, чтобы перечислить все заметки для проблемы в Crashlytics. |
| crashlytics_get_report | crashlytics | Используйте этот метод, чтобы запрашивать у Crashlytics отчеты с числовыми данными. В результате вы получите агрегированные данные о количестве событий и затронутых пользователей, сгруппированные по параметру, подходящему для отчета. |
Дополнительная информация
Как мы используем ваши данные
Управление данными определяется ИИ-инструментом, который вы используете, и регулируется условиями, заданными в этом инструменте.
Цены
Firebase не взимает плату за использование инструментов и запросов Crashlytics MCP или за получение данных Crashlytics из нашего общедоступного API.
Стоимость определяется используемым инструментом разработки на основе ИИ и может зависеть от объема данных Crashlytics, которые используются этим инструментом. Обратите внимание, что в Firebase нет явного способа контролировать объем данных, загружаемых в контекст, но мы включаем в модель разумные рекомендации по умолчанию.