Menghubungkan LLM ke Cloud Storage dengan MCP

Panduan ini menunjukkan cara menghubungkan Cloud Storage ke Lingkungan Pengembangan Terintegrasi (IDE) dan alat developer. Untuk melakukannya, Anda menjalankan server MCP lokal di mesin menggunakan MCP Toolbox for Databases.

MCP Toolbox for Databases adalah repositori open source yang berisi konektor untuk database dan datastore, termasuk Cloud Storage, BigQuery, AlloyDB, Spanner, dan Cloud SQL. Toolbox mendukung autentikasi OAuth2 dan OIDC, serta terintegrasi dengan Open Telemetry untuk kemampuan observasi. Integrasi toolbox Cloud Storage memungkinkan Anda menggunakan LLM untuk melakukan tindakan berikut:

  • Membuat, mencantumkan, dan menghapus bucket.
  • Mendapatkan metadata bucket dan objek.
  • Mendapatkan kebijakan Identity and Access Management (IAM) di bucket Anda.
  • Membaca, menulis, mengupload, dan mendownload objek.
  • Menyalin atau memindahkan objek.

Panduan ini menunjukkan proses koneksi untuk IDE dan alat berikut:

  • Kursor
  • Windsurf (sebelumnya Codeium)
  • Visual Studio Code (Copilot)
  • Cline (ekstensi VS Code)
  • Claude desktop
  • Kode Claude
  • Antigravity

Sebelum memulai

  1. Di konsol Cloud de Confiance , pada halaman pemilih project, pilih atau buat project Cloud de Confiance by S3NS .

  2. Pastikan penagihan diaktifkan untuk Cloud de Confiance project Anda.

  3. Aktifkan Cloud Storage API di Cloud de Confiance project.

  4. Konfigurasi peran dan izin yang diperlukan untuk menyelesaikan tugas ini. Pengguna yang memanggil agen LLM memerlukan peran berikut di tingkat bucket atau project:

    • Untuk mencantumkan bucket, membuat bucket, dan menghapus bucket kosong: Storage Admin (roles/storage.admin)
    • Untuk mencantumkan objek, membaca objek, mendapatkan metadata objek, atau metadata bucket: Storage Object Viewer (roles/storage.objectViewer)
    • Untuk menulis konten ke objek atau mengupload objek: Storage Object Creator (roles/storage.objectCreator)
    • Untuk menyalin, memindahkan, atau menghapus objek: Storage Object Admin (roles/storage.objectAdmin)

  5. Konfigurasi Kredensial Default Aplikasi (ADC) untuk lingkungan Anda.

Terhubung dengan Antigravity

Anda menghubungkan Cloud Storage ke Antigravity menggunakan konfigurasi kustom. Dalam konteks ini, server MCP kustom adalah server yang Anda konfigurasi secara manual dengan mengedit file konfigurasi (seperti mcp_config.json). Konfigurasi manual ini digunakan, bukan menginstal server langsung dari katalog MCP Store bawaan.

Untuk mengonfigurasi server MCP kustom, lakukan hal berikut:

  1. Pastikan npx telah diinstal dan dikonfigurasi dengan benar di sistem Anda dengan menjalankan npx --version di terminal Anda. Jika Anda perlu menginstal Node.js, yang mencakup npx, lihat panduan Mendownload dan menginstal Node.js dan npm di npm.
  2. Buka Antigravity dan buka toko MCP menggunakan drop-down "..." di bagian atas panel agen editor.
  3. Untuk membuka file mcp_config.json, klik MCP Servers, lalu klik Manage MCP Servers > View raw config.
  4. Tambahkan konfigurasi berikut, ganti placeholder dengan project ID Anda, lalu simpan: 
    {
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

Menginstal MCP Toolbox

Toolbox adalah server Model Context Protocol (MCP) open source yang berjalan secara lokal di mesin Anda. Server lokal mengelola komunikasi antara IDE dan Cloud Storage. Koneksi ini menyediakan lingkungan yang aman dan efisien untuk alat AI Anda.

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

    linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    Ganti VERSION dengan versi MCP Toolbox—misalnya, v1.2.0.

    macOS darwin/arm64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

    Ganti VERSION dengan versi MCP Toolbox—misalnya, v1.2.0.

    macOS darwin/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

    Ganti VERSION dengan versi MCP Toolbox—misalnya, v1.2.0.

    windows/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

    Ganti VERSION dengan versi MCP Toolbox—misalnya, v1.2.0.

  2. Jadikan biner sebagai file yang dapat dieksekusi:

    chmod +x toolbox

  3. Verifikasi penginstalannya:

    ./toolbox --version

Untuk menyiapkan toolbox dengan image container atau Homebrew, lihat halaman Menginstal Toolbox.

Menyiapkan klien dan koneksi

Bagian ini menjelaskan cara menghubungkan Cloud Storage ke alat Anda setelah Anda menginstal MCP Toolbox.

Kode Claude

  1. Instal Claude Code.
  2. Buat file .mcp.json di root project Anda, jika belum ada.
  3. Tambahkan konfigurasi, ganti placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.
  4. Mulai ulang Claude Code untuk memuat setelan baru. Saat Claude Code dibuka kembali, aplikasi akan mendeteksi server MCP yang dikonfigurasi.

Claude desktop

  1. Buka Claude Desktop, lalu buka Settings.
  2. Di tab Developer, klik Edit Config untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi, ganti placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.
  4. Mulai ulang Claude Desktop.
  5. Layar chat baru menampilkan ikon palu (MCP) dengan server MCP baru.

Cline

  1. Buka ekstensi Cline di VS Code, lalu klik ikon MCP Servers.
  2. Klik Configure MCP Servers untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi berikut, ganti placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.

Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Kursor

  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 placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.
  4. Buka Kursor, lalu buka Setelan > Setelan Kursor > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

Visual Studio Code (Copilot)

  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 placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.
  4. Muat ulang jendela VS Code. Ekstensi yang kompatibel dengan MCP akan otomatis mendeteksi konfigurasi dan memulai server.

Windsurf

  1. Buka Windsurf dan buka asisten Cascade.
  2. Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.
  3. Tambahkan konfigurasi berikut, ganti placeholder dengan nilai Anda, lalu simpan: 
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    Ganti variabel berikut dengan nilai Anda:
    • ./PATH/TO/toolbox: Jalur ke biner toolbox Anda.
    • CLOUD_STORAGE_PROJECT: Variabel lingkungan yang menentukan Cloud de Confiance Project ID.
    • PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.

Alat bawaan

Setelah Anda menghubungkan MCP Toolbox ke Cloud Storage, agen Anda akan menggunakan alat bawaan berikut:

  • list_buckets: Mencantumkan bucket Cloud Storage dalam project yang dikonfigurasi.
  • list_objects: Mencantumkan objek dalam bucket dengan pemfilteran awalan dan pembatas opsional.
  • get_bucket_metadata: Menampilkan metadata untuk bucket.
  • get_bucket_iam_policy: Menampilkan binding kebijakan IAM untuk bucket.
  • get_object_metadata: Menampilkan metadata untuk objek.
  • read_object: Membaca objek teks UTF-8 (atau rentang byte). Dibatasi hingga 8 MiB; objek biner ditolak.
  • download_object: Mendownload objek ke jalur lokal.
  • create_bucket: Membuat bucket di project yang dikonfigurasi.
  • delete_bucket: Menghapus bucket kosong.
  • upload_object: Mengupload file lokal ke objek.
  • write_object: Menulis konten teks langsung ke objek.
  • copy_object: Menyalin objek ke objek tujuan.
  • move_object: Mengganti nama objek secara atomik dalam bucket yang sama.
  • delete_object: Menghapus objek.