Mengonfigurasi server MCP Chat

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

Server MCP Google Chat menyediakan cara standar bagi agen AI untuk:

  • Membaca data: Mencantumkan dan menelusuri percakapan, serta membaca pesan.
  • Menghormati keamanan: Mewarisi izin dan kontrol tata kelola data yang sama dengan pengguna.

Prasyarat

Mengonfigurasi server MCP Google Chat

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

Mengaktifkan API

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

  • Google Chat API

CLI

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

Ganti PROJECT_ID dengan ID project Google Cloud Anda.

Konsol

Aktifkan API di konsol Google Cloud:

Aktifkan API

Mengaktifkan layanan MCP

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

  • Google Chat MCP API

CLI

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

Ganti PROJECT_ID dengan ID project Google Cloud Anda.

Konsol

Aktifkan layanan MCP di Konsol Google Cloud:

Mengaktifkan layanan MCP

Mengonfigurasi aplikasi Chat

Untuk menggunakan server MCP Google Chat guna melakukan operasi hanya baca, seperti menelusuri percakapan, Anda harus mengaktifkan API dan membuat klien OAuth. Aplikasi Chat yang dikonfigurasi tidak diperlukan.

Untuk melakukan operasi tulis, seperti mengirim pesan, 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:

    1. Di kolom Nama aplikasi, masukkan Chat MCP.
    2. Di kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. Di Description, masukkan Chat MCP server.
    4. Di bagian Functionality, nonaktifkan fitur interaktif dengan menonaktifkan Enable interactive features.
    5. Di bagian Logs, pilih Log errors to Logging.

  3. Klik Simpan.

Untuk mempelajari lebih lanjut cara membuat aplikasi Chat, lihat Memilih arsitektur aplikasi Google Chat.

Server MCP Google Chat menggunakan OAuth 2.0 untuk autentikasi dan otorisasi. Anda harus mengonfigurasi layar izin OAuth sebelum dapat membuat client ID OAuth.

  1. Di Konsol Google Cloud, buka Google Auth Platform > Branding.

    Buka Branding

  2. Jika Anda telah mengonfigurasi Google Auth Platform, 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, di App name, ketik Chat MCP Server.
    2. Di User support email, pilih alamat email Anda atau grup Google yang sesuai.
    3. Klik Berikutnya.
    4. Di bagian Audience, pilih Internal. Jika Anda tidak dapat memilih Internal, pilih External.
    5. Klik Berikutnya.
    6. Di bagian Informasi Kontak, masukkan Alamat email tempat Anda dapat diberi tahu tentang perubahan apa pun pada project Anda.
    7. Klik Berikutnya.
    8. Di bagian Finish, tinjau Kebijakan Data Pengguna Layanan Google API dan jika Anda setuju, pilih I agree to the Google API Services: User Data Policy.
    9. Klik Lanjutkan.
    10. Klik Buat.
    11. Jika Anda memilih Eksternal untuk jenis pengguna, tambahkan pengguna uji:
      1. Klik Audiens.
      2. Di bagian Pengguna uji coba, klik Tambahkan pengguna.
      3. Masukkan alamat email Anda dan pengguna uji coba resmi lainnya, lalu klik Save.

  3. Klik Data Access > Add or Remove Scopes. Panel akan muncul dengan daftar cakupan untuk setiap API yang telah Anda aktifkan di project Google Cloud.

    1. Di bagian Manually add scopes, tempel cakupan untuk server MCP 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. Klik Add to Table.

    3. Klik Perbarui.

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

Mengonfigurasi klien MCP Anda

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

Antigravity

Untuk menambahkan server MCP jarak jauh Google Chat 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 OAuth 2.0:

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

      Buka Create Client

    2. Pilih Web application sebagai jenis aplikasi.

    3. Masukkan Nama.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu tambahkan https://antigravity.google/oauth-callback di kolom URIs.

    5. Pilih Gunakan klien ini untuk agen berteknologi AI.

    6. Klik Create, lalu salin Client ID dan Client Secret Anda.

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

  3. Tambahkan konfigurasi mcpServers ke mcp_config.json:

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

    Ganti kode berikut:

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

  4. Hemat mcp_config.json.

  5. Mengautentikasi server MCP. Anda dapat melakukan autentikasi menggunakan setelan GUI atau CLI:

    • Untuk Antigravity IDE atau GUI (Antigravity 2.0):

      1. Buka layar setelan (misalnya, klik Settings di kiri bawah atau buka Antigravity User Settings).
      2. Buka Penyesuaian.
      3. Di bagian Server MCP Terinstal, klik Refresh.
      4. Temukan chat dalam daftar, klik Authenticate, login ke Akun Google Anda, salin kode otorisasi, tempelkan ke dialog input, lalu klik Submit.

    • Untuk Antigravity CLI:

      1. Mulai Antigravity CLI:

        agy

      2. Buka panel pengelolaan MCP interaktif dengan menjalankan:

        /mcp

      3. Gunakan tombol panah untuk memilih chat, pindah ke tindakan Authenticate, lalu tekan Enter. Selesaikan alur login di browser Anda, salin kode otorisasi, tempelkan ke prompt terminal, lalu tekan Enter.

  6. Pastikan server dikonfigurasi dan berjalan dengan benar:

    • Untuk Antigravity IDE atau GUI: Tombol Sign out ditampilkan di samping server MCP 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 mana pun 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 Google Chat dengan Claude.ai atau Claude Desktop, Anda harus memiliki paket Claude Enterprise, Pro, Max, atau Team.

