Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengizinkan agen AI menelusuri seluruh workspace dengan Server MCP Penelusuran Universal untuk Workspace

Server MCP Penelusuran Universal untuk Google Workspace menggunakan standar Model Context Protocol (MCP) untuk memungkinkan agen AI menelusuri artefak Workspace Anda. Server ini menyediakan cara untuk menelusuri beberapa produk Google Workspace, termasuk pesan Gmail, file Google Drive, acara Google Kalender, serta ruang dan pesan Google Chat, menggunakan satu alat.

Server MCP Penelusuran Universal menyediakan cara standar bagi agen AI untuk menelusuri informasi di seluruh akun Google Workspace Anda tanpa perlu memanggil alat khusus produk satu per satu.

Prasyarat

Keanggotaan dalam Program Pratinjau Developer Google Workspace.
Project Google Cloud. Untuk membuat project, lihat Membuat project.
Klien MCP, seperti Google Antigravity.
Untuk menjalankan perintah di halaman ini, siapkan gcloud CLI di salah satu lingkungan pengembangan berikut:
Cloud Shell
Untuk menggunakan terminal online dengan gcloud CLI yang sudah disiapkan, aktifkan Cloud Shell:

Aktifkan Cloud Shell
Shell lokal
Untuk menggunakan lingkungan pengembangan lokal, ikuti langkah-langkah berikut:
1. Menginstal Google Cloud CLI. Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, login ke gcloud CLI dengan identitas gabungan Anda. Untuk mengetahui informasi selengkapnya, baca bagian Login ke gcloud CLI dengan identitas gabungan Anda.
3. Lakukan inisialisasi gcloud CLI.

Mengonfigurasi Server MCP Penelusuran Universal

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

Mengaktifkan API

Untuk menggunakan Server MCP Universal Search, aktifkan Google Workspace MCP API di project Google Cloud Anda:

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

Ganti PROJECT_ID dengan project ID Google Cloud Anda.

Konsol

Aktifkan API di konsol Google Cloud:

Aktifkan API

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

Jika Anda telah mengonfigurasi layar izin OAuth untuk server MCP lain, pastikan Anda telah menambahkan cakupan yang diperlukan untuk Server MCP Universal Search.

Saat melakukan autentikasi dengan Server MCP Universal Search, Anda dapat memilih untuk mengautentikasi semua cakupan yang diminta atau hanya sebagian saja. Server akan mematuhi pilihan ini dan hanya menelusuri produk yang aksesnya telah diberikan.

Misalnya, jika Anda melakukan autentikasi dengan semua cakupan berikut:

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
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.memberships.readonly

Server MCP Penelusuran Universal akan menelusuri Gmail, Google Drive, Google Kalender, dan Google Chat.

Namun, jika Anda menghilangkan https://www.googleapis.com/auth/gmail.readonly dan hanya memberikan akses ke https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly, dan https://www.googleapis.com/auth/chat.memberships.readonly, penelusuran universal hanya akan menampilkan hasil dari Google Drive, Google Kalender, dan Google Chat. Fitur ini tidak menelusuri email Anda atau menampilkan hasil Gmail.

Di Konsol Google Cloud, buka Google Auth Platform > Data Access.
Klik Add or Remove Scopes.
Tambahkan satu atau beberapa cakupan berikut:
- 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
- https://www.googleapis.com/auth/chat.spaces.readonly
- https://www.googleapis.com/auth/chat.memberships.readonly
Sertakan https://www.googleapis.com/auth/chat.spaces.readonly dan https://www.googleapis.com/auth/chat.memberships.readonly agar server dapat mengetahui siapa saja yang ada dalam setiap percakapan Google Chat. Tanpa header ini, hasil Google Chat akan diperlakukan sebagai dibagikan secara eksternal dan mungkin memerlukan konfirmasi pengguna atau difilter.
Klik Update, lalu Save.

Untuk mengetahui petunjuk mendetail tentang cara menyiapkan layar izin, lihat Mengonfigurasi server MCP Google Workspace.

Mengonfigurasi klien MCP Anda

Untuk menambahkan Server MCP Universal Search ke klien MCP Anda, ikuti petunjuk untuk klien Anda.

Client ID OAuth 2.0 yang didelegasikan pengguna yang memanggil Server MCP Universal Search harus memilih Gunakan klien ini untuk agen yang didukung AI di Google Auth Platform > Klien. Untuk memperbarui client ID OAuth 2.0 yang ada, pilih setelan ini di Google Auth Platform > Clients, seperti yang dijelaskan dalam Mengelola Klien OAuth. Jika Anda tidak dapat mengubah setelan ini pada klien yang ada, atau jika klien juga mendukung fitur non-agen, buat client ID OAuth 2.0 baru untuk agen AI Anda. Untuk permintaan yang ditolak, akun layanan dengan delegasi tingkat domain, atau Google Apps Script, lihat Pemecahan masalah.

Antigravity

Untuk menambahkan Server MCP Universal Search ke Antigravity, tambahkan konfigurasi server ke file mcp_config.json Anda. Petunjuk ini mendukung Antigravity 2.0, Antigravity IDE, dan Antigravity CLI.

Buat client ID dan rahasia OAuth 2.0 dari jenis aplikasi web. Di bagian Authorized redirect URIs, klik + Add URI, lalu tambahkan https://antigravity.google/oauth-callback di kolom URIs. Pilih Gunakan klien ini untuk agen berteknologi AI. Untuk mengetahui petunjuknya, lihat Mengonfigurasi server MCP Google Workspace.
Buka atau buat file konfigurasi ~/.gemini/config/mcp_config.json.

Tambahkan konfigurasi workspace-universal ke mcp_config.json:

{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.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.

Hemat mcp_config.json.
Mengautentikasi server MCP. Anda dapat melakukan autentikasi menggunakan setelan GUI atau CLI:
- Untuk Antigravity IDE atau GUI (Antigravity 2.0):
  1. Buka layar setelan Anda (misalnya, klik Settings di kiri bawah atau buka Antigravity User Settings).
  2. Buka Penyesuaian.
  3. Di bagian Server MCP Terinstal, klik Refresh.
  4. Temukan workspace-universal 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 workspace-universal, pindah ke tindakan Authenticate, lalu tekan Enter. Selesaikan alur login di browser Anda, salin kode otorisasi, tempelkan ke prompt terminal, lalu tekan Enter.
Pastikan server dikonfigurasi dan berjalan dengan benar:
- Untuk Antigravity IDE atau GUI: Tombol Sign out ditampilkan di samping workspace-universal 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 workspace-universal di bagian tampilan dasbor untuk memeriksa statusnya dan mencantumkan semua alat yang tersedia.

Claude

Untuk menambahkan Server MCP Penelusuran Universal ke Claude, konfigurasikan konektor kustom.

Buat client ID dan rahasia OAuth 2.0 dari jenis aplikasi web, lalu pilih Gunakan klien ini untuk agen berteknologi AI. Untuk mengetahui petunjuknya, lihat Mengonfigurasi server MCP Google Workspace.
Di setelan Claude, tambahkan konektor kustom:
- Nama server: Universal Search MCP Server
- URL server MCP jarak jauh: https://workspacemcp.googleapis.com/mcp/v1
- Client ID OAuth dan Rahasia klien OAuth: Masukkan kredensial Anda.
- Cakupan: Sertakan 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, https://www.googleapis.com/auth/chat.spaces.readonly, dan https://www.googleapis.com/auth/chat.memberships.readonly.

Menguji Server MCP Penelusuran Universal

Coba ajukan pertanyaan kepada klien MCP Anda yang memerlukan penelusuran di berbagai produk:

"Temukan apa pun yang terkait dengan Project X di email, dokumen, dan pesan chat saya."
"Kapan rapat saya berikutnya tentang rencana pemasaran, dan apa catatan serta pesan chat terbaru tentang rapat tersebut?"

Jika alat berhasil dijalankan dan Anda menerima respons yang relevan dari beberapa produk, berarti Server MCP Penelusuran Universal Anda telah dikonfigurasi dengan benar.

Alat yang didukung

Server MCP Universal Search menawarkan alat berikut. Untuk skema input dan output, lihat Referensi MCP Penelusuran Universal.

search_corpus: Menelusuri beberapa produk Google Workspace, termasuk Drive, Gmail, Kalender, dan Chat, berdasarkan kueri yang diberikan.