Server MCP Google Workspace di Antigravity

1. Pengantar

Catatan: Menggunakan Gemini CLI? Buka codelab ini. Panduan ini khusus untuk Antigravity.

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

Yang akan Anda lakukan

• Mengaktifkan layanan MCP Google Workspace di project Google Cloud Anda.
• Mengonfigurasi Antigravity untuk mengakses layanan MCP ini.
• Menguji integrasi dengan perintah yang menyenangkan dan berguna yang berinteraksi dengan data Google Workspace Anda.

Yang akan Anda butuhkan

• Browser web seperti Chrome
• Project Google Cloud
• Akun Google Workspace
• Antigravity diinstal di komputer lokal Anda

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 belum, harap daftar dan pastikan akun Anda diterima ke dalam program di https://developers.google.com/workspace/preview.

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 Google Workspace API standar. Meskipun beberapa server MCP beroperasi secara independen, server lainnya masih memerlukan API standar yang mendasarinya untuk diaktifkan:

• Gmail dan Chat masih memerlukan API standarnya.
• Drive memerlukan API standar untuk alat tertentu.
• Kalender tidak memerlukan API standar untuk diaktifkan.
• People API menangani akses standar dan fungsi MCP, sehingga tidak memiliki layanan MCP terpisah untuk diaktifkan.

Mengaktifkan API

Mengaktifkan Layanan MCP

Selanjutnya, aktifkan layanan MCP khusus untuk produk.

Mengaktifkan layanan MCP

Mengonfigurasi Aplikasi Chat

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

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 Functionality, nonaktifkan Enable interactive features.
   • Di bagian Logs, pilih Log errors to Logging.
3. Klik Save.

3. Mengonfigurasi Izin dan Klien OAuth

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

Menyiapkan Layar Izin OAuth

Server MCP Google Workspace menggunakan OAuth 2.0 untuk autentikasi. 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:
   • App name: 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 Create.
6. Jika Anda memilih External, buka Audience dan tambahkan email Anda di bagian Test users.
7. Buka Data Access > Add or Remove Scopes. Di bagian Manually add scopes, tambahkan hal berikut untuk server yang ingin Anda gunakan:
   • Google Calendar: 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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. Klik Create dan salin Client ID dan Client Secret. Anda akan memerlukannya pada langkah berikutnya.

4. Mengonfigurasi Antigravity

Sekarang, mari kita konfigurasi Antigravity untuk menggunakan endpoint ini. Jika Anda belum menginstal Antigravity, ikuti petunjuk penginstalan di situs Antigravity.

Menambahkan server MCP kustom

1. Buka MCP Servers melalui dropdown ... di bagian atas panel agen editor.

2. Klik Manage MCP Servers , lalu View raw config.

4. Ubah file mcp_config.json yang baru dibuka dengan 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 pada langkah sebelumnya:

{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

5. Kembali ke Manage MCP Servers , lalu klik Refresh.

Mengautentikasi server MCP kustom

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

2. Buka Customizations.

3. Untuk setiap server yang tercantum di bagian INSTALLED MCP SERVERS:
   1. Klik Authenticate.

2. Ikuti alur autentikasi di jendela browser baru yang terbuka.
3. Setelah selesai, klik Copy to Clipboard.

4. Tutup jendela browser.
5. Tempel kode autentikasi yang baru saja Anda salin di kolom teks yang ditampilkan di setelan Antigravity.
6. Klik Submit.

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 di perintah di bawah (misalnya, [NAME], [FILE_NAME]) dengan nilai sebenarnya dari data Google Workspace Anda sendiri.

Google Kalender

Coba telusuri jadwal Anda:

• "What are my upcoming meetings this week?"
• "Do I have any free time tomorrow afternoon?"

Google Chat

Coba telusuri pesan:

• "Look for messages containing ‘[KEYWORD]' in ‘[SPACE_NAME]'"

Google Drive

Coba telusuri atau baca file:

• "Search for files on my Google Drive that contain ‘[KEYWORD]'."
• "List the most recent documents I edited."
• "Read the content of my ‘[FILE_NAME]' doc and summarize the main goals."

Gmail

Coba telusuri atau kelola email Anda:

• "Summarize the last 5 emails I received."
• "Draft an email to ‘[EMAIL_ADDRESS]' requesting an update on the ‘[PROJECT_NAME]' project."

People API

Coba telusuri profil atau kontak Anda:

• "According to my Google profile, what is my name?"
• "Find contact info for ‘[NAME]'."

Menggabungkan Beberapa Layanan

Kekuatan MCP yang sesungguhnya terwujud saat mengatur tugas di beberapa layanan. Coba perintah berikut yang menunjukkan kemampuan lintas layanan:

• "Search for files in Drive related to ‘[PROJECT_NAME] milestone updates', summarize their content, find the email address for ‘[NAME]', and create a Gmail draft to them with the summary."

Menjelajahi 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 Google Workspace dan MCP API 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
• Editor Antigravity: Integrasi MCP