Mengintegrasikan layanan Firebase menggunakan bantuan AI

Sederhanakan penyiapan Firebase untuk aplikasi web dengan menggunakan alat pengembangan berteknologi AI seperti Antigravity, Claude Code, Codex, dan Cursor. Dengan menggunakan keahlian agen Firebase secara bersamaan dengan CLI Firebase dan server Firebase MCP, Anda dapat mengubah agen coding AI menjadi pakar Firebase khusus yang dapat menulis kode, mengonfigurasi Firebase Security Rules, dan mengelola resource aktif.

Panduan ini membahas penggunaan agen coding AI untuk membantu menyiapkan Cloud Firestore, Authentication, dan Firebase Hosting untuk aplikasi web. Segera kembali untuk mengetahui informasi tentang aplikasi iOS, Android, dan Flutter.

Mengapa menggunakan keahlian dan alat agen Firebase?

Model AI umum sering kali mengalami masalah dengan konfigurasi project tertentu atau informasi yang sudah usang. Toolkit ini menjembatani kesenjangan tersebut:

  • Keahlian agen Firebase: Keahlian memberikan keahlian domain kepada agen coding. Mereka menyediakan dokumentasi terbaru dan alur kerja yang optimal sehingga agen mengetahui cara yang benar dan direkomendasikan Firebase untuk menyusun arsitektur Anda.
  • Server Firebase MCP: Server MCP memberikan konteks dan akses kepada agen coding. API ini menetapkan protokol standar bagi agen untuk memeriksa secara terprogram resource project aktif, file lokal, dan konfigurasi Anda.
  • Firebase CLI: Antarmuka command line memberikan kemampuan yang dapat ditindaklanjuti kepada agen coding. Ini adalah alat eksekusi yang digunakan agen untuk melakukan tugas berat seperti menginisialisasi database, mengelola konfigurasi autentikasi pengguna, dan men-deploy kode atas nama Anda.

Menggunakan keahlian agen Firebase bersama Firebase CLI dan server Firebase MCP memberi agen pengodean AI Anda kemampuan tambahan:

  • Ambil tindakan: Lakukan lebih dari sekadar menulis kode. Agen Anda dapat menginisialisasi layanan, mengelola Authentication pengguna, men-deploy Firebase Security Rules baru, dan bekerja langsung dengan data Cloud Firestore Anda.
  • Selalu dapatkan info terbaru: Gunakan perintah resmi yang mengetahui versi untuk memandu agen Anda menyelesaikan tugas penyiapan.
  • Meningkatkan akurasi: Akses lingkungan dan skema project Anda untuk memberikan bantuan yang lebih relevan dan akurat.
  • Mengurangi biaya token: Kemampuan agen memuat dokumentasi mendetail hanya saat tugas tertentu memerlukannya, sehingga meminimalkan overhead sesi.

Layanan Firebase mana yang dapat dibantu oleh alat dan keahlian agen?

Panduan ini berfokus terutama pada cara kerja keahlian agen, CLI Firebase, dan server Firebase MCP bersama-sama untuk membantu Anda menyiapkan layanan dan fitur ini dengan cepat:

  • Cloud Firestore: Menyediakan database NoSQL.
  • Authentication: Siapkan login pengguna yang aman.
  • Firebase Security Rules: Buat dan sempurnakan Security Rules untuk aplikasi Anda.
  • Firebase Hosting: Siapkan project Anda untuk deployment aplikasi web statis.

Untuk mengetahui daftar lengkap hal yang tersedia, jelajahi daftar lengkap keahlian agen Firebase.

Alur kerja umum

Langkah-langkah berikut menjelaskan alur kerja umum tentang cara menggunakan keahlian agen Firebase untuk menyiapkan dan menggunakan layanan Firebase di aplikasi web. Di balik layar, keahlian agen menggunakan CLI Firebase dan server MCP Firebase untuk menyelesaikan tugas ini.

Langkah 1: Instal keahlian agen Firebase

