Model Context Protocol (MCP) memungkinkan Anda mengintegrasikan kemampuan agentic Gemini Cloud Assist dan Application Design Center langsung ke alat pihak ketiga, seperti Antigravity, Gemini CLI, dan Cursor. Integrasi ini menghadirkan keahlian operasi cloud dan bantuan arsitektur ke dalam alur kerja pengembangan yang ada. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi MCP untuk aplikasi AI Anda.
Alat MCP Gemini Cloud Assist
Gemini Cloud Assist adalah agen yang dapat diakses melalui serangkaian alat MCP menggunakan pola agen-sebagai-alat. Tidak seperti alat yang mengambil data atau melakukan pemrosesan prosedural, alat Gemini Cloud Assist mengekspos fungsi agentik dari semua Gemini Cloud Assist atau alur kerja tertentu. Agen yang dipanggil oleh panggilan alat MCP membuat panggilan alatnya sendiri secara internal ke Google Cloud. Alat MCP berikut dipublikasikan agar dapat digunakan oleh agen:
ask_cloud_assist: Ini adalah antarmuka utama untuk Google Cloud bantuan dan untuk agen Gemini Cloud Assist. Semua fungsi Gemini Cloud Assist dapat diakses melalui alat ini dan mencakup fungsi alat MCP lainnya.design_infra: Hal ini mendukung alur kerja untuk mendesain dan membangun arsitektur infrastruktur di Google Cloud. Alat ini berfungsi dengan alat server MCP Pusat Desain Aplikasi untuk mengelola siklus proses desain infrastruktur Anda—misalnya, menjalankan dan memperbaiki temuan keamanan, atau men-deploy dan memperbaiki masalah.investigate_issue: Ini mendukung alur kerja untuk memecahkan masalah di Google Cloud. Anda dapat melakukan pemecahan masalah cepat atau pemecahan masalah yang lebih mendalam melalui resource Investigation.invoke_operation: Ini mendukung alur kerja untuk membuat, memperbarui, dan menghapus resource di Google Cloud. Alat ini hanya berfungsi jika Tindakan Agen diaktifkan. Operasi penulisan di Gemini Cloud Assist hanya dapat dieksekusi melalui pemanggilan alat ini.optimize_costs: Hal ini mendukung alur kerja untuk menganalisis, melacak, dan mengoptimalkan Google Cloud biaya. Laporan ini memberikan perincian mendetail tentang pembelanjaan dan mengidentifikasi peluang efisiensi biaya dengan menemukan resource yang tidak ada aktivitas atau kurang dimanfaatkan.
Alat MCP Pusat Desain Aplikasi
Alat ini, yang sering diatur oleh alat design_infra Gemini Cloud Assist, mengelola siklus proses aplikasi infrastruktur menggunakan App Design Center, termasuk pengelolaan template, kepatuhan dan perbaikan keamanan, serta deployment. Alat-alat tersebut adalah:
setup_adc: Menginisialisasi lingkungan Pusat Desain Aplikasi. Ini adalah langkah penyiapan satu kali yang harus dilakukan sebelum alat Pusat Desain Aplikasi lainnya dapat digunakan.manage_application: Mengelola siklus proses deployment aplikasi. Gunakan alat ini untuk men-deploy desain terverifikasi menggunakan Pusat Desain Aplikasi atau mengambil status dan detail deployment yang ada. Ini adalah langkah terakhir yang mengubah desain Anda menjadi infrastruktur yang di-deploy di Google Cloud.manage_application_template: Mengelola konten Infrastructure as Code (IaC) desain infrastruktur Anda. Gunakan opsi ini untuk menyimpan desain sebagai template App Design Center, mengekspor desain sebagai file Terraform, atau memperbarui desain. Misalnya, Anda dapat menggunakan alat ini untuk memperbarui desain dengan mengubah setelan komponen dan konfigurasi parameter.assess_best_practices: Melakukan audit keamanan dan konfigurasi yang komprehensif pada desain aplikasi Anda sebelum deployment. Alat ini memvalidasi desain berdasarkan framework Security Command Center dan kontrol yang relevan, serta menampilkan laporan dengan temuan yang dapat ditindaklanjuti untuk perbaikan.list_application_templates: Mencantumkan semua desain aplikasi yang tersedia.
Alat MCP ini tidak boleh diperlakukan sebagai API stabil atau dikonfigurasi melalui klien API prosedural. Alat dari daftar ini atau parameternya dapat diganti namanya, didefinisikan ulang, dihapus, atau ditambahkan dari waktu ke waktu untuk memperhitungkan kemampuan Gemini Cloud Assist yang terus berkembang. Kemampuan Gemini Cloud Assist akan tetap stabil sehingga agen klien dapat menjalankan tugas yang sama secara konsisten, tetapi cara agen berinteraksi dengan dan memanggil Gemini Cloud Assist melalui alat ini akan berubah seiring waktu.
Sebelum memulai
Memberikan akses: Untuk menggunakan MCP, Anda harus diberi peran Identity and Access Management yang berisi izin
mcp.googleapis.com/tools.call, seperti salah satu peran Gemini Cloud Assist berikut:roles/geminicloudassist.userroles/geminicloudassist.editorroles/geminicloudassist.admin
Jika Anda belum melakukannya, instal gcloud CLI dan komponen betanya.
Aktifkan layanan MCP di project Anda dengan perintah berikut:
gcloud beta services mcp enable geminicloudassist.googleapis.com \ --project=PROJECT_IDGanti
PROJECT_IDdengan project ID Google Cloud Anda.Lakukan autentikasi menggunakan Kredensial Default Aplikasi dengan menjalankan perintah berikut:
gcloud auth application-default login
Mengonfigurasi MCP untuk klien Anda
Konfigurasi agen klien bergantung pada agen yang Anda gunakan. Bagian berikut memberikan petunjuk untuk mengonfigurasi MCP untuk berbagai klien.
Untuk mengaktifkan alur kerja desain-ke-deployment penuh, Anda harus mengonfigurasi
klien untuk terhubung ke server MCP Gemini Cloud Assist dan
App Design Center serta menyertakan file SKILL.md yang relevan. Cuplikan berikut menunjukkan konfigurasi gabungan.
Antigravity
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke Antigravity, ikuti petunjuk di Editor Antigravity: Integrasi MCP atau selesaikan langkah-langkah berikut:
-
Instal ekstensi.
Di Antigravity, buka marketplace Ekstensi. Telusuri ekstensi Gemini Cloud Assist, klik Instal, lalu klik Muat Ulang.
-
Konfigurasi server MCP secara manual.
Buka panel Manage MCP Servers dan klik View raw config untuk mengedit file
mcp_config.json. Tambahkan atau gabungkan blok konfigurasi berikut. Penyiapan ini menggunakan Kredensial Default Aplikasi Anda untuk autentikasi.{ "mcpServers": { "gemini_cloud_assist": { "serverUrl": "https://geminicloudassist.googleapis.com/mcp", "headers": {}, "authProviderType": "google_credentials" }, "application_design_center": { "serverUrl": "https://designcenter.googleapis.com/mcp", "headers": {}, "authProviderType": "google_credentials" } } }
-
Verifikasi penyiapan Anda.
Setelah Anda mengubah file
mcp_config.jsondanSKILL.md, mulai ulang Antigravity. Di panel Agen, jalankan perintah garis miring berikut untuk memverifikasi koneksi:/skills list: memverifikasi bahwa kemampuan lokal Anda telah ditemukan./mcp list: memverifikasi bahwa server MCP Gemini Cloud Assist dan App Design Center terhubung.
ChatGPT
Anda harus memiliki langganan ChatGPT Business untuk menggunakan server Google dan Google Cloud MCP dengan ChatGPT.
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke ChatGPT, buat ID klien dan rahasia klien OAuth 2.0, lalu tambahkan server MCP sebagai plugin di ChatGPT:
-
Buat client ID dan secret klien OAuth 2.0:
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Asal JavaScript resmi, klik + Tambahkan URI, lalu masukkan
https://chatgpt.comdi kolom URI.Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://chatgpt.com/connector_platform_oauth_redirectdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Login ke ChatGPT dengan mode developer diaktifkan.
-
Ikuti petunjuk di Membangun plugin untuk menambahkan konektor kustom untuk setiap server MCP:
- Untuk Gemini Cloud Assist, tetapkan URL server ke
https://geminicloudassist.googleapis.com/mcp. - Untuk App Design Center, setel URL server ke
https://designcenter.googleapis.com/mcp.
- Untuk Gemini Cloud Assist, tetapkan URL server ke
-
Di bagian OAuth atau Setelan lanjutan, masukkan ID klien dan rahasia klien OAuth Anda.
-
Selesaikan perintah login untuk mengaktifkan server MCP di chat.
Claude.ai
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke Claude.ai, konfigurasikan konektor kustom dengan client ID dan rahasia klien OAuth 2.0:
-
Buat client ID dan secret klien OAuth 2.0:
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Asal JavaScript resmi, klik + Tambahkan URI, lalu masukkan
https://claude.aidi kolom URI.Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://claude.ai/api/mcp/auth_callbackdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Ikuti petunjuk untuk membuat konektor kustom untuk setiap server MCP:
- Untuk Gemini Cloud Assist, tetapkan URL server ke
https://geminicloudassist.googleapis.com/mcp. - Untuk App Design Center, setel URL server ke
https://designcenter.googleapis.com/mcp.
- Untuk Gemini Cloud Assist, tetapkan URL server ke
-
Di menu Setelan lanjutan, masukkan ID klien dan rahasia klien OAuth Anda.
-
Selesaikan perintah login untuk mengaktifkan server MCP di chat.
Claude Code
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke Claude Code, konfigurasikan konektor kustom dengan ID klien dan rahasia klien OAuth 2.0:
-
Buat client ID dan secret klien OAuth 2.0:
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://claude.ai/api/mcp/auth_callbackdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Ikuti petunjuk untuk membuat konektor kustom untuk setiap server MCP:
- Untuk Gemini Cloud Assist, tetapkan URL server ke
https://geminicloudassist.googleapis.com/mcp. - Untuk App Design Center, setel URL server ke
https://designcenter.googleapis.com/mcp.
- Untuk Gemini Cloud Assist, tetapkan URL server ke
-
Di menu Setelan lanjutan, masukkan ID klien dan rahasia klien OAuth Anda.
-
Selesaikan perintah login untuk mengaktifkan server MCP di chat.
Claude Desktop
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan Pusat Desain Aplikasi ke Claude Desktop, konfigurasikan konektor kustom dengan client ID dan rahasia klien OAuth 2.0:
-
Buat client ID dan secret klien OAuth 2.0:
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://claude.ai/api/mcp/auth_callbackdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Ikuti petunjuk untuk membuat konektor kustom untuk setiap server MCP:
- Untuk Gemini Cloud Assist, tetapkan URL server ke
https://geminicloudassist.googleapis.com/mcp. - Untuk App Design Center, setel URL server ke
https://designcenter.googleapis.com/mcp.
- Untuk Gemini Cloud Assist, tetapkan URL server ke
-
Di menu Setelan lanjutan, masukkan ID klien dan rahasia klien OAuth Anda.
-
Selesaikan perintah login untuk mengaktifkan server MCP di chat.
Codex
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke Codex Enterprise, selesaikan langkah-langkah berikut:
-
Di UI Codex Enterprise, buka Settings, pilih MCP Servers, lalu klik View raw config untuk membuka editor
mcp_config.json. -
Tambahkan atau gabungkan blok konfigurasi berikut ke dalam file
mcp_config.json. Penyiapan ini menggunakan Kredensial Default Aplikasi Anda untuk autentikasi.{ "mcpServers": { "gemini_cloud_assist": { "serverUrl": "https://geminicloudassist.googleapis.com/mcp", "headers": {}, "authProviderType": "google_credentials" }, "application_design_center": { "serverUrl": "https://designcenter.googleapis.com/mcp", "headers": {}, "authProviderType": "google_credentials" } } }
Kursor
Untuk menambahkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center ke Cursor, buat client ID dan rahasia klien OAuth 2.0, lalu konfigurasi server MCP dengan OAuth statis. Cursor menggunakan URI pengalihan yang berbeda, bergantung pada apakah Anda mengakses Cursor melalui web atau aplikasi desktop:
-
Buat client ID dan secret klien OAuth 2.0:
Agen Web atau Kursor
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://www.cursor.com/agents/mcp/oauth/callbackdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
Desktop
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
http://localhost:8787/callbackdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Ikuti petunjuk untuk mengonfigurasi server MCP dengan OAuth statis, dan tambahkan atau gabungkan blok konfigurasi berikut ke konfigurasi MCP Cursor Anda:
{ "mcpServers": { "gemini_cloud_assist": { "url": "https://geminicloudassist.googleapis.com/mcp", "auth": { "CLIENT_ID": "${env:OAUTH_CLIENT_ID}", "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}", "scopes": ["https://www.googleapis.com/auth/cloud-platform"] } }, "application_design_center": { "url": "https://designcenter.googleapis.com/mcp", "auth": { "CLIENT_ID": "${env:OAUTH_CLIENT_ID}", "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}", "scopes": ["https://www.googleapis.com/auth/cloud-platform"] } } } }
-
Tetapkan variabel lingkungan
OAUTH_CLIENT_IDdanOAUTH_CLIENT_SECRETdi lingkungan Anda.
Gemini CLI
Mengonfigurasi menggunakan ekstensi
Instal server MCP sebagai ekstensi Gemini CLI menggunakan perintah berikut:
gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp
Melakukan konfigurasi secara manual
-
Konfigurasi setelan server MCP.
Buka file setelan cakupan pengguna Gemini CLI Anda di
~/.gemini/settings.jsonatau setelan cakupan ruang kerja Anda di.gemini/settings.json. Jika file tidak ada, buat file. Tambahkan atau gabungkan blok konfigurasi berikut di bawah kuncimcpServers. Pastikan file menggunakan format JSON yang valid. Konfigurasi ini otomatis menggunakan Kredensial Default Aplikasi Anda.{ "mcpServers": { "gemini_cloud_assist": { "httpUrl": "https://geminicloudassist.googleapis.com/mcp", "authProviderType": "google_credentials", "oauth": { "scopes": ["https://www.googleapis.com/auth/cloud-platform"] }, "timeout": 600000 }, "application_design_center": { "httpUrl": "https://designcenter.googleapis.com/mcp", "authProviderType": "google_credentials", "oauth": { "scopes": ["https://www.googleapis.com/auth/cloud-platform"] }, "timeout": 600000 } } }
-
Buat dan isi file keahlian Anda.
Buat file
SKILL.mddi salah satu direktori berikut. Salin dan tempel konten Markdown untuk keahlian yang Anda pilih dari bagian referensi keahlian dalam dokumen ini ke dalam file.- Cakupan ruang kerja:
.gemini/skills/SKILL_NAME/ - Cakupan pengguna:
~/.gemini/skills/SKILL_NAME/
Ganti
SKILL_NAMEdengan nama direktori untuk skill Anda.Berikut adalah contoh struktur direktori:
.gemini/ └── skills/ ├── design-and-deploy/ │ └── SKILL.md └── google-gemini-cloud-assist/ └── SKILL.md
- Cakupan ruang kerja:
-
Verifikasi keterampilan Anda.
Setelah Anda mengubah file
settings.jsondanSKILL.md, mulai ulang Gemini CLI, lalu jalankan perintah berikut untuk memverifikasi penyiapan Anda:/skills list: memverifikasi bahwa kemampuan lokal Anda telah ditemukan./mcp list: memverifikasi bahwa server MCP Gemini Cloud Assist dan App Design Center terhubung.
Gemini Enterprise
Untuk mendaftarkan server MCP jarak jauh Gemini Cloud Assist dan App Design Center di Gemini Enterprise, administrator harus menyelesaikan langkah-langkah berikut:
-
Buat client ID dan rahasia klien OAuth 2.0 dengan URI pengalihan Gemini Enterprise:
-
Di konsol Google Cloud , buka Google Auth Platform > Clients > Create client.
Anda akan diminta untuk membuat project jika belum memilih project.
Dalam daftar Jenis aplikasi, pilih aplikasi web.
Di kolom Name, masukkan nama aplikasi Anda.
Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan
https://vertexaisearch.cloud.google.com/oauth-redirectdi kolom URIs.Klik Create. Klien telah dibuat.
Dialog OAuth 2.0 client created akan terbuka.
Di bagian Client secrets, salin Client secret dan simpan di tempat yang aman. Anda hanya dapat menyalinnya satu kali. Jika Anda kehilangan kunci tersebut, hapus rahasia dan buat yang baru.
-
-
Di konsol Google Cloud , buka Gemini Enterprise > Penyimpanan data, lalu klik Buat penyimpanan data. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan datastore server MCP kustom.
-
Pilih Server MCP Kustom sebagai sumber data.
-
Konfigurasi penyimpanan data server MCP kustom untuk setiap endpoint:
- Untuk Gemini Cloud Assist, masukkan
https://geminicloudassist.googleapis.com/mcp. - Untuk App Design Center, masukkan
https://designcenter.googleapis.com/mcp.
- Untuk Gemini Cloud Assist, masukkan
-
Masukkan Client ID dan Client secret OAuth, lalu simpan datastore. Alat tersebut tersedia untuk agen Gemini Enterprise.
Keahlian Gemini Cloud Assist
Alat MCP Gemini Cloud Assist dan App Design Center menggunakan keterampilan agen untuk menginstruksikan agen Anda. Keahlian memandu agen Anda untuk melakukan tugas berikut:
- Rangkai beberapa alat menjadi satu aliran kerja.
- Memproses informasi lokal yang relevan, seperti kode deployment Terraform, untuk mempertimbangkan konteks lokal Anda.
- Merespons pemanggilan eksplisit saat Anda merujuk ke skill secara langsung.
Saat menggunakan agen interaktif seperti Antigravity atau Gemini CLI, Anda dapat mengintegrasikan alat MCP Gemini Cloud Assist dengan agen dan alur kerja lainnya. Karena alat ini menyediakan kemampuan luas yang mungkin tumpang-tindih dengan alat khusus yang sudah ada, gunakan strategi berikut untuk mengoptimalkan lingkungan dan kasus penggunaan spesifik Anda:
- Menyesuaikan definisi skill: Perbarui file
SKILL.mduntuk menentukan niat dan kasus penggunaan yang ingin Anda gunakan untuk memanggil Gemini Cloud Assist. Hal ini memastikan agen hanya dipicu untuk tugas yang memerlukan keahlian cloud yang luas. - Memanggil keterampilan secara eksplisit: Banyak agen interaktif memungkinkan Anda mengontrol
kapan keterampilan dipicu. Jika agen Anda mendukungnya, Anda dapat mengonfigurasi
keterampilan untuk memerlukan pemanggilan manual menggunakan perintah garis miring (
/) atau sebutan @ (@). Pendekatan ini memungkinkan Anda memilih secara tepat kapan harus menggunakan Gemini Cloud Assist versus alat khusus lainnya.
Referensi kemampuan Gemini Cloud Assist
Kami merekomendasikan file SKILL.md berikut di semua agen yang dikonfigurasi dengan alat MCP Gemini Cloud Assist. File ini memandu agen Anda tentang cara menggunakan alat dengan tepat.