Mulai menggunakan MCP Google Workspace dan Gemini CLI

1. Pengantar

Dalam codelab ini, Anda akan mempelajari cara menggunakan Model Context Protocol (MCP) untuk menghubungkan Gemini CLI ke data Google Workspace Anda. MCP adalah standar terbuka yang memungkinkan model AI menggunakan alat yang disediakan oleh server jarak jauh secara aman. Anda akan menggunakan Gemini CLI sebagai klien untuk berinteraksi dengan Gmail, Google Drive, 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.
• Konfigurasi Gemini CLI untuk menggunakan 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
• Akun Google Workspace
• Gemini CLI diinstal di mesin lokal Anda

Codelab ini akan membutuhkan waktu sekitar 30 menit untuk diselesaikan.

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.

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 pengaktifan API standar yang mendasarinya:

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

Aktifkan 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 Anda.

1. Di Konsol Google Cloud, cari Google Chat API, lalu klik Google Chat API > Manage > Configuration.Buka Google Chat API
2. Siapkan aplikasi Chat:
   • Di kolom Nama aplikasi, masukkan Chat MCP.
   • Di kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • Di Deskripsi, masukkan Chat MCP server.
   • Di bagian Fungsi, nonaktifkan fitur interaktif dengan menonaktifkan Aktifkan fitur interaktif.
   • Di bagian Logs, pilih Log errors to Logging.
3. Klik Simpan.

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 Desktop.

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 Mulai jika belum dikonfigurasi.
2. Konfigurasi Informasi Aplikasi:
   • Nama aplikasi: Google Workspace MCP Servers
   • Email dukungan pengguna: Pilih email Anda.
3. Konfigurasi Audience: Pilih Internal (atau External jika Internal tidak tersedia).
4. Konfigurasi Informasi Kontak: 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 penguji.
7. Buka Akses Data > Tambahkan atau Hapus Cakupan. Di bagian Tambahkan cakupan secara manual, tambahkan berikut untuk server yang ingin Anda gunakan:
   • 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.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 Tambahkan ke Tabel, lalu Perbarui, dan terakhir Simpan.

Buat ID Klien OAuth

1. Buka Google Auth Platform > Clients > Create Client.
2. Pilih Aplikasi desktop sebagai jenis aplikasi.
3. Beri nama Gemini CLI.
4. Klik Buat, lalu salin Client ID dan Client Secret. Anda akan membutuhkannya pada langkah berikutnya.

4. Mengonfigurasi Gemini CLI

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

Lingkungan Lokal Diperlukan: Jangan gunakan Cloud Shell untuk langkah ini. Gemini CLI memerlukan browser lokal untuk autentikasi OAuth. Gunakan terminal komputer lokal Anda. Lihat Persyaratan pengalihan browser untuk informasi selengkapnya.

Membuat file konfigurasi

Buka atau buat ~/.gemini/settings.json di direktori beranda Anda, lalu tambahkan konfigurasi berikut. Ganti placeholder dengan kredensial OAuth Anda.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Mengautentikasi dan Memverifikasi Server MCP

Sebelum dapat menggunakan server MCP, Anda harus melakukan autentikasi dan memverifikasi bahwa server tersebut terhubung.

Mulai Gemini CLI

Jalankan perintah berikut di terminal Anda untuk memulai Gemini CLI:

gemini

Autentikasikan

Lakukan autentikasi dengan layanan yang ingin Anda uji dengan menjalankan perintah yang sesuai di Gemini CLI. Anda hanya perlu melakukan autentikasi dengan layanan yang akan digunakan dalam codelab ini.

Kalender

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Orang

/mcp auth people

Ikuti perintah di browser Anda untuk memberikan otorisasi pada setiap layanan.

Verifikasi Koneksi

Pastikan alat dimuat dan siap:

/mcp list

Anda akan melihat output yang menunjukkan bahwa layanan tersebut Ready dengan alatnya yang tercantum.

6. Menguji Server MCP

Sekarang Anda dapat berinteraksi dengan data Google Workspace Anda 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 tanyakan jadwal Anda kepada Gemini:

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

Google Chat

Coba minta Gemini untuk menelusuri pesan:

• "Cari pesan yang berisi '[KEYWORD]' di '[SPACE_NAME]'"

Google Drive

Coba minta Gemini untuk menemukan atau membaca file:

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

Gmail

Coba minta Gemini untuk menelusuri atau mengelola email Anda:

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

People API

Coba tanyakan profil atau kontak Anda kepada Gemini:

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

Menggabungkan Beberapa Layanan

Kecanggihan MCP yang sesungguhnya akan terlihat saat Gemini mengorkestrasi tugas di beberapa layanan. Coba perintah berikut yang menunjukkan kemampuan lintas layanan:

• "Cari file di Drive yang terkait dengan 'info terbaru pencapaian [PROJECT_NAME]', ringkas kontennya, temukan alamat email '[NAME]', dan buat draf email 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.

7. 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 MCP dan Google Workspace 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.

8. Selamat

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

Yang telah Anda pelajari

• Cara mengaktifkan layanan MCP Google Workspace di Google Cloud.
• Cara mengonfigurasi klien OAuth untuk MCP.
• Cara menggunakan Gemini CLI untuk berinteraksi dengan data Google Workspace menggunakan alat standar.

Dokumen referensi

• Pengantar Model Context Protocol (MCP)
• Mengonfigurasi Server MCP Google Workspace
• Mengonfigurasi Izin OAuth