Dalam sebagian besar kasus, Anda dapat menginstal keahlian agen Firebase di editor pilihan Anda dengan satu perintah:

Antigravity

Keahlian agen Firebase disertakan sebagai salah satu paket integrasi Build with Google untuk Antigravity. Anda dapat mengaktifkan paket ini untuk akses tingkat global di dua titik:

  • Selama proses aktivasi: Centang kotak untuk stack Firebase.
  • Di setelan: Buka Setelan > Penyesuaian. Di bagian Build with Google Plugins, klik Customize, lalu klik Download untuk integrasi Firebase.

Jika Anda lebih memilih akses level project, jalankan perintah berikut di direktori project Anda:

npx skills add firebase/agent-skills --agent=antigravity

Claude Code

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Codex

npx skills add firebase/agent-skills --agent=codex

Kursor

Anda dapat menginstal keahlian agen Firebase langsung dari Cursor Marketplace atau dengan menjalankan perintah berikut di terminal:

npx skills add firebase/agent-skills --agent=cursor

Agen lainnya

npx skills add firebase/agent-skills

Langkah 2: Hubungkan ke server MCP Firebase

Meskipun banyak keahlian agen Firebase menggunakan CLI Firebase untuk tugas, sebaiknya hubungkan agen coding AI Anda ke server MCP Firebase. Koneksi ini meningkatkan kemampuan agen Anda untuk berinteraksi dengan lingkungan Firebase Anda, sehingga memberikan integrasi dan akses yang lebih dalam.

Metode yang didukung AI

Dalam sebagian besar kasus, Anda dapat meminta agen coding AI untuk menyiapkan server MCP Firebase. Namun, jika mengalami kesulitan atau Anda tidak melihat server Firebase MCP tercantum, beralihlah ke Metode manual.

Metode manual

Antigravity

Untuk mengonfigurasi Antigravity agar menggunakan server Firebase MCP:

  1. Di Antigravity, klik menu di panel Agent > MCP Servers.
  2. Pilih Firebase > Install.

Tindakan ini akan secara otomatis mengupdate file mcp_config.json Anda, yang dapat Anda lihat dengan mengklik Manage MCP Servers di bagian atas panel MCP Store > View raw config, dengan konten berikut:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "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

  • Opsi 1: Menginstal melalui plugin (Direkomendasikan)

    Cara termudah untuk menyiapkan server Firebase MCP di Claude Code adalah dengan menginstal plugin Firebase resmi:

    1. Tambahkan marketplace Firebase untuk plugin Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Instal plugin Claude untuk Firebase:

      claude plugin install firebase@firebase
    3. Verifikasi penginstalannya:

      claude plugin marketplace list
  • Opsi 2: Mengonfigurasi server MCP secara manual

    Atau, Anda dapat mengonfigurasi server Firebase MCP secara manual:

    1. Jalankan perintah berikut di folder aplikasi Anda:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Verifikasi penginstalannya:

      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

Opsi 1: Plugin Marketplace (direkomendasikan)

Instal plugin Firebase dari Cursor Marketplace. Tindakan ini akan otomatis mengonfigurasi server MCP dan memberikan akses ke keahlian agen Firebase.

Opsi 2: Penyiapan MCP sekali klik

Jika Anda hanya ingin menambahkan server MCP ke konfigurasi global, klik tombol berikut:

Menginstal Server MCP

Opsi 3: Konfigurasi manual

Jika Anda lebih suka mengonfigurasi server untuk project tertentu atau ingin mengedit setelan secara manual, perbarui file mcp.json:

  • Untuk project tertentu, edit .cursor/mcp.json
  • Untuk semua project (global), edit ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

VS Code Copilot

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"]
  }
}

Langkah 3: Lakukan inisialisasi layanan Firebase

