Bantuan AI untuk Crashlytics melalui MCP

Eksperimental: Fitur MCP untuk Crashlytics bersifat Eksperimental, yang berarti fitur tersebut tidak tunduk pada SLA atau kebijakan penghentian layanan apa pun dan dapat berubah sehingga tidak kompatibel dengan versi sebelumnya.

Dengan alat dan perintah MCP Firebase Crashlytics, Anda dapat berinteraksi dengan data Crashlytics menggunakan alat pengembangan berteknologi AI yang kompatibel dengan MCP, seperti Gemini CLI, Claude Code, atau Cursor. Alat dan perintah MCP Crashlytics ini memberikan konteks penting ke alat AI Anda untuk membantu Anda mengelola, memprioritaskan, men-debug, dan memperbaiki masalah.

Setelah menyiapkan server MCP Firebase, Anda dapat menggunakan fitur MCP untuk Crashlytics:

Alur kerja terpandu untuk memprioritaskan dan memperbaiki masalah

Penelusuran kesalahan percakapan bentuk bebas

Penting: Alat dan perintah MCP Crashlytics yang tersedia saat ini adalah untuk digunakan dengan aplikasi yang sudah menggunakan Crashlytics.

Apa itu MCP? Model Context Protocol (MCP) adalah cara standar bagi alat AI untuk mengakses alat dan sumber data eksternal.

---

Sebelum Anda memulai: Siapkan server Firebase MCP

Bagian ini menjelaskan penyiapan dasar server Firebase MCP sehingga Anda dapat menggunakan perintah, perintah, dan alat MCP khusus Crashlytics (yang semuanya dijelaskan nanti di halaman ini).

Prasyarat

Pastikan lingkungan Anda memenuhi persyaratan berikut:

• Penginstalan Node.js dan npm yang berfungsi. Menginstal Node.js akan otomatis menginstal alat perintah npm.

• Alat pengembangan yang didukung AI mendukung integrasi MCP.

Jika Anda menggunakan project Unity, tinjau FAQ tentang memuat alat dan perintah MCP Crashlytics.

Mengonfigurasi alat AI Anda untuk menggunakan server Firebase MCP

Gemini CLI

Cara yang direkomendasikan untuk menyiapkan Gemini CLI agar dapat menggunakan server Firebase MCP adalah dengan menginstal ekstensi Firebase untuk Gemini CLI:

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

Setelah ekstensi Firebase diinstal, server Firebase MCP akan otomatis dikonfigurasi. Selain itu, ekstensi tersebut juga dilengkapi file konteks yang dapat meningkatkan performa pengembangan aplikasi Firebase dari Gemini.

Anda juga dapat mengonfigurasi Gemini CLI agar menggunakan server Firebase MCP (tetapi bukan file konteks ekstensi Firebase), dengan mengedit atau membuat salah satu file konfigurasi:

• Di project Anda: .gemini/settings.json
• Di direktori utama Anda: ~/.gemini/settings.json

Jika file belum ada, buat dengan mengklik kanan direktori induk dan memilih New file. Tambahkan konten berikut ke file:

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

Gemini Code Assist

Cara yang direkomendasikan untuk menyiapkan Gemini Code Assist agar dapat menggunakan server Firebase MCP adalah dengan menginstal ekstensi Firebase untuk Gemini CLI:

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

Setelah ekstensi Firebase diinstal, server Firebase MCP akan otomatis dikonfigurasi. Selain itu, ekstensi tersebut juga dilengkapi file konteks yang dapat meningkatkan performa pengembangan aplikasi Firebase dari Gemini.

Anda juga dapat mengonfigurasi Gemini Code Assist agar menggunakan server Firebase MCP (tetapi bukan file konteks ekstensi Firebase), dengan mengedit atau membuat salah satu file konfigurasi:

• Di project Anda: .gemini/settings.json
• Di direktori utama Anda: ~/.gemini/settings.json

Jika file belum ada, buat dengan mengklik kanan direktori induk dan memilih New file. Tambahkan konten berikut ke file:

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

Firebase Studio

Untuk mengonfigurasi Firebase Studio agar menggunakan server Firebase MCP, edit atau buat file konfigurasi: .idx/mcp.json

Jika file belum ada, buat dengan mengklik kanan direktori induk dan memilih New file. Tambahkan konten berikut ke file:

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

Claude

Claude Code

Untuk mengonfigurasi Claude Code agar menggunakan server MCP Firebase, jalankan perintah berikut di folder aplikasi Anda:

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

Anda dapat memverifikasi penginstalan dengan menjalankan:

claude mcp list

Tulisan yang akan muncul:

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

Claude Desktop

Untuk mengonfigurasi Claude Desktop agar menggunakan server Firebase MCP, edit file claude_desktop_config.json. Anda dapat membuka atau membuat file ini dari menu Claude > Settings. Pilih tab Developer, lalu klik Edit Config.

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

Cline

Untuk mengonfigurasi Cline agar menggunakan server Firebase MCP, edit file cline_mcp_settings.json. Anda dapat membuka atau membuat file ini dengan mengklik ikon Server MCP di bagian atas panel Cline, lalu mengklik tombol Configure MCP Servers.

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

