Menggunakan Cloud SQL untuk SQL Server dengan MCP, Gemini CLI, dan agen lainnya

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menunjukkan cara menghubungkan instance Cloud SQL Anda ke berbagai alat bantuan developer AI, termasuk yang berikut:

• Ekstensi Gemini CLI untuk Cloud SQL untuk SQL Server
• Ekstensi Gemini CLI untuk SQL Server

• Gemini Code Assist
• Kode Claude
• Desktop Claude
• Codex
• Cline (ekstensi VS Code)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (Codeium)
• Antigravity

Untuk pengalaman terintegrasi, sebaiknya gunakan ekstensi Gemini CLI khusus untuk Cloud SQL untuk SQL Server.

Sebagai antarmuka command line generasi berikutnya, Gemini CLI menggabungkan kemampuan dasar langsung ke dalam ekstensi, yang menyederhanakan penyiapan dan konfigurasi. Google CloudAnda 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 (Toolbox) secara manual. Toolbox adalah server MCP open source yang menghubungkan agen AI ke data Anda dengan mengelola tugas seperti autentikasi dan penggabungan koneksi. Hal ini memungkinkan Anda berinteraksi dengan data menggunakan bahasa alami langsung dari IDE Anda. Untuk alat ini, metode ini menyediakan kemampuan interaksi database inti.

Untuk mengetahui informasi selengkapnya, lihat Alat bawaan dan MCP Toolbox for Databases di GitHub.

Tentang Gemini CLI dan ekstensi

Gemini CLI adalah agen AI open source yang dirancang untuk membantu alur kerja pengembangan dengan membantu pengkodean, proses debug, eksplorasi data, dan pembuatan konten. Alat ini menyediakan antarmuka agen untuk berinteraksi dengan layanan database dan analisis serta database open source yang populer.

Cara kerja ekstensi

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

Menggunakan ekstensi Gemini CLI di Cloud SQL untuk SQL Server

Ekstensi Gemini CLI Cloud SQL didasarkan pada MCP Toolbox for Databases.

Integrasi dengan Gemini CLI dilakukan melalui ekstensi khusus yang menawarkan kemampuan tambahan dibandingkan dengan koneksi Toolbox standar. Ekstensi ini menawarkan proses penginstalan yang disederhanakan dan serangkaian kemampuan berdasarkan Alat MCP.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi GitHub untuk ekstensi Gemini CLI untuk Cloud SQL untuk SQL Server.

Ekstensi Gemini CLI untuk database Cloud SQL untuk SQL Server

Ekstensi cloud-sql-sqlserver mencakup kemampuan untuk membuat kueri database dan memantau kondisi database.

Untuk semua kemampuan yang tersedia, lihat kemampuan Cloud SQL di GitHub Ekstensi cloud-sql-sqlserver-observability menyediakan antarmuka terpadu untuk mengelola dan memantau performa dan kondisi database langsung dari Gemini CLI.

Kategori	Alat
Kemampuan observasi	get_system_metrics: Mengambil metrik sistem untuk instance Cloud SQL.

Ekstensi Gemini CLI untuk database SQL Server

Untuk mengetahui daftar operasi tersebut, lihat MCP Toolbox for Databases dan ekstensi Gemini CLI untuk SQL Server.

Sebelum memulai

• Di Google Cloud konsol, pada halaman pemilih project, pilih atau buat Google Cloud project.

• Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

• Aktifkan Cloud SQL Admin API di Google Cloud project.

• Secara default, Cloud SQL menetapkan alamat IP publik ke instance baru. Bergantung pada kasus penggunaan Anda, pastikan IP Publik atau IP Pribadi disiapkan untuk instance Cloud SQL Anda. Toolbox terhubung dengan aman menggunakan Cloud SQL Language Connectors.

• Berikan peran Identity and Access Management (IAM) yang diperlukan kepada pengguna yang akan menjalankan server MCP. Alat yang tersedia bergantung pada peran yang diberikan:

  Tugas	Nama peran	Peran IAM yang diperlukan
  Memberikan akses hanya baca ke resource, termasuk operasi berikut: get_instance list_instances list_databases wait_for_operation	Penampil Cloud SQL	roles/cloudsql.viewer
  Memberikan akses hanya baca ke data pemantauan seperti metrik deret waktu.	Penampil Cloud Monitoring	roles/monitoring.viewer
  Memberikan izin untuk mengelola resource yang ada, termasuk yang berikut: Semua alat viewer create_database	Editor Cloud SQL	roles/cloudsql.editor
  Memberikan kontrol penuh atas semua resource, termasuk yang berikut: Semua alat viewer dan editor create_instance create_user	Admin Cloud SQL	roles/cloudsql.admin

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

• Buat atau gunakan kembali pengguna database, dan siapkan nama pengguna serta sandinya.