Untuk menambahkan server MCP jarak jauh Google Chat ke Claude, konfigurasikan konektor kustom dengan ID dan rahasia klien OAuth.

  1. Buat client ID dan rahasia OAuth 2.0:

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

      Buka Create Client

    2. Pilih Web application sebagai jenis aplikasi.

    3. Masukkan Nama.

    4. Di bagian Authorized redirect URIs, klik + Add URI, lalu tambahkan https://claude.ai/api/mcp/auth_callback di kolom URIs.

    5. Pilih Gunakan klien ini untuk agen berteknologi AI.

    6. Klik Create, lalu salin Client ID dan Client Secret Anda.

  2. Konfigurasi server MCP di Claude:

    1. Di Claude.ai atau Claude Desktop, buka Settings (atau Admin settings) > Connectors.
    2. Klik Add custom connector.
    3. Masukkan detail koneksi untuk produk Google Chat:
      • Server name: Google Chat.
      • URL server MCP jarak jauh: https://chatmcp.googleapis.com/mcp/v1
    4. Di Advanced settings, masukkan OAuth client ID dan OAuth client secret Anda.
    5. Klik Tambahkan.

Lainnya

Banyak aplikasi AI memiliki cara untuk terhubung ke server MCP jarak jauh. Anda biasanya perlu memasukkan detail tentang server, seperti nama, endpoint, protokol transpor, dan metode autentikasinya. Untuk server MCP jarak jauh Google Chat, masukkan perintah berikut:

  • Nama server: chat

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

  • Transport: HTTP yang dapat di-streaming

  • Autentikasi: Server MCP jarak jauh Google Chat menggunakan OAuth 2.0. Saat membuat klien OAuth 2.0, pilih Gunakan klien ini untuk agen yang didukung AI. Untuk mengetahui detailnya, lihat Mempelajari autentikasi dan otorisasi.

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

Menguji server MCP Google Chat

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

Coba ajukan pertanyaan berikut kepada klien MCP Anda:

  • "Apa pesan terakhir di ruang 'Project X'?"

    Klien menemukan ruang menggunakan search_conversations, lalu mengambil pesan menggunakan list_messages.

Jika alat berhasil dijalankan dan Anda menerima respons yang relevan, berarti server MCP Google Chat Anda telah dikonfigurasi dengan benar.

Pemecahan masalah

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

Jika permintaan Anda ke server MCP ditolak, pastikan klien OAuth 2.0 Anda telah memilih Gunakan klien ini untuk agen yang didukung AI di Google Auth Platform > Klien. Jika Anda tidak dapat mengubah setelan ini di klien OAuth yang ada, buat klien OAuth baru dengan memilih Gunakan klien ini untuk agen yang didukung AI dan update aplikasi Anda untuk menggunakannya. Jika klien OAuth yang ada digunakan untuk fitur agen AI dan non-agen, buat klien OAuth terpisah untuk agen AI dan pertahankan klien yang ada untuk fitur non-agen Anda. Untuk mengetahui petunjuknya, lihat Mengonfigurasi klien MCP dan Mengelola Klien OAuth.

Jika Anda diminta untuk login lagi setiap jam, klien MCP Anda tidak menerima token refresh. Server otorisasi Google hanya mengeluarkan token refresh jika permintaan otorisasi menyertakan access_type=offline; meminta cakupan offline_access OIDC saja tidak cukup. Jika klien MCP Anda mendukung parameter otorisasi kustom, tambahkan access_type=offline ke permintaan otorisasi. Untuk mendapatkan token refresh baru bagi pengguna yang telah memberikan akses, tambahkan juga prompt=consent.

Referensi alat

Alat berikut tersedia untuk server MCP Google Chat:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

Pertimbangan keamanan penting: Injeksi perintah tidak langsung

Saat Anda mengekspos model bahasa ke data yang tidak tepercaya, ada risiko serangan injeksi perintah tidak langsung. Karena host MCP seperti Google Antigravity memiliki akses ke alat dan API canggih melalui server MCP Google Chat, host tersebut 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 tepercaya. Jangan pernah menghubungkan server MCP Google Chat ke aplikasi yang tidak tepercaya atau tidak diverifikasi.
  • Berhati-hatilah dengan input yang tidak tepercaya. Hindari meminta klien MCP Anda untuk memproses pesan atau resource lain dari sumber yang tidak terverifikasi. Input ini mungkin berisi petunjuk tersembunyi yang dapat membajak sesi Anda, sehingga penyerang dapat mengubah, mencuri, atau menghapus data Anda.
  • Tinjau semua tindakan. Selalu tinjau dengan cermat tindakan yang dilakukan oleh klien AI Anda atas nama Anda untuk memastikan tindakan tersebut benar dan sesuai dengan niat Anda.