Mengonfigurasi server MCP Kalender

Google Kalender menawarkan server Model Context Protocol (MCP) jarak jauh yang memungkinkan agen AI berinteraksi dengan data Kalender secara aman. Dengan mengonfigurasi server MCP Kalender, Anda memungkinkan aplikasi AI seperti Google Antigravity dan Claude melakukan tindakan di Kalender.

Server MCP Kalender menyediakan cara standar bagi agen AI untuk:

  • Membaca data: Mencantumkan kalender, mengambil acara, dan memeriksa ketersediaan.
  • Mengambil tindakan: Membuat, memperbarui, dan menghapus acara.
  • Menghormati keamanan: Mewarisi izin dan kontrol tata kelola data yang sama dengan pengguna.

Prasyarat

Mengonfigurasi server MCP Kalender

Untuk menggunakan server MCP Kalender, Anda harus mengaktifkannya di project Cloud Anda, lalu mengonfigurasi klien MCP Anda untuk terhubung ke server tersebut.

Mengaktifkan API

Untuk menggunakan server MCP Kalender, Anda harus mengaktifkan API berikut di project Cloud Anda:

  • Google Calendar API

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Konsol

Aktifkan API di konsol:

Aktifkan API

Aktifkan layanan MCP

Untuk mengaktifkan komponen MCP untuk Kalender, Anda harus mengaktifkan layanan berikut di project Cloud Anda:

  • Calendar MCP API

CLI

gcloud services enable calendarmcp.googleapis.com --project=PROJECT_ID

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Konsol

Aktifkan layanan MCP di konsol:

Mengaktifkan layanan MCP

Server MCP Kalender menggunakan OAuth 2.0 untuk autentikasi dan otorisasi. Anda harus mengonfigurasi layar izin OAuth sebelum dapat membuat ID klien OAuth.

  1. Di konsol, buka Google Auth Platform > Branding.

    Buka Branding

  2. Jika sudah mengonfigurasi Platform Auth Google, Anda dapat mengonfigurasi setelan layar izin OAuth berikut di Branding, Audiens, dan Akses Data. Jika Anda melihat pesan yang menyatakan Google Auth Platform not configured yet, klik Get Started:

    1. Di bagian App Information, pada App name, ketik Calendar MCP Server.
    2. Di User support email, pilih alamat email Anda atau Grup Google yang sesuai.
    3. Klik Berikutnya.
    4. Di bagian Audiens, pilih Internal. Jika Anda tidak dapat memilih Internal, pilih Eksternal.
    5. Klik Berikutnya.
    6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
    7. Klik Berikutnya.
    8. Di bagian Selesai, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih Saya menyetujui Layanan Google API: Kebijakan Data Pengguna.
    9. Klik Lanjutkan.
    10. Klik Buat.
    11. Jika Anda memilih Eksternal untuk jenis pengguna, tambahkan pengguna penguji:
      1. Klik Audiens.
      2. Di bagian Pengguna pengujian, klik Tambahkan pengguna.
      3. Masukkan alamat email Anda dan pengguna uji resmi lainnya, lalu klik Simpan.

  3. Klik Akses Data > Tambahkan atau Hapus Cakupan. Panel akan muncul dengan daftar cakupan untuk setiap API yang telah Anda aktifkan di project Cloud Anda.

    1. Di bagian Tambahkan cakupan secara manual, tempel cakupan untuk server MCP 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

    2. Klik Tambahkan ke Tabel.

    3. Klik Perbarui.

    4. Setelah memilih cakupan yang diperlukan oleh aplikasi Anda, di halaman Akses Data, klik Simpan.

Mengonfigurasi klien MCP

Untuk menambahkan server MCP jarak jauh Kalender ke klien MCP Anda, ikuti petunjuk untuk klien Anda.

Antigravity

Untuk menambahkan server MCP jarak jauh Kalender ke Antigravity, tambahkan konfigurasi server ke file mcp_config.json Anda. Petunjuk ini mendukung Antigravity 2.0, Antigravity IDE, dan Antigravity CLI.

  1. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di konsol, buka Google Auth Platform > Clients > Create Client

      Buka Buat Klien

    2. Pilih Web application sebagai jenis aplikasi.

    3. Masukkan Nama.

    4. Di bagian URI pengalihan yang diberi otorisasi, klik + Tambahkan URI, lalu tambahkan https://antigravity.google/oauth-callback di kolom URI.

    5. Klik Buat, lalu salin Client ID dan Client Secret Anda.

  2. Buka atau buat file konfigurasi ~/.gemini/antigravity/mcp_config.json.

  3. Tambahkan konfigurasi mcpServers ke mcp_config.json:

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Ganti kode berikut:

    • OAUTH_CLIENT_ID: ID klien yang Anda buat.
    • OAUTH_CLIENT_SECRET: Rahasia klien yang Anda buat.

  4. Hemat mcp_config.json.

  5. Lakukan autentikasi server MCP menggunakan setelan GUI atau CLI:

    • Untuk Antigravity IDE atau GUI (Antigravity 2.0):

      1. Buka layar setelan Anda (misalnya, klik Setelan di kiri bawah atau buka Setelan Pengguna Antigravitasi).
      2. Buka Penyesuaian.
      3. Di bagian Server MCP yang Terinstal, klik Muat ulang.
      4. Temukan calendar dalam daftar, klik Autentikasi, login ke Akun Google Anda, salin kode otorisasi, tempelkan ke dialog input, lalu klik Kirim.

    • Untuk Antigravity CLI:

      1. Mulai Antigravity CLI:

        agy

      2. Buka panel pengelolaan MCP interaktif dengan menjalankan:

        /mcp

      3. Gunakan tombol panah untuk memilih calendar, pindah ke tindakan Autentikasi, lalu tekan Enter. Selesaikan alur login di browser Anda, salin kode otorisasi, tempel ke perintah terminal, lalu tekan Enter.

  6. Pastikan server dikonfigurasi dan berjalan dengan benar:

    • Untuk Antigravity IDE atau GUI: Tombol Logout ditampilkan di samping server di bagian Customizations > Installed MCP Servers.
    • Untuk Antigravity CLI: Buka panel /mcp untuk melihat server MCP yang dikonfigurasi. Server yang diverifikasi dan diautentikasi menampilkan Authed di samping namanya di dalam panel TUI interaktif. Anda dapat memilih server di tampilan dasbor untuk memeriksa statusnya dan mencantumkan semua alat yang tersedia.

