Mengintegrasikan layanan Firebase menggunakan bantuan AI

Sederhanakan penyiapan Firebase untuk aplikasi web menggunakan alat pengembangan didukung AI seperti Antigravity, Claude Code, Codex, dan Cursor. Dengan menggunakan keahlian agen Firebase bersama Firebase CLI 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, Firebase Authentication, dan Firebase Hosting untuk aplikasi web. Periksa kembali segera untuk mengetahui informasi tentang aplikasi iOS, Android, dan Flutter.

Mengapa menggunakan keahlian dan alat agen Firebase?

Agen coding AI sering kali kesulitan dengan konfigurasi project tertentu atau informasi yang sudah tidak berlaku. Toolkit ini menjembatani kesenjangan tersebut dengan menggabungkan petunjuk khusus (keahlian agen) dengan dua jenis alat eksekusi agen yang saling melengkapi (CLI dan server MCP):

  • Keahlian agen Firebase: Memberikan keahlian domain dan alur kerja kepada agen coding. Sebagai lapisan petunjuk, keahlian memandu agen tentang praktik terbaik untuk menggunakan Firebase, termasuk menulis kode. Keahlian juga mengajari agen kapan dan cara menggunakan CLI Firebase dan server MCP Firebase.
  • Alat eksekusi agen:
    • Firebase CLI (alat command line): Menyediakan alat untuk tugas siklus proses dan lingkungan project. Agen dapat menjalankan perintah CLI di lingkungan terminal untuk menyiapkan layanan di project Firebase, men-deploy situs lengkap atau resource backend, memulai emulator lokal, dan banyak lagi.
    • Server MCP Firebase (alat dan resource terprogram): Menyediakan alat untuk pemeriksaan real-time dan operasi data. Melalui panggilan alat terstruktur, agen dapat membuat kueri dan memperbarui dokumen Cloud Firestore secara terprogram, mengelola pengguna Firebase Authentication, memvalidasi Security Rules, menarik log atau dokumentasi langsung ke dalam konteks, dan banyak lagi.

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

  • Ambil tindakan: Lakukan lebih dari sekadar menulis kode. Agen Anda dapat menginisialisasi layanan, mengelola pengguna Firebase Authentication, 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: Mengakses lingkungan dan skema project Anda untuk memberikan bantuan yang lebih relevan dan akurat.
  • Mengurangi biaya token: Keahlian agen memuat dokumentasi mendetail hanya saat tugas tertentu memerlukannya, sehingga meminimalkan overhead sesi.

Layanan Firebase yang berlaku

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

  • Cloud Firestore: Menyediakan database NoSQL.
  • Firebase 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 konfigurasi 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 Firebase CLI dan server Firebase MCP 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

  • Opsi 1: Akses tingkat global

    Keahlian agen Firebase disertakan dalam plugin Firebase di Antigravity Marketplace (dan sebagai paket integrasi Build with Google). Instal plugin menggunakan salah satu opsi berikut:

    • Dari Antigravity Marketplace: Klik Penyesuaian, pilih tab Marketplace, lalu klik + pada kartu plugin Firebase.
    • Di Antigravity CLI: Jalankan /plugin install firebase@agent-marketplace (atau jalankan /plugin dan instal Firebase dari tab Discover). Plugin yang diinstal di Antigravity juga otomatis disinkronkan ke Antigravity CLI.
    • Selama orientasi: Centang kotak untuk stack Firebase.
  • Opsi 2: Akses tingkat project

    Jalankan perintah berikut di direktori project Anda:

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

Claude Code

Jalankan perintah berikut di terminal Anda:

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

Codex

  • Opsi 1: Terminal Codex

    Jalankan perintah berikut di terminal Anda:

    codex plugin marketplace add firebase/agent-skills
    codex plugin add firebase@firebase
    
  • Opsi 2: Aplikasi Codex

    1. Selesaikan tugas berikut satu kali:

      1. Daftar melalui terminal:

        codex plugin marketplace add firebase/agent-skills
        
      2. Mulai ulang aplikasi Codex sepenuhnya.

      3. Buka Plugin.

      4. Pilih marketplace/sumber Firebase.

      5. Buka Firebase, lalu klik + Install.

    2. Mulai tugas baru.

    3. Ketik @Firebase untuk memilih plugin, atau minta Codex melakukan tugas Firebase.

Kursor

  • Opsi 1: Instal plugin langsung dari Cursor Marketplace.

  • Opsi 2: Jalankan perintah berikut di terminal Anda:

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

Agen lainnya

Jalankan perintah berikut di terminal.

npx skills add firebase/agent-skills

Langkah 2: Hubungkan ke server Firebase MCP

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

Metode yang didukung AI

Pada umumnya, Anda dapat meminta agen coding AI untuk menyiapkan server Firebase MCP. 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 MCP Firebase:

  1. Di Antigravity, klik menu di panel Agen > server MCP.
  2. Pilih Firebase > Install.

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

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

Claude

Claude Code

  • Opsi 1: Menginstal melalui plugin (Direkomendasikan)

    Cara termudah untuk menyiapkan server MCP Firebase 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"]
    }
  }
}

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

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

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 menyiapkan keahlian agen dan alat, Anda kini dapat menggunakan bahasa alami untuk meminta agen coding AI menyiapkan Cloud Firestore, Firebase Authentication, dan Firebase Hosting.

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

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

    1. Rencana: Agen Anda mengusulkan strategi berdasarkan codebase yang ada.
    2. Menghubungkan: Agen Anda menautkan kode lokal 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 satu kali.

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 yang diautentikasi 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 error terminal atau log konsol kembali ke chat.
  • Minta penyesuaian: "Kode tersebut menggunakan SDK v8 yang lebih lama. Tulis ulang menggunakan Firebase Modular SDK v9."
  • Meminta 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.
  • Uji 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 merujuk file tertentu untuk mendapatkan saran penerapan yang disesuaikan.

  • Contoh: "Look at my src/web/index.html file and show me where to add the standard Firebase initialization script."

Langkah berikutnya