Помощь ИИ для 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
    }
  }
}

Курсор

Чтобы настроить Cursor для использования сервера Firebase MCP, отредактируйте либо файл .cursor/mcp.json (чтобы настроить только определенный проект), либо файл ~/.cursor/mcp.json (чтобы сделать сервер MCP доступным во всех проектах):

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

Доступ и использование команды

Gemini CLI с использованием команды crashlytics:connect
Используйте инструмент искусственного интеллекта, например Gemini CLI, с управляемым рабочим процессом crashlytics:connect .
  1. Если вы еще этого не сделали, настройте сервер Firebase MCP , а затем запустите свой инструмент ИИ.

  2. Запустите команду crashlytics:connect MCP.

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

  3. Используйте инструмент ИИ для определения приоритетов и устранения проблем 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 не предлагает явного способа управления объёмом данных, загружаемых в контекст, но мы предоставляем разумные рекомендации по умолчанию для модели.

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