Server MCP jarak jauh siap digunakan di Antigravity.

Claude

Untuk menggunakan server MCP jarak jauh Kalender dengan Claude.ai atau Claude Desktop, Anda harus memiliki paket Claude Enterprise, Pro, Max, atau Team.

Untuk menambahkan server MCP jarak jauh Kalender ke Claude, konfigurasi konektor kustom dengan ID dan rahasia klien OAuth.

  1. Buat client ID dan rahasia klien OAuth 2.0:

    1. Di konsol, buka Google Auth Platform > Clients > Create Client

      Buka Buat Klien

    2. Pilih Web application sebagai jenis aplikasi.

    3. Masukkan Nama.

    4. Di bagian URI pengalihan yang diberi otorisasi, klik + Tambahkan URI, lalu tambahkan https://claude.ai/api/mcp/auth_callback di kolom URI.

    5. Klik Buat, lalu salin Client ID dan Client Secret Anda.

  2. Mengonfigurasi server MCP di Claude:

    1. Di Claude.ai atau Claude Desktop, buka Settings (atau Admin settings) > Connectors.
    2. Klik Tambahkan konektor kustom.
    3. Masukkan detail koneksi untuk produk Kalender:
      • Nama server: Calendar.
      • URL server MCP jarak jauh: https://calendarmcp.googleapis.com/mcp/v1
    4. Di Setelan lanjutan, masukkan ID klien OAuth dan rahasia klien OAuth Anda.
    5. Klik Tambahkan.

Lainnya

Banyak aplikasi AI memiliki cara untuk terhubung ke server MCP jarak jauh. Biasanya, Anda perlu memasukkan detail tentang server, seperti nama, endpoint, protokol transportasi, dan metode autentikasinya. Untuk server MCP jarak jauh Kalender, masukkan berikut ini:

  • Nama server: calendar

  • URL Server: https://calendarmcp.googleapis.com/mcp/v1

  • Transportasi: HTTP

  • Autentikasi: Server MCP jarak jauh Kalender menggunakan OAuth 2.0. Untuk mengetahui detailnya, lihat Mempelajari autentikasi dan otorisasi.

Untuk mengetahui detail selengkapnya tentang cara menghubungkan berbagai jenis klien, lihat Mengonfigurasi MCP dalam aplikasi AI.

Menguji server MCP Kalender

Setelah mengonfigurasi klien MCP, Anda dapat memverifikasi koneksi dengan menjalankan beberapa perintah pengujian.

Coba ajukan pertanyaan berikut kepada klien MCP Anda:

  • "When is my next meeting with Ariel?" (Kapan pertemuan saya berikutnya dengan Ariel?)

    Klien memeriksa jadwal Anda menggunakan calendar.list_events dan merinci rapat Anda berikutnya dengan Ariel.

Jika alat berhasil dieksekusi dan Anda menerima respons yang relevan, server MCP Kalender Anda telah dikonfigurasi dengan benar.

Pemecahan masalah

Jika Anda mengalami masalah saat menghubungkan ke server MCP, periksa error di log OAuth. Minta administrator untuk memeriksa peristiwa log OAuth di alat investigasi keamanan.

Referensi alat

Alat berikut tersedia untuk server MCP Kalender:

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

Pertimbangan keamanan: Injeksi perintah tidak langsung

Saat Anda mengekspos model bahasa ke data yang tidak tepercaya, ada risiko terjadinya serangan injeksi perintah tidak langsung. Karena host MCP seperti Google Antigravity memiliki akses ke alat dan API canggih melalui server MCP Kalender, mereka dapat membaca, mengubah, dan menghapus data di Akun Google Anda.

Untuk mengurangi risiko ini, Anda harus menyaring perintah dan respons untuk mendeteksi konten berbahaya atau serangan injeksi perintah. Anda dapat menggunakan Model Armor yang disediakan Google atau menggunakan solusi Anda sendiri jika Anda mendokumentasikannya agar pengguna menerima risiko tersebut. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi keamanan untuk server MCP Google Workspace.

Ikuti praktik terbaik berikut:

  • Hanya gunakan alat yang tepercaya. Jangan pernah menghubungkan server MCP Kalender ke aplikasi yang tidak tepercaya atau tidak terverifikasi.
  • Berhati-hatilah dengan input yang tidak tepercaya. Hindari meminta klien MCP Anda untuk memproses peristiwa atau resource lain dari sumber yang tidak terverifikasi. Input ini mungkin berisi petunjuk tersembunyi yang dapat membajak sesi Anda, sehingga memungkinkan penyerang mengubah, mencuri, atau menghapus data Anda.
  • Tinjau semua tindakan. Selalu tinjau dengan cermat tindakan yang dilakukan oleh klien AI atas nama Anda untuk memastikan tindakan tersebut sudah benar dan sesuai dengan maksud Anda.