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, lihat 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 Penelusuran Universal 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

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

Namun, jika Anda hanya memberikan akses ke https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, dan https://www.googleapis.com/auth/chat.messages.readonly (dan menghilangkan https://www.googleapis.com/auth/gmail.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
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.

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 server MCP.
- Untuk Antigravity CLI: Buka panel /mcp untuk melihat server MCP yang dikonfigurasi. Server yang diverifikasi dan diautentikasi akan 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, dan https://www.googleapis.com/auth/chat.messages.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 Penelusuran Universal menawarkan alat berikut:

search_corpus: Melakukan penelusuran di beberapa produk Google Workspace (Google Drive, Gmail, Google Kalender, dan Google Chat) berdasarkan kueri yang diberikan.