Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 Universal Search 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

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 Anda, lalu mengonfigurasi klien MCP untuk terhubung ke server tersebut.

Mengaktifkan API

Untuk menggunakan Server MCP Universal Search, aktifkan Google Workspace MCP API dan API untuk produk yang ingin Anda cari di project Google Cloud Anda:

Gmail API
Google Drive API
Google Calendar API
Google Chat API
Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project 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 lainnya, pastikan Anda telah menambahkan cakupan yang diperlukan untuk Server MCP Penelusuran Universal.

Saat melakukan autentikasi dengan Server MCP Universal Search, Anda dapat memilih untuk mengautentikasi semua cakupan yang diminta atau hanya sebagian cakupan. Server 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 (serta tidak menyertakan https://www.googleapis.com/auth/gmail.readonly), penelusuran universal hanya 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 Tambahkan atau Hapus Cakupan.
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 Perbarui, lalu Simpan.

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

Mengonfigurasi klien MCP

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

Antigravity

Untuk menambahkan Server MCP Penelusuran Universal 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 dengan jenis aplikasi web. Di bagian URI pengalihan yang diberi otorisasi, klik + Tambahkan URI, lalu tambahkan https://antigravity.google/oauth-callback di kolom URI. Untuk mendapatkan petunjuk, lihat Mengonfigurasi server MCP Google Workspace.
Buka atau buat file konfigurasi ~/.gemini/antigravity/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: ID klien yang Anda buat.
OAUTH_CLIENT_SECRET: Rahasia klien yang Anda buat.

Hemat mcp_config.json.
Lakukan autentikasi 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 Setelan di kiri bawah atau buka Setelan Pengguna Antigravitasi).
  2. Buka Penyesuaian.
  3. Di bagian Server MCP yang Terinstal, klik Muat ulang.
  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 Autentikasi, lalu tekan Enter. Selesaikan alur login di browser Anda, salin kode otorisasi, tempelkan ke perintah terminal, lalu tekan Enter.
Pastikan server dikonfigurasi dan berjalan dengan benar:
- Untuk Antigravity IDE atau GUI: Tombol Logout ditampilkan di samping workspace-universal di bagian Penyesuaian > Server MCP yang Terinstal.
- 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, konfigurasi konektor kustom.

Buat client ID dan rahasia OAuth 2.0 dengan jenis aplikasi web. Untuk mendapatkan petunjuk, 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 seluruh email, dokumen, dan pesan chat saya."
"Kapan rapat berikutnya tentang rencana pemasaran, dan apa catatan serta pesan chat terbaru tentang rencana tersebut?"

Jika alat berhasil dieksekusi dan Anda menerima respons yang relevan dari beberapa produk, 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.