Setelah keahlian dan alat agen disiapkan, Anda kini dapat menggunakan bahasa alami agar agen coding AI Anda menyiapkan Cloud Firestore, Authentication, dan Firebase Hosting.

  1. Minta agen Anda untuk menyiapkan layanan. Misalnya, Anda dapat menggunakan perintah seperti ini:

    • Siapkan Cloud Firestore sebagai database untuk aplikasi ini.
    • Buat halaman login menggunakan Authentication dan perbarui Security Rules untuk memastikan hanya pengguna yang berwenang yang dapat membaca dan menulis data mereka sendiri.
    • Siapkan Firebase Hosting dan deploy aplikasi ke produksi.
  2. Tinjau informasi apa pun dan ikuti langkah-langkah terpandu yang mungkin diberikan agen Anda, seperti:

    1. Rencana: Agen Anda mengusulkan strategi berdasarkan codebase yang ada.
    2. Menghubungkan: Agen Anda menautkan kode lokal Anda ke project Firebase yang ada atau membantu Anda membuat project Firebase baru.
    3. Menginisialisasi resource: Agen Anda menambahkan library dan konfigurasi Firebase yang diperlukan ke codebase Anda.
    4. Memperbarui file: Agen Anda membuat dan memperbarui file yang diperlukan, seperti firestore.rules (untuk menentukan siapa yang dapat membaca, menulis, atau membuat kueri data dalam database Anda) atau firebase.json (untuk memberi tahu Firebase CLI layanan mana yang akan di-deploy dan cara mengonfigurasinya).
    5. Mengeksekusi: Agen akan memandu Anda melalui langkah-langkah konfigurasi atau deployment tambahan.

Tips umum untuk memberikan perintah pada agen coding AI

Untuk mendapatkan hasil maksimal dari agen coding AI Anda, terutama saat bekerja dengan integrasi multifaset seperti Firebase, perlakukan interaksi sebagai kolaborasi, bukan perintah sekali jalan.

Berikan informasi yang spesifik dan konteks

Meskipun server MCP Firebase memberikan konteks yang signifikan tentang project Anda kepada agen, perintah bahasa alami yang jelas dan spesifik akan memberikan hasil terbaik. Hindari permintaan yang tidak jelas.

  • Tidak jelas (Vague): "Perbaiki error database."
  • Spesifik: "Saya mendapatkan error 'permission denied' saat mencoba menulis ke koleksi 'users' di Cloud Firestore. Tinjau firestore.rules saya dan sarankan perbaikan yang memungkinkan pengguna terautentikasi menulis ke dokumen mereka sendiri."

Lakukan iterasi dan penyempurnaan

Agen coding AI jarang menghasilkan kode yang sempurna pada percobaan pertama untuk tugas yang kompleks. Jika jawaban yang diberikan kurang tepat, lanjutkan percakapan:

  • Berikan pesan error: Tempelkan kembali error terminal atau log konsol ke dalam chat.
  • Minta penyesuaian: "Kode tersebut menggunakan SDK v8 yang lebih lama. Tulis ulang menggunakan Firebase SDK modular v9."
  • Minta penjelasan: "Jelaskan cara Firebase Security Rules tersebut melindungi data pengguna."

Verifikasi sebelum Anda mengeksekusi

Agen coding AI sangat canggih, tetapi dapat membuat kesalahan atau "berhalusinasi" (menciptakan fungsi atau layanan yang namanya salah).

  • Tinjau kode: Selalu baca kode yang dihasilkan, terutama Firebase Security Rules dan file konfigurasi (seperti firebase.json), sebelum men-deploy ke produksi.
  • Menguji secara lokal: Jika memungkinkan, minta agen untuk membantu Anda menguji perubahan secara lokal sebelum menayangkannya.

Menggunakan koneksi MCP

Karena server MCP Firebase memberikan visibilitas langsung ke struktur project Anda, Anda dapat mereferensikan file tertentu untuk mendapatkan saran penerapan yang disesuaikan.

  • Contoh: "Lihat file src/web/index.html saya dan tunjukkan tempat untuk menambahkan skrip inisialisasi Firebase standar."

Langkah berikutnya