Mengonfigurasi server MCP Dokumen

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

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

  • Membaca data: Membaca informasi struktural dokumen dan konten teks.
  • Melakukan tindakan: Memperbarui gaya dan struktur dokumen menggunakan pembaruan batch.
  • Mematuhi keamanan: Mewarisi izin dan kontrol tata kelola data yang sama seperti pengguna.

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 Google Dokumen

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

Mengaktifkan API

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

  • Google Docs API

CLI

gcloud services enable docs.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 Dokumen, Anda harus mengaktifkan layanan berikut di project Google Cloud:

  • Google Docs MCP API

CLI

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

Ganti PROJECT_ID dengan ID project Google Cloud Anda.

Konsol

Aktifkan layanan MCP di konsol Google Cloud:

Aktifkan layanan MCP

Server MCP Google Dokumen 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 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 Docs MCP Server.
    2. Di User support email, pilih alamat email Anda atau grup Google yang sesuai.
    3. Klik Next.
    4. Di bagian Audience, pilih Internal. Jika Anda tidak dapat memilih Internal, pilih External.
    5. Klik Next.
    6. Di bagian Contact Information, masukkan Email address tempat Anda dapat menerima notifikasi tentang perubahan apa pun pada project Anda.
    7. Klik Next.
    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 Continue.
    10. Klik Create.
    11. Jika Anda memilih External untuk jenis pengguna, tambahkan pengguna pengujian:
      1. Klik Audience.
      2. Di bagian Test users, klik Add users.
      3. Masukkan alamat email Anda dan pengguna pengujian 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 Dokumen:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/documents.readonly

    2. Klik Add to Table.

    3. Klik Update.

    4. Setelah memilih cakupan yang diperlukan oleh aplikasi Anda, di halaman Data Access, klik Save.

Mengonfigurasi klien MCP

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

Antigravity

Untuk menambahkan server MCP jarak jauh Google Dokumen 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 Buat Klien

    2. Pilih aplikasi web sebagai jenis aplikasi.

    3. Masukkan Name.

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

    5. Klik Create dan 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": {
    "docs": {
      "serverUrl": "https://docsmcp.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. Simpan mcp_config.json.

  5. Autentikasi 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 Customizations.
      3. Di bagian Installed MCP Servers, klik Refresh.
      4. Temukan docs dalam daftar, klik Authenticate, login ke Akun Google Anda, salin kode otorisasi, tempel 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 docs, pindah ke tindakan Authenticate, 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 Sign out 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 apa 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 Dokumen dengan Claude.ai atau Claude Desktop, Anda harus memiliki paket Claude Enterprise, Pro, Max, atau Team.

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

  1. Buat client ID dan rahasia OAuth 2.0:

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

      Buka Buat Klien

    2. Pilih aplikasi web sebagai jenis aplikasi.

    3. Masukkan Name.

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

    5. Klik Create dan salin Client ID dan Client Secret Anda.

  2. Konfigurasikan 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 Dokumen:
      • Server name: Google Docs.
      • Remote MCP server URL: https://docsmcp.googleapis.com/mcp/v1
    4. Di bagian Setelan lanjutan, masukkan ID klien OAuth dan rahasia klien OAuth Anda.
    5. Klik Add.

Lainnya

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

  • Server name: docs

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

  • Transport: HTTP

  • Authentication: Server MCP jarak jauh Google Dokumen 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 di aplikasi AI.

Menguji server MCP Google Dokumen

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

Coba ajukan pertanyaan berikut kepada klien MCP Anda:

  • "Show me the structural contents of Google Doc abcd123."

    Klien mengambil struktur dan konten dokumen menggunakan docs.read_doc.

  • "Insert the title 'My Marketing Plan' into Google Doc abcd123."

    Klien menjalankan docs.update_doc untuk memperbarui elemen struktural dan menyisipkan teks.

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

Pemecahan masalah

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

Referensi alat

Alat berikut tersedia untuk server MCP Google Dokumen:

  • read_doc
  • update_doc

Pertimbangan keamanan penting: Injeksi perintah tidak langsung

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

Untuk mengurangi risiko ini, ikuti praktik terbaik berikut:

  • Hanya gunakan alat tepercaya. Jangan pernah menghubungkan server MCP Google Dokumen ke aplikasi yang tidak tepercaya atau tidak terverifikasi.
  • Berhati-hatilah dengan input yang tidak tepercaya. Hindari meminta klien MCP Anda untuk memproses dokumen 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 Anda atas nama Anda untuk memastikan tindakan tersebut benar dan sesuai dengan niat Anda.