Server MCP Google Workspace di Google Antigravity 2.0, IDE, dan/atau CLI

1. Pengantar

Catatan: Apakah Anda masih menggunakan Gemini CLI? Panduan ini membahas Antigravity CLI. Informasi selengkapnya tentang cara melakukan transisi dapat ditemukan di postingan blog resmi Antigravity CLI ini.

Menggunakan Gemini Enterprise? Jika organisasi Anda menggunakan Gemini Enterprise, administrator pelanggan yang memenuhi syarat dapat mengelola dan mengizinkan server MCP yang disetujui secara terpusat. Pelajari lebih lanjut di postingan blog Antigravity Enterprise dan Codelab Server MCP Google Workspace dengan Antigravity di Gemini Enterprise pendamping kami.

Dalam codelab ini, Anda akan mempelajari cara menggunakan Model Context Protocol (MCP) untuk menghubungkan data Google Workspace ke Antigravity 2.0, IDE, dan/atau CLI. MCP adalah standar terbuka yang memungkinkan model AI menggunakan alat yang disediakan oleh server jarak jauh dengan aman. Anda akan menyiapkan Antigravity untuk berinteraksi dengan Gmail, Google Drive, Google Dokumen, Google Spreadsheet, Google Slide, Google Kalender, Google Chat, dan People API tanpa menulis kode apa pun.

Yang akan Anda lakukan

• Aktifkan layanan MCP Google Workspace di project Google Cloud Anda.
• Konfigurasikan Antigravity untuk mengakses layanan MCP ini.
• Uji integrasi dengan perintah yang menyenangkan dan berguna yang berinteraksi dengan data Google Workspace Anda.

Yang Anda butuhkan

• Browser web seperti Chrome
• Project Google Cloud yang terdaftar dalam Program Pratinjau Developer Google Workspace
• Akun Google Workspace
• Antigravity 2.0, IDE, dan/atau CLI yang diinstal di komputer lokal Anda. Anda dapat menemukan detail dan panduan penginstalan selengkapnya dari situs resmi.

Akses mudah ke codelab ini

2. Sebelum memulai

Program Pratinjau Developer Google Workspace: Akses ke server MCP Google Workspace adalah bagian dari Program Pratinjau Developer Publik. Jika Anda belum melakukannya, daftar dan pastikan akun Anda diterima dalam program di https://developers.google.com/workspace/preview.

Prasyarat Enterprise: Untuk pelanggan yang memenuhi syarat, jika organisasi Anda menerapkan kebijakan Gemini Enterprise, administrator Anda harus mengaktifkan Alat Developer AI terlebih dahulu dan mengizinkan endpoint server MCP Google Workspace di Konsol Cloud sebelum Anda dapat terhubung. Pelajari lebih lanjut di postingan blog Antigravity Enterprise dan Codelab Server MCP Google Workspace dengan Antigravity di Gemini Enterprise pendamping kami.

Membuat atau Memilih project Google Cloud

Di Konsol Google Cloud, pilih atau buat project Google Cloud.

Mengaktifkan API

Untuk menggunakan server MCP Google Workspace, Anda harus mengaktifkan API Google Workspace standar.

Aktifkan API

Mengaktifkan Layanan MCP

Selanjutnya, aktifkan layanan MCP Google Workspace.

Mengaktifkan layanan MCP

Mengonfigurasi Aplikasi Chat

Untuk menggunakan server MCP Google Chat, Anda harus mengonfigurasi aplikasi Chat di project Google Cloud Anda.

1. Di Konsol Google Cloud, telusuri Google Chat API, lalu klik Google Chat API > Manage > Configuration.

Buka Google Chat API

2. Siapkan aplikasi Chat:
   • Di kolom App name, masukkan Chat MCP.
   • Di kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • Di Description, masukkan Chat MCP server.
   • Di bagian Fungsi, nonaktifkan Aktifkan fitur interaktif.
   • Di bagian Logs, pilih Log errors to Logging.
3. Klik Simpan.

3. Mengonfigurasi Izin OAuth dan Klien

Catatan Enterprise: Di lingkungan Google Workspace perusahaan, administrator Cloud atau Gemini Enterprise Anda biasanya menyediakan layar izin OAuth dan Client ID secara terpusat. Jika administrator telah memberi Anda Client ID yang disetujui, Anda dapat melewati langkah ini dan langsung melanjutkan ke Mengonfigurasi Antigravity.

Server MCP Google Workspace menggunakan OAuth 2.0 untuk autentikasi dan otorisasi yang aman. Anda harus mengonfigurasi layar izin OAuth dan membuat klien Aplikasi web.

Menyiapkan Layar Izin OAuth

Anda harus mengonfigurasi layar izin terlebih dahulu.

