Menggunakan Firestore dengan MCP, Gemini CLI, dan agen lainnya

Halaman ini menunjukkan cara menghubungkan database Firestore ke berbagai alat developer.

Untuk pengalaman terintegrasi, sebaiknya gunakan ekstensi Firestore khusus untuk Gemini CLI. Sebagai antarmuka command line generasi berikutnya dari Google Cloud, Gemini CLI menggabungkan server MCP yang mendasarinya langsung ke dalam ekstensi, sehingga tidak memerlukan penyiapan server terpisah. Anda dapat mengonfigurasi Gemini Code Assist untuk menggunakan Gemini CLI, yang menawarkan manfaat penyiapan serupa di IDE Anda.

Untuk alat developer lain yang mendukung Model Context Protocol (MCP), Anda dapat terhubung dengan mengonfigurasi MCP Toolbox for Databases secara manual. MCP Toolbox adalah server MCP open source yang menghubungkan agen AI ke data Anda dengan mengelola tugas seperti autentikasi dan penggabungan koneksi. Dengan begitu, Anda dapat berinteraksi dengan data menggunakan bahasa alami langsung dari IDE. Untuk alat ini, metode ini menyediakan kemampuan interaksi database inti. Halaman ini menjelaskan cara menggunakan MCP Toolbox for Databases untuk mengekspos alat bantuan developer ke instance Firestore menggunakan IDE berikut:

Tentang Gemini CLI dan ekstensi

Gemini CLI adalah agen AI open source yang dirancang untuk membantu alur kerja pengembangan dengan membantu coding, proses debug, eksplorasi data, dan pembuatan konten. Misinya adalah menyediakan antarmuka agentik untuk berinteraksi dengan layanan Data Cloud dan database open source populer.

Cara kerja ekstensi

CLI Gemini sangat mudah diperluas, sehingga memungkinkan penambahan alat dan kemampuan baru melalui ekstensi. Anda dapat memuat ekstensi dari URL GitHub, direktori lokal, atau registry yang dapat dikonfigurasi. Mereka menyediakan alat, perintah garis miring, dan perintah baru untuk membantu alur kerja Anda.

Menggunakan ekstensi Gemini CLI untuk Firestore

Integrasi dengan Gemini CLI dilakukan melalui ekstensi khusus yang menawarkan kemampuan tambahan dibandingkan dengan koneksi MCP Toolbox standar. Ekstensi ini menawarkan proses penginstalan yang disederhanakan dan serangkaian alat. Ekstensi open source ini berisi informasi mendetail tentang penginstalan, konfigurasi, dan contoh penggunaan. Untuk mengetahui informasi selengkapnya, lihat Ekstensi Gemini CLI - Firestore.

Ekstensi firestore-native mencakup alat untuk membuat kueri database, memperbarui dokumen, dan mengelola aturan keamanan Firestore.

Kategori Alat Contoh perintah bahasa alami
Pengambilan dokumen dan data get_documents Tampilkan data Firestore untuk pengguna pengujian qa_user_123 dan qa_user_456 dari koleksi users-staging.
list_collections Mencantumkan semua subkoleksi di koleksi users-staging.
query_collection Temukan semua pengguna dalam koleksi users-staging yang daftar keinginannya berisi product-glasses.
Pembaruan dan penghapusan dokumen add_documents Tambahkan dokumen qa_user_789 ke koleksi users-staging dengan kolom name: tester1 dan location: USA.
delete_documents Hapus dokumen qa_user_789 dari koleksi users-staging.
update_document

Perbarui dokumen dengan ID order-987 di koleksi orders untuk menetapkan status ke 'Shipped'.

Untuk semua 20 pengguna uji yang baru saja Anda temukan, hapus product-glasses(inactive) dari daftar keinginan mereka.
Pengelolaan aturan keamanan get_rules Tunjukkan aturan keamanan Firestore yang aktif untuk database ini.
validate_rules new_rules.txt adalah Aturan Keamanan Firestore baru yang sedang saya kerjakan untuk penyiapan. Bisakah Anda memvalidasinya untuk saya?

Sebelum memulai

Untuk menggunakan alat di ekstensi Gemini CLI untuk Firestore, Anda harus memiliki salah satu peran Identity and Access Management (IAM) berikut, atau peran kustom dengan izin yang setara:

Tugas Nama peran Peran Identity and Access Management (IAM) yang diperlukan
Membaca dan menulis data di database Firestore Pengguna Cloud Datastore roles/datastore.user
Melihat dan menguji aturan keamanan Firebase Rules Viewer roles/firebaserules.viewer

Menyiapkan Firestore

  1. Buat project Google Cloud baru atau pilih project yang sudah ada.

  2. Aktifkan Firestore in Native Mode API untuk project Anda.

  3. Buat database Firestore jika Anda belum melakukannya.

  4. Siapkan autentikasi untuk lingkungan lokal Anda.

    • Instal gcloud CLI
    • Jalankan gcloud auth application-default login untuk melakukan autentikasi

Mengonfigurasi klien MCP

Bagian ini menjelaskan cara mengonfigurasi berbagai alat developer untuk terhubung ke instance Firestore Anda menggunakan MCP Toolbox for Databases. Toolbox ini berfungsi sebagai server Model Context Protocol (MCP) open source yang berada di antara IDE dan database Anda, sehingga menyediakan bidang kontrol yang aman dan efisien untuk alat AI Anda. Pilih tab untuk salah satu alat berikut guna melihat petunjuk konfigurasi.

Gemini CLI

  1. Instal Gemini CLI.
  2. Instal ekstensi Firestore untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut: 
    gemini extensions install https://github.com/gemini-cli-extensions/firestore-native
  3. Tetapkan variabel lingkungan untuk terhubung ke database Firestore Anda. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default): 
    export FIRESTORE_PROJECT="PROJECT_ID"
export FIRESTORE_DATABASE="DATABASE_NAME"

    Ekstensi Gemini CLI untuk Firestore menggunakan kredensial default aplikasi (ADC) Anda untuk autentikasi.

  4. Mulai Gemini CLI dalam mode interaktif: 
    gemini
    CLI akan otomatis memuat ekstensi Firestore untuk ekstensi Gemini CLI dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan database Anda.

Gemini Code Assist

Sebaiknya konfigurasi Gemini Code Assist agar menggunakan Gemini CLI. Pendekatan ini menghilangkan kebutuhan untuk mengonfigurasi server MCP secara manual.

  1. Pastikan Anda telah menginstal dan mengonfigurasi Gemini CLI dan ekstensi firestore-native.
  2. Konfigurasi Gemini Code Assist untuk menggunakan Gemini CLI.
  3. Mulai berinteraksi dengan database Firestore Anda menggunakan bahasa alami langsung dalam chat Gemini Code Assist.

Kode Claude

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Instal Claude Code.
  2. Buat file .mcp.json di root project Anda, jika belum ada.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Mulai ulang kode Claude untuk menerapkan konfigurasi baru.

Claude desktop

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Buka Claude Desktop, lalu buka Settings.
  2. Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Mulai ulang Claude Desktop.
  2. Dari layar chat baru, Anda akan melihat ikon palu (MCP) muncul dengan server MCP baru yang tersedia.

Cline

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Buka ekstensi Cline di VS Code, lalu ketuk ikon MCP Servers.
  2. Klik Configure MCP Servers untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Kursor

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Buat direktori .cursor di root project Anda jika belum ada.
  2. Buat file .cursor/mcp.json jika tidak ada, lalu buka.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Buka Kursor, lalu buka Setelan > Setelan Kursor > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

Visual Studio Code (Copilot)

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Buka VS Code dan buat direktori .vscode di root project Anda jika belum ada.
  2. Buat file .vscode/mcp.json jika tidak ada, lalu buka.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).
 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Selancar Angin

Menginstal MCP Toolbox for Databases

  1. Download Toolbox versi terbaru sebagai biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan Toolbox versi V0.15.0 atau yang lebih baru.

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    Ganti version dengan nomor versi Toolbox, misalnya v0.15.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi.

    chmod +x toolbox

  3. Verifikasi penginstalannya.

    ./toolbox --version

Menghubungkan ke server MCP

  1. Buka Windsurf dan buka asisten Cascade.
  2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan. Variabel FIRESTORE_DATABASE bersifat opsional dan defaultnya adalah (default).
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }