Помощь ИИ для 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-сервер

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

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

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

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

,


С помощью инструментов и подсказок 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-сервер

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

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

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

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

,


С помощью инструментов и подсказок 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-сервер

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

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

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

Документ расследования отладки

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