1. Di Konsol Google Cloud, buka Google Auth Platform > Branding. Klik Get Started jika belum dikonfigurasi.
2. Konfigurasikan App Information:
   • Nama aplikasi: Google Workspace MCP Servers
   • User support email: Pilih email Anda.
3. Konfigurasikan Audience: Pilih Internal (atau External jika Internal tidak tersedia).
4. Konfigurasikan Contact Information: Masukkan alamat email Anda.
5. Tinjau dan setujui Kebijakan Data Pengguna, lalu klik Buat.
6. Jika Anda memilih Eksternal, buka Audiens dan tambahkan email Anda di bagian Pengguna uji coba.
7. Buka Akses Data > Tambahkan atau Hapus Cakupan. Di bagian Tambahkan cakupan secara manual, tambahkan hal berikut untuk server yang ingin Anda gunakan:
   • Universal: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Google Dokumen: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
   • Google Spreadsheet: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
   • Google Slide: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
   • Google Kalender: https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Klik Add to Table, lalu Update, dan terakhir Save.

Membuat Client ID OAuth

1. Buka Google Auth Platform > Clients > Create Client.
2. Pilih Web application sebagai jenis aplikasi.
3. Beri nama Antigravity.
4. Di bagian Authorized redirect URIs, klik + Add URI, lalu masukkan https://antigravity.google/oauth-callback.
5. Pilih Gunakan klien ini untuk agen berteknologi AI.
6. Klik Create, lalu salin Client ID dan Client Secret. Anda akan membutuhkannya pada langkah berikutnya.

4. Mengonfigurasi Antigravity

Sekarang, mari kita konfigurasi Antigravity untuk menggunakan endpoint ini. Jika Anda belum menginstal Antigravity 2.0, IDE, dan/atau CLI, ikuti petunjuk di situs Antigravity.

Menambahkan server MCP kustom

Antigravity 2.0, IDE, dan CLI berbagi konfigurasi MCP pusat dalam file ~/.gemini/config/mcp_config.json.

1. Buka file tersebut di editor teks pilihan Anda.

   Catatan: Anda dapat mengakses file langsung dari Antigravity IDE jika sudah menginstalnya dengan mengikuti langkah-langkah berikut:

   1. Buka server MCP melalui dropdown ... di bagian atas panel agen editor.
   2. Klik Manage server MCP, lalu View raw config.
2. Ubah konfigurasi server MCP kustom berikut. Sebelum melakukannya, ganti placeholder <YOUR_CLIENT_ID> dan <YOUR_CLIENT_SECRET> dengan client ID dan rahasia OAuth yang Anda buat di langkah sebelumnya.
3. Simpan.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Mengautentikasi server MCP kustom

Anda akan melihat semua server MCP yang Anda konfigurasi sebagai terinstal di Antigravity: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat, dan gws-people. Anda harus mengautentikasi setiap akun untuk setiap platform Antigravity karena token OAuth tidak terpusat.

Memecahkan Masalah Error Kebijakan Enterprise: Jika server MCP menampilkan Unauthorized / Blocked by Admin Policy setelah mengklik Refresh, layanan tersebut tidak disertakan dalam daftar yang diizinkan Gemini Enterprise organisasi Anda. Hubungi administrator Anda untuk menambahkan endpoint layanan, dan bagikan Codelab Admin Gemini Enterprise kepada mereka untuk mendapatkan panduan konfigurasi.

Antigravity 2.0

1. Klik Setelan di kiri bawah.
2. Buka Penyesuaian.
3. Di bagian Server MCP Terinstal, klik Refresh.

4. Untuk setiap server MCP yang terinstal dan tercantum:
   1. Klik Autentikasikan.
   
   2. Lakukan alur autentikasi di jendela browser baru yang terbuka.
   3. Setelah selesai, klik Copy to Clipboard.
   
   4. Tempel kode autentikasi yang baru saja Anda salin di kolom teks yang ditampilkan di setelan Antigravity 2.0, lalu klik Submit.
   
   5. Tombol Sign out kini ditampilkan menggantikan Authenticate.
   

Antigravity IDE

1. Buka Antigravity User Settings melalui dropdown menu Editor-Specific settings di bagian atas jendela.

2. Buka Penyesuaian.
3. Di bagian Server MCP Terinstal, klik Refresh.

4. Untuk setiap server MCP yang terinstal dan tercantum:
   1. Klik Autentikasikan.
   
   2. Lakukan alur autentikasi di jendela browser baru yang terbuka.
   3. Setelah selesai, klik Copy to Clipboard.
   
   4. Tempel kode autentikasi yang baru saja Anda salin di kolom teks yang ditampilkan di setelan Antigravity IDE, lalu klik Submit.
   
   5. Tombol Sign out kini ditampilkan menggantikan Authenticate.
   

Antigravity CLI