Kursor

Untuk mengonfigurasi Cursor agar menggunakan server Firebase MCP, edit file .cursor/mcp.json (untuk mengonfigurasi project tertentu saja) atau file ~/.cursor/mcp.json (untuk menyediakan server MCP di semua project):

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

Copilot di VS Code

Untuk mengonfigurasi satu project, edit file .vscode/mcp.json di ruang kerja Anda:

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

Agar server tersedia di setiap project yang Anda buka, edit setelan pengguna Anda, misalnya:

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

Windsurf

Untuk mengonfigurasi Windsurf Editor, edit file ~/.codeium/windsurf/mcp_config.json:

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

Selain konfigurasi dasar yang dijelaskan di atas untuk setiap alat AI, Anda dapat menentukan parameter opsional.

Catatan: Saat melakukan panggilan alat MCP, server Firebase MCP menggunakan kredensial pengguna yang sama yang mengizinkan Firebase CLI di lingkungan tempat server tersebut berjalan. Bergantung pada lingkungannya, hal ini dapat berupa pengguna yang login atau Kredensial Default Aplikasi.

---

(Direkomendasikan) Alur kerja terpandu untuk memprioritaskan dan memperbaiki masalah dengan crashlytics:connect

Crashlytics menyediakan alur kerja terpandu yang bersifat percakapan dan fleksibel untuk membantu Anda memprioritaskan dan memperbaiki masalah Crashlytics di aplikasi Anda. Misalnya, alat AI Anda dapat mengambil masalah, menjelaskan masalah, mengidentifikasi potensi perbaikan, dan bahkan melakukan perubahan kode untuk Anda.

Alur kerja terpandu ini tersedia melalui perintah MCP crashlytics:connect.

Catatan: Tidak semua alat AI mendukung perintah MCP seperti ini, tetapi Anda tetap dapat men-debug masalah menggunakan percakapan bentuk bebas.

Mengakses dan menggunakan perintah

Gunakan alat AI, seperti Gemini CLI, dengan alur kerja terpandu crashlytics:connect.

1. Jika Anda belum melakukannya, siapkan server Firebase MCP, lalu mulai alat AI Anda.

2. Jalankan perintah MCP crashlytics:connect.

   Sebagian besar alat AI menyediakan cara untuk mengakses alur kerja ini dengan mudah. Misalnya, jika Anda menggunakan Gemini CLI, jalankan perintah garis miring /crashlytics:connect

3. Gunakan alat AI Anda untuk membantu memprioritaskan dan memperbaiki masalah Crashlytics, misalnya:

   • Lihat daftar masalah yang diprioritaskan.
   • Men-debug masalah tertentu dengan memberikan ID atau URL-nya.
   • Minta informasi selengkapnya tentang kecelakaan.
   • Tanyakan alasan agen untuk penyebab utama yang disarankan.

---

Proses debug percakapan bentuk bebas

Meskipun sebaiknya gunakan crashlytics:connect untuk pengalaman proses debug terbaik, Anda juga dapat melakukan proses debug masalah menggunakan percakapan bentuk bebas dengan alat AI yang memiliki akses ke alat MCP Crashlytics. Hal ini sangat penting untuk alat AI yang belum mendukung perintah MCP (sering disebut sebagai perintah garis miring atau perintah kustom).

Setelah menyiapkan server Firebase MCP, coba beberapa contoh berikut.

Mengambil konteks masalah dan error

Jika alat AI Anda memiliki akses ke alat MCP Crashlytics, alat tersebut dapat mengambil data masalah Crashlytics penting seperti jumlah pengguna dan peristiwa, stacktrace, metadata, dan informasi versi aplikasi.

Berikut adalah beberapa contoh perintahnya:

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

  • Untuk menjawab pertanyaan ini, alat AI Anda kemungkinan akan membaca kode Anda untuk memahami tempat login terjadi dan menggunakan berbagai alat MCP Crashlytics untuk mengambil data masalah. Kemudian, alat AI Anda akan mencoba menentukan apakah ada masalah dalam versi terbaru yang terkait dengan alur login.

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

  • Untuk menjawab pertanyaan ini, alat AI Anda akan menggunakan berbagai alat MCP untuk mengambil konteks masalah dan catatan apa pun yang diposting ke masalah tersebut.Crashlytics Fitur ini juga dapat mengambil contoh error untuk melanjutkan penyelidikan masalah.

Mendokumentasikan investigasi proses debug

Saat melakukan proses debug masalah, sering kali berguna untuk menyimpan catatan untuk diri sendiri atau tim Anda. Crashlytics menawarkan kemampuan ini di konsol Firebase, dan alat AI Anda yang dilengkapi dengan alat MCP Crashlytics juga dapat membantu — misalnya: meringkas penyelidikan, menambahkan catatan dengan metadata yang berguna (seperti link ke masalah Jira atau GitHub), atau menutup masalah setelah diperbaiki.

Berikut adalah beberapa contoh perintahnya:

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

---

Referensi alat MCP Crashlytics

Tabel berikut mencantumkan alat MCP Crashlytics yang tersedia melalui server MCP Firebase.

Setelah Anda menyiapkan server Firebase MCP, alat AI Anda dapat menggunakan alat MCP ini untuk membantu Anda memahami, men-debug, dan mengelola masalah. Alat MCP ini digunakan dalam alur kerja yang dipandu crashlytics:connect dan dalam percakapan bentuk bebas dengan alat AI Anda.

Untuk sebagian besar kasus penggunaan, alat MCP ini hanya untuk penggunaan LLM dan bukan untuk penggunaan langsung oleh developer manusia. LLM akan memutuskan kapan harus menggunakan alat MCP ini berdasarkan interaksi Anda dengan alat AI Anda.

Catatan: Anda juga dapat melihat informasi ini menggunakan perintah: npx firebase-tools@latest mcp --generate-tool-list

Mengelola masalah Crashlytics

Tabel berikut menjelaskan alat yang tersedia untuk mengelola masalah Crashlytics Anda.

Nama Alat	Grup Fitur	Deskripsi
crashlytics_create_note	crashlytics	Menambahkan catatan ke suatu masalah dari Crashlytics.
crashlytics_delete_note	crashlytics	Menghapus catatan dari masalah Crashlytics.
crashlytics_update_issue	crashlytics	Gunakan alat ini untuk memperbarui status masalah Crashlytics.

Mengambil data Crashlytics

Tabel berikut menjelaskan alat yang tersedia untuk mendapatkan informasi terkait Crashlytics tentang aplikasi Anda.

Nama Alat	Grup Fitur	Deskripsi
crashlytics_get_issue	crashlytics	Mendapatkan data untuk masalah Crashlytics, yang dapat digunakan sebagai titik awal untuk proses debug.
crashlytics_list_events	crashlytics	Gunakan alat ini untuk menampilkan daftar peristiwa terbaru yang cocok dengan filter yang ditentukan. Dapat digunakan untuk mengambil sampel error dan pengecualian untuk suatu masalah, yang akan mencakup stack trace dan data lain yang berguna untuk proses debug.
crashlytics_batch_get_events	crashlytics	Mendapatkan peristiwa tertentu berdasarkan nama resource. Dapat digunakan untuk mengambil sampel error dan pengecualian untuk suatu masalah, yang akan mencakup stack trace dan data lain yang berguna untuk proses debug.
crashlytics_list_notes	crashlytics	Gunakan alat ini untuk menampilkan daftar semua catatan untuk suatu masalah di Crashlytics.
crashlytics_get_top_issues	crashlytics	Gunakan alat ini untuk menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut masalah. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan.
crashlytics_get_top_variants	crashlytics	Menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut varian masalah. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan.
crashlytics_get_top_versions	crashlytics	Menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut versi. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan.
crashlytics_get_top_apple_devices	crashlytics	Menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut perangkat Apple. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan. Hanya relevan untuk aplikasi iOS, iPadOS, dan MacOS.
crashlytics_get_top_android_devices	crashlytics	Menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut perangkat Android. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan. Hanya relevan untuk aplikasi Android.
crashlytics_get_top_operating_systems	crashlytics	Menghitung peristiwa dan pengguna unik yang terpengaruh, yang dikelompokkan menurut sistem operasi. Grup diurutkan berdasarkan jumlah peristiwa, dari yang paling banyak ke paling sedikit. Hanya menghitung peristiwa yang cocok dengan filter yang ditentukan.

---

Informasi tambahan

Cara data Anda digunakan

Tata kelola data ditentukan oleh alat pengembangan yang didukung AI yang Anda gunakan, dan tunduk pada persyaratan yang ditentukan oleh alat AI tersebut.

Harga

Firebase tidak mengenakan biaya kepada Anda untuk menggunakan alat dan perintah MCP Crashlytics atau untuk mengambil data Crashlytics dari API publik kami.

Biaya apa pun ditentukan oleh alat pengembangan yang didukung AI yang Anda gunakan, dan dapat ditentukan oleh volume data Crashlytics yang digunakan oleh alat AI. Perhatikan bahwa Firebase tidak menawarkan cara eksplisit untuk mengontrol jumlah data yang dimuat ke dalam konteks, tetapi kami menyertakan panduan default yang wajar untuk model.

Pemecahan masalah dan pertanyaan umum (FAQ)

Crashlytics Alat dan perintah MCP tidak dimuat

Server Firebase MCP mencoba mengenali saat codebase menggunakan Crashlytics dengan memeriksa dependensi yang diinstal. Kemampuan ini belum didukung untuk project Unity dan tidak mencakup beberapa sistem pengelolaan dependensi non-standar untuk platform lain.

Jika alat dan perintah MCP Crashlytics tidak dimuat untuk Anda, sebagai solusi sementara, Anda dapat menginstal server Firebase MCP secara manual dan menggunakan argumen --only crashlytics untuk memuat alat dan perintah MCP Crashlytics.