Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menghubungkan LLM ke Cloud Storage dengan MCP

Anda dapat menjalankan server Model Context Protocol (MCP) lokal dengan MCP Toolbox for Databases untuk berinteraksi dengan Cloud Storage langsung dari IDE dan alat developer Anda. Penyiapan ini memungkinkan model bahasa besar (LLM) di klien seperti Antigravity, Claude, Cline, Cursor, Visual Studio Code (Copilot), dan Windsurf membuat bucket, mengelola data objek, dan memeriksa kebijakan Identity and Access Management (IAM).

MCP Toolbox open source mendukung autentikasi OAuth2 dan OIDC, serta terintegrasi dengan OpenTelemetry untuk kemampuan observasi. Integrasi Cloud Storage memerlukan MCP Toolbox versi 1.2.0 atau yang lebih baru. Untuk menjalankan server MCP lokal mandiri tanpa toolbox, gunakan repositori GitHub MCP Cloud Storage.

Sebelum memulai

Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .
Pastikan penagihan diaktifkan untuk project Google Cloud Anda.
Aktifkan Cloud Storage API di project Google Cloud .
Konfigurasikan peran dan izin yang diperlukan untuk menyelesaikan tugas ini. Pengguna yang memanggil agen LLM memerlukan peran berikut di level 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)
Konfigurasikan 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 sebagai pengganti penginstalan server langsung dari katalog MCP Store bawaan.

Untuk mengonfigurasi server MCP kustom, lakukan hal berikut:

Pastikan npx telah diinstal dan dikonfigurasi dengan benar di sistem Anda dengan menjalankan npx --version di terminal. Jika Anda perlu menginstal Node.js, yang mencakup npx, lihat panduan npm Mendownload dan menginstal Node.js dan npm.
Buka Antigravity dan buka MCP store menggunakan drop-down "..." di bagian atas panel agen editor.
Untuk membuka file mcp_config.json, klik Server MCP, lalu klik Manage MCP Servers > View raw config.

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 komputer Anda. Server lokal mengelola komunikasi antara IDE Anda dan Cloud Storage. Koneksi ini menyediakan lingkungan yang aman dan efisien untuk alat AI Anda.

Download versi terbaru MCP Toolbox 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.
Buat file biner yang dapat dieksekusi:
```
chmod +x toolbox
```
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 menginstal MCP Toolbox.

Claude Code

Instal Claude Code.
Buat file .mcp.json di root project Anda, jika belum ada.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud Anda.

Mulai ulang Claude Code untuk memuat setelan baru. Saat Claude Code dibuka kembali, aplikasi akan mendeteksi server MCP yang dikonfigurasi.

Claude desktop

Buka Claude Desktop, lalu buka Settings.
Di tab Developer, klik Edit Config untuk membuka file konfigurasi.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud Anda.

Mulai ulang Claude Desktop.
Layar chat baru akan menampilkan ikon palu (MCP) dengan server MCP baru.

Cline

Buka ekstensi Cline di VS Code, lalu klik ikon server MCP.
Klik Configure MCP Servers untuk membuka file konfigurasi.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud Anda.

Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Kursor

Buat direktori .cursor di root project Anda jika belum ada.
Buat file .cursor/mcp.json jika belum ada, lalu buka.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud Anda.

Buka Cursor, lalu buka Settings > Cursor Settings > MCP. Status aktif berwarna hijau akan muncul saat server terhubung.

Visual Studio Code (Copilot)

Buka VS Code dan buat direktori .vscode di root project Anda jika belum ada.
Buat file .vscode/mcp.json jika belum ada, lalu buka.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud Anda.

Muat ulang jendela VS Code. Ekstensi yang kompatibel dengan MCP akan otomatis mendeteksi konfigurasi dan memulai server.

Windsurf

Buka Windsurf dan buka asisten Cascade.
Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.

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 Project ID Google Cloud .
PROJECT_ID: Project ID Google Cloud 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.

Menghubungkan LLM ke Cloud Storage dengan MCP Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Terhubung dengan Antigravity

Menginstal MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Menyiapkan klien dan koneksi

Claude Code

Claude desktop

Cline

Kursor

Visual Studio Code (Copilot)

Windsurf

Alat bawaan

Menghubungkan LLM ke Cloud Storage dengan MCP