1. Ketik /mcp dan tekan enter.

2. Untuk setiap server MCP yang tercantum:
   1. Pilih menggunakan tombol panah atas dan bawah, lalu tekan enter.
   2. Pilih Authenticate menggunakan tombol panah kiri dan kanan, lalu tekan enter.
   
   3. Buka URL yang ditampilkan di jendela browser baru dan ikuti alur autentikasi.
   
   4. Setelah selesai, klik Copy to Clipboard.
   
   5. Tempel kode autentikasi yang baru saja Anda salin di kolom teks yang ditampilkan di terminal dengan Antigravity CLI yang berjalan, lalu tekan enter.
   
   6. Status Authed kini ditampilkan menggantikan Auth Needed.
   

5. Alat pengujian

Sekarang Anda dapat berinteraksi dengan data Google Workspace menggunakan bahasa alami. Berikut beberapa contoh perintah untuk setiap layanan.

Catatan: Ganti placeholder dalam tanda kurung pada perintah di bawah (misalnya, [NAME], [FILE_NAME]) dengan nilai sebenarnya dari data Google Workspace Anda sendiri.

Universal

Coba telusuri di berbagai produk:

• "Ringkas dalam beberapa kalimat apa yang terakhir terjadi di akun Google Workspace saya."
• "Temukan apa pun yang terkait dengan [PROJECT_NAME] di email, dokumen, dan pesan chat saya."
• "Kapan rapat saya berikutnya tentang rencana pemasaran, dan apa catatan serta pesan chat terbaru tentang rapat tersebut?"

Gmail

Coba telusuri atau kelola email Anda:

• "Rangkum 5 email terakhir yang saya terima."
• "Buat draf email ke ‘[EMAIL_ADDRESS]' untuk meminta info terbaru tentang project ‘[PROJECT_NAME]'."

Google Drive

Coba telusuri atau baca file:

• "Telusuri file di Google Drive saya yang berisi ‘[KATA KUNCI]'."
• "Tampilkan daftar dokumen terbaru yang saya edit."
• "Baca konten dokumen ‘[FILE_NAME]' saya dan rangkum sasaran utamanya."

Google Dokumen, Spreadsheet, Slide

Coba telusuri referensi Drive Anda:

• "Tampilkan konten struktural Dokumen Google [DOCS_TITLE]."
• "Baca sheet Sheet1 dari Spreadsheet Google [SHEETS_TITLE]"
• "Tampilkan tata letak lisan Google Slide [SLIDES_TITLE]."

Google Kalender

Coba telusuri jadwal Anda:

• "Apa saja rapat saya yang akan datang minggu ini?"
• "Apakah saya punya waktu luang besok sore?"

Google Chat

Coba telusuri pesan:

• "Cari pesan yang berisi ‘[KATA KUNCI]' di ‘[NAMA_RUANG]'"

People API

Coba telusuri profil atau kontak Anda:

• "Menurut profil Google saya, siapa nama saya?"
• "Temukan info kontak untuk ‘[NAMA]'."

Menggabungkan Beberapa Layanan

Kekuatan MCP yang sebenarnya terlihat saat mengorkestrasi tugas di beberapa layanan. Coba perintah berikut yang menunjukkan kemampuan lintas layanan:

• "Telusuri file di Drive yang terkait dengan ‘pembaruan pencapaian [NAMA_PROJECT]', ringkas kontennya, temukan alamat email untuk ‘[NAMA]', dan buat draf Gmail untuknya dengan ringkasan tersebut."

Jelajahi Alat Lainnya

Ini hanyalah beberapa contoh hal yang dapat Anda lakukan. Untuk melihat daftar lengkap alat yang tersedia untuk setiap layanan dan mencobanya, lihat bagian Produk yang Didukung dalam dokumentasi resmi.

6. Pembersihan

Untuk membersihkan project tanpa menghapusnya, Anda dapat menonaktifkan API dan layanan MCP yang Anda aktifkan:

1. Di Konsol Google Cloud, buka Dasbor API & Layanan.
2. Klik setiap API Google Workspace dan MCP yang Anda aktifkan (misalnya, Calendar MCP, Chat MCP), lalu klik Disable API.

Hapus kredensial klien OAuth di konsol Google Auth Platform jika Anda tidak lagi berencana menggunakannya.

7. Selamat

Selamat! Anda telah berhasil mengonfigurasi dan menguji server MCP Google Workspace resmi menggunakan Antigravity.

Dokumen referensi

• Pengantar Model Context Protocol (MCP)
• Mengonfigurasi Server MCP Google Workspace
• Mengonfigurasi Izin OAuth
• Ringkasan Antigravity Enterprise
• Codelab Server MCP Google Workspace dengan Antigravity di Gemini Enterprise
• Antigravity