Menghubungkan dengan Antigravity

Anda dapat menghubungkan Cloud SQL untuk SQL Server ke Antigravity dengan cara berikut:

• Menggunakan MCP Store
• Menggunakan konfigurasi kustom

Catatan: Anda tidak perlu mendownload biner MCP Toolbox untuk menggunakan metode ini.

MCP Store

Metode yang paling direkomendasikan untuk menghubungkan ke Cloud SQL untuk SQL Server di Antigravity adalah menggunakan MCP Store bawaan.

1. Buka Antigravity dan buka panel agen editor.
2. Klik ikon "..." di bagian atas panel, lalu pilih MCP Servers.
3. Temukan Cloud SQL for SQL Server dalam daftar server yang tersedia, lalu klik Install.
4. Ikuti perintah di layar untuk menautkan akun Anda dengan aman jika berlaku.

Setelah Anda menginstal Cloud SQL untuk SQL Server di MCP Store, resource dan alat dari server akan otomatis tersedia untuk editor.

Konfigurasi kustom

Untuk menghubungkan ke server MCP kustom, ikuti langkah-langkah berikut:

1. Buka Antigravity dan buka panel agen editor.
2. Klik ikon "..." di bagian atas panel, lalu pilih MCP Servers.
3. Klik Manage MCP Servers > View raw config untuk membuka file mcp_config.json.
4. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan.

{
  "mcpServers": {
    "cloud-sql-mssql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Setelah Anda mengonfigurasi server MCP kustom, resource dan alat dari server Cloud SQL untuk SQL Server akan tersedia untuk editor.

Menginstal MCP Toolbox

Catatan: Langkah ini tidak diperlukan untuk ekstensi Gemini CLI.

1. Download biner yang sesuai dengan sistem operasi dan arsitektur CPU Anda.

<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>

Jadikan biner dapat dieksekusi:

```bash
chmod +x toolbox
```

Verifikasi penginstalan menggunakan perintah berikut:

```bash
./toolbox --version
```

Mengonfigurasi Klien MCP

Bagian ini menjelaskan cara mengonfigurasi berbagai alat developer untuk terhubung ke instance Cloud SQL Anda menggunakan Toolbox. Toolbox bertindak 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 alat tertentu Anda guna melihat petunjuk konfigurasi.

Gemini CLI untuk Cloud SQL untuk SQL Server

1. Instal Gemini CLI.
2. Instal ekstensi Cloud SQL untuk SQL Server untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut:

         gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sqlserver
         

   Saat menginstal ekstensi, ganti kode berikut:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Ganti kode berikut:
   • PROJECT_NAME: Project ID Google Cloud
   • REGION: Region instance Cloud SQL Anda.
   • INSTANCE_NAME: ID instance Cloud SQL Anda.
   • DATABASE_NAME: Nama database yang akan dihubungkan.
   • DATABASE_USER_NAME: Opsional: Nama pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • PASSWORD: Opsional: Sandi untuk pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • IP_TYPE: Opsional: Jenis IP, seperti "Public" (default) atau "Private".
3. Mulai Gemini CLI dalam mode interaktif:

         gemini
         

   CLI akan otomatis memuat ekstensi Gemini CLI untuk Cloud SQL dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan database Anda.

   Di Gemini CLI, gunakan /extensions perintah untuk memverifikasi bahwa ekstensi telah diinstal dan /mcp list perintah untuk melihat alat.

Gemini CLI untuk SQL Server

1. Instal Gemini CLI.
2. Instal ekstensi software SQL Server untuk Gemini CLI dari repositori GitHub menggunakan perintah berikut:

         gemini extensions install https://github.com/gemini-cli-extensions/sql-server
         

   Saat menginstal ekstensi, ganti kode berikut:

         export MSSQL_HOST="HOST"
         export MSSQL_PORT="PORT"
         export MSSQL_DATABASE="DATABASE"
         export MSSQL_USER="USER"
         export MSSQL_PASSWORD="PASSWORD"
         

   Ganti kode berikut:
   • HOST: Nama host atau alamat IP server SQL Server.
   • PORT: Nomor port untuk server SQL Server.
   • DATABASE: Nama database yang akan dihubungkan.
   • USER: Nama pengguna database.
   • PASSWORD: Sandi untuk pengguna database.
3. Mulai Gemini CLI dalam mode interaktif:

         gemini
         

   CLI akan otomatis memuat ekstensi Gemini CLI untuk SQL Server dan alatnya, yang dapat Anda gunakan untuk berinteraksi dengan database Anda.

Gemini Code Assist

1. Instal ekstensi Gemini Code Assist di Visual Studio Code.
2. Aktifkan Mode Agen di chat Gemini Code Assist.
3. Di direktori kerja Anda, buat folder bernama .gemini. Di dalamnya, buat file settings.json.
4. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Kode Claude

1. Instal Kode Claude.
2. Tetapkan variabel lingkungan untuk terhubung ke instance Cloud SQL Anda:

         export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
         export CLOUD_SQL_MSSQL_REGION="REGION"
         export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
         export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
         export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
         export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
         export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
         

   Ganti kode berikut:
   • PROJECT_NAME: Project ID Google Cloud
   • REGION: Region instance Cloud SQL Anda.
   • INSTANCE_NAME: ID instance Cloud SQL Anda.
   • DATABASE_NAME: Nama database yang akan dihubungkan.
   • DATABASE_USER_NAME: Opsional: Nama pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • PASSWORD: Opsional: Sandi untuk pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • IP_TYPE: Opsional: Jenis IP, seperti "Public" (default) atau "Private".
3. Mulai agen:

         claude
         

4. Temukan versi rilis terbaru di repositori Kemampuan Cloud SQL untuk SQL Server dan tambahkan marketplace:

         /plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git#VERSION
         

5. Instal plugin:

         /plugin install cloud-sql-sqlserver@cloud-sql-sqlserver-marketplace
         

Tips: Jalankan /plugin list di dalam Kode Claude untuk memverifikasi bahwa plugin aktif, atau /reload-plugins jika Anda baru saja menginstalnya.

Desktop Claude

1. Buka Desktop Claude dan buka Setelan.
2. Di tab Developer, ketuk Edit Config untuk membuka file konfigurasi.
3. Tambahkan kode berikut untuk terhubung ke server MCP dan menetapkan variabel lingkungan:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

4. Mulai ulang Desktop Claude. Layar chat baru akan menampilkan ikon MCP dengan server MCP baru yang tersedia.

Codex

1. Temukan versi rilis terbaru di repositori Kemampuan Cloud SQL untuk SQL Server dan clone:

   git clone --branch VERSION [e-mail]:gemini-cli-extensions/cloud-sql-sqlserver.git
   

2. Instal plugin:

   mkdir -p ~/.codex/plugins
   cp -R /absolute/path/to/cloud-sql-sqlserver ~/.codex/plugins/cloud-sql-sqlserver
   

3. Konfigurasi variabel lingkungan untuk terhubung ke instance Cloud SQL Anda:

       export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
       export CLOUD_SQL_MSSQL_REGION="REGION"
       export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
       export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
       export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
       export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
       export CLOUD_SQL_MSSQL_IP_TYPE="IP_TYPE"
       

   Ganti kode berikut:
   • PROJECT_NAME: Project ID Google Cloud
   • REGION: Region instance Cloud SQL Anda.
   • INSTANCE_NAME: ID instance Cloud SQL Anda.
   • DATABASE_NAME: Nama database yang akan dihubungkan.
   • DATABASE_USER_NAME: Opsional: Nama pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • PASSWORD: Opsional: Sandi untuk pengguna database. Jika tidak ditentukan, setelan defaultnya adalah autentikasi IAM.
   • IP_TYPE: Opsional: Jenis IP, seperti "Public" (default) atau "Private".
4. Buat atau perbarui marketplace.json:

   
   {
     "name": "my-data-cloud-google-marketplace",
     "interface": {
       "displayName": "Google Data Cloud Skills"
     },
     "plugins": [
       {
         "name": "cloud-sql-sqlserver",
         "source": {
           "source": "local",
           "path": "./plugins/cloud-sql-sqlserver"
         },
         "policy": {
           "installation": "AVAILABLE",
           "authentication": "ON_INSTALL"
         },
         "category": "Database"
       }
     ]
   }
   
   

5. Jalankan codex plugin list atau gunakan menu interaktif plugins untuk memverifikasi plugin yang diinstal.

Cline

1. Buka ekstensi Cline di VS Code dan ketuk ikon MCP Servers.
2. Ketuk Configure MCP Servers untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

   Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Cursor

1. Buat direktori .cursor di root project Anda jika belum ada.
2. Buat file .cursor/mcp.json jika belum ada dan buka.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

4. Buka Cursor dan buka Settings > Cursor Settings > 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 belum ada, lalu buka.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

   
   {
     "servers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }
   
   

Windsurf

1. Buka Windsurf dan buka Cascade assistant.
2. Ketuk ikon MCP, lalu ketuk Configure untuk membuka file konfigurasi.
3. Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

   
   {
     "mcpServers": {
       "cloud-sql-sqlserver": {
         "command": "./PATH/TO/toolbox",
         "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
         "env": {
           "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
           "CLOUD_SQL_MSSQL_REGION": "REGION",
           "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
           "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
           "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
           "CLOUD_SQL_MSSQL_USER": "USER_ID",
           "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
         }
       }
     }
   }