Mengonfigurasi server MCP Google Dokumen

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

Server MCP Dokumen menyediakan cara standar bagi agen AI untuk:

  • Membaca data: Membaca informasi struktural dokumen dan konten teks.
  • Ambil tindakan: Perbarui gaya dan struktur dokumen menggunakan kumpulan update.
  • Mematuhi keamanan: Mewarisi izin dan kontrol tata kelola data yang sama dengan pengguna.

Prasyarat

Mengonfigurasi server MCP Dokumen

Untuk menggunakan server MCP Dokumen, siapkan project Google Cloud dengan klien OAuth 2.0 agen AI dan konfigurasikan aplikasi AI Anda untuk terhubung ke server tersebut:

  • Penggunaan pribadi: Jika Anda menghubungkan aplikasi AI untuk Akun Google Anda sendiri, gunakan Penyiapan cepat untuk penggunaan pribadi guna mengonfigurasi project, mengaktifkan API dan layanan MCP, serta membuat klien OAuth di satu halaman.
  • Penyiapan multi-pengguna atau kustom: Jika beberapa pengguna akan login dengan klien OAuth Anda, atau jika Anda hanya ingin mengaktifkan API, layanan MCP, dan cakupan OAuth tertentu, mulai dari Mengaktifkan API.

Penyiapan cepat untuk penggunaan pribadi

Gunakan Orientasi mode pribadi di Konsol Google Cloud untuk membuat klien OAuth 2.0 yang hanya berfungsi untuk Akun Google Anda dan tidak memerlukan verifikasi aplikasi atau penyiapan layar izin OAuth terpisah:

  1. Buka Personal mode onboarding di Konsol Google Cloud. Tombol ini memilih klien Aplikasi web terlebih dahulu, yang diperlukan oleh Google Antigravity dan Claude:

    Menyiapkan mode personal

    Jika klien MCP Anda menggunakan alur OAuth desktop atau seluler, bukan URI pengalihan web, buka penyiapan mode pribadi untuk klien Aplikasi desktop, Android, atau iOS, atau ubah Jenis aplikasi di halaman.

  2. Di Select Project, pilih project mode pribadi yang sudah ada atau klik Create a new project. Jika diminta, lengkapi formulir pembuatan project.

  3. Konfigurasikan detail klien OAuth Anda:

    • Masukkan Name untuk klien.
    • Jika Application type adalah Web application, di Authorized redirect URIs, klik + Add URI dan tambahkan URI callback klien MCP Anda:
      • Untuk Antigravity: https://antigravity.google/oauth-callback
      • Untuk Claude: https://claude.ai/api/mcp/auth_callback
    • Pastikan Use this client for an AI-powered agent dipilih.
  4. Tinjau Kebijakan Data Pengguna Layanan Google API, pilih Saya menyetujui Layanan Google API: Kebijakan Data Pengguna., lalu klik Lanjutkan.

    Konsol ini mengaktifkan API Google Workspace inti dan layanan MCP di project Anda serta membuat klien OAuth Anda.

  5. Salin Client ID dan rahasia klien Anda, lalu hubungkan klien Anda ke server MCP, lewati langkah 1 karena Anda sudah memiliki Client ID dan rahasia klien OAuth.

Mengaktifkan API

Lewati langkah ini jika Anda menggunakan Penyiapan cepat untuk penggunaan pribadi.

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

  • 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

Lewati langkah ini jika Anda menggunakan Penyiapan cepat untuk penggunaan pribadi.

Untuk mengaktifkan komponen MCP untuk Dokumen, aktifkan layanan berikut di project Google Cloud Anda:

  • 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:

Mengaktifkan layanan MCP

Lewati langkah ini jika Anda menggunakan Penyiapan cepat untuk penggunaan pribadi.

Server MCP 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 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 Docs 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 Dokumen:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/documents.readonly
      • https://www.googleapis.com/auth/documents
    2. Klik Add to Table.

    3. Klik Perbarui.

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

Mengonfigurasi aplikasi AI Anda

Untuk menambahkan server MCP jarak jauh Dokumen ke aplikasi AI Anda, ikuti petunjuk untuk aplikasi Anda.

Client ID OAuth 2.0 yang didelegasikan pengguna yang memanggil server MCP Dokumen 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 jarak jauh 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, atau lanjutkan ke langkah berikutnya jika Anda sudah membuatnya di Penyiapan cepat untuk penggunaan pribadi:

    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 yang didukung 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": {
        "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. 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 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 docs 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 docs, 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 di bagian Customizations > Installed MCP Servers.
    • 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 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 Docs dengan Claude.ai atau Claude Desktop, Anda harus memiliki paket Claude Enterprise, Pro, Max, atau Team.

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

  1. Buat client ID dan rahasia OAuth 2.0, atau lanjutkan ke langkah berikutnya jika Anda sudah membuatnya di Penyiapan cepat untuk penggunaan pribadi:

    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 yang didukung 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 > Connectors atau Admin settings > Connectors.
    2. Klik Add custom connector.
    3. Masukkan detail koneksi untuk produk Dokumen:
      • Server name: Docs.
      • URL server MCP jarak jauh: https://docsmcp.googleapis.com/mcp/v1
    4. Di Setelan lanjutan, masukkan client ID klien OAuth dan rahasia klien OAuth 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 transport, dan metode autentikasinya. Untuk server MCP jarak jauh Docs, masukkan perintah berikut:

  • Nama server: docs

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

  • Transport: HTTP yang dapat di-streaming

  • Autentikasi: Server MCP jarak jauh Dokumen menggunakan OAuth 2.0. Saat membuat klien OAuth 2.0, pilih Gunakan klien ini untuk agen yang didukung AI. Untuk penyiapan pribadi pengguna tunggal, Anda dapat membuat klien web, desktop, Android, atau iOS menggunakan Penyiapan cepat untuk penggunaan pribadi. Untuk mengetahui detailnya, lihat Mempelajari autentikasi dan otorisasi.

    Untuk menghindari dialog login setiap jam dengan klien OAuth Aplikasi web, konfigurasikan klien MCP Anda untuk meminta akses offline menggunakan access_type=offline atau cakupan offline_access. Untuk mengetahui detailnya, lihat Dialog login berulang setiap jam.

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

Menguji server MCP Dokumen

Setelah mengonfigurasi aplikasi AI, Anda dapat memverifikasi koneksi dengan menjalankan beberapa perintah pengujian.

Coba ajukan pertanyaan berikut ke aplikasi AI Anda:

  • "Tampilkan konten struktural Dokumen Google abcd123."

    Klien mengambil struktur dan konten dokumen menggunakan docs.read_doc.

  • "Sisipkan judul 'Rencana Pemasaran Saya' ke dalam Dokumen Google abcd123."

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

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

Pemecahan masalah

Gunakan bagian berikut untuk menyelesaikan masalah autentikasi dan koneksi umum dengan server MCP Dokumen.

Memeriksa peristiwa log OAuth

Jika Anda mengalami masalah saat menghubungkan ke server MCP, periksa error di log OAuth. Minta administrator Google Workspace Anda untuk meninjau peristiwa log OAuth di alat investigasi keamanan.

Permintaan yang ditolak dari klien OAuth yang didelegasikan pengguna

Jika permintaan Anda ke server MCP ditolak, pastikan client ID OAuth 2.0 yang didelegasikan pengguna untuk alur OAuth 3-legged Anda telah memilih Gunakan klien ini untuk agen yang didukung AI di Google Auth Platform > Klien:

  • Klien yang ada mendukung setelan: Pilih Use this client for an AI-powered agent di klien OAuth yang ada.
  • Klien yang ada tidak dapat diupdate: Buat klien OAuth baru dengan memilih Gunakan klien ini untuk agen yang didukung AI dan update aplikasi Anda untuk menggunakannya.
  • Klien yang ada juga mendukung fitur non-agen: Buat klien OAuth terpisah untuk agen AI dan pertahankan klien yang ada untuk fitur non-agen Anda.

Untuk mengetahui petunjuknya, lihat Mengonfigurasi aplikasi AI Anda dan Mengelola Klien OAuth.

Akun layanan dengan delegasi tingkat domain

Jika aplikasi Anda menggunakan akun layanan dengan delegasi tingkat domain untuk OAuth 2-legged, Anda tidak dapat memilih Gunakan klien ini untuk agen yang didukung AI karena akun layanan tidak dikelola di Google Auth Platform > Klien:

  • Kontrol akses: Permintaan ke server MCP dari akun layanan ini tidak ditolak karena tidak memiliki setelan agen. Sebagai gantinya, akses diatur oleh setelan delegasi di seluruh domain yang dikelola oleh administrator Google Workspace Anda. Untuk mengetahui detail tentang setelan administrator, lihat Mengontrol akses API dengan delegasi tingkat domain.
  • Tindakan sensitif: Server MCP Google Workspace masih menampilkan perintah pengumpulan formulir untuk konfirmasi human-in-the-loop pada panggilan alat sensitif yang dilakukan melalui peniruan identitas pengguna delegasi tingkat domain.

Permintaan dari Apps Script

Jika memanggil server MCP dari Apps Script, Anda tidak dapat memilih Gunakan klien ini untuk agen yang didukung AI di klien OAuth default yang dibuat dan dikelola Apps Script untuk skrip Anda. Hal ini berlaku meskipun skrip Anda menggunakan project Google Cloud standar.

Untuk memanggil server MCP dari Apps Script, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, buka Google Auth Platform > Clients, buat klien OAuth, dan pilih Use this client for an agen didukung AI.
  2. Dalam skrip Anda, gunakan library OAuth2 untuk Apps Script guna memberi otorisasi kepada pengguna dengan klien OAuth tersebut.
  3. Saat Anda memanggil server MCP, kirim token akses yang ditampilkan library, bukan token dari ScriptApp.getOAuthToken.

Project Apps Script yang tidak memanggil server MCP Google Workspace tidak akan terpengaruh.

Dialog login berulang setiap jam

Jika Anda diminta untuk login lagi setiap jam, klien MCP Anda tidak menerima atau menggunakan token refresh. Hal ini biasanya terjadi dalam situasi berikut:

  • Tidak ada akses offline di klien OAuth Aplikasi web: Tidak seperti klien OAuth Aplikasi desktop, klien OAuth Aplikasi web secara default menggunakan akses online. Untuk meminta token refresh, sertakan access_type=offline atau sertakan cakupan offline_access OpenID Connect (OIDC) bersama setidaknya satu cakupan API, dan jangan tetapkan access_type=online.
  • Mengizinkan ulang aplikasi yang sudah diberi izin: Server OAuth 2.0 Google mengeluarkan token refresh saat pertama kali pengguna memberikan akses offline. Jika pengguna telah mengizinkan klien OAuth Anda tanpa akses offline, atau jika klien MCP Anda kehilangan token refresh yang disimpan, login berikutnya mungkin tidak akan menampilkan token refresh baru. Sertakan prompt=consent dalam permintaan otorisasi, atau hapus akses aplikasi di Koneksi Akun Google dan login lagi.
  • Token pemilik statis: Jika Anda meneruskan token akses mentah di header Authorization, seperti output dari gcloud auth print-access-token, token akan berakhir setelah satu jam kecuali jika klien Anda memperbaruinya.

Untuk mengetahui detailnya, lihat Memperbarui token akses.

Referensi alat

Alat berikut tersedia untuk server MCP Dokumen. Untuk skema input dan output, lihat Referensi MCP Dokumen:

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 aplikasi AI seperti Google Antigravity memiliki akses ke alat dan API yang canggih melalui server MCP Dokumen, aplikasi tersebut dapat membaca, mengubah, dan menghapus data di Akun Google Anda.

Untuk mengurangi risiko ini, Anda harus menyaring perintah dan respons untuk konten berbahaya atau serangan injeksi perintah. Anda dapat menggunakan Model Armor yang disediakan Google, atau Anda dapat menggunakan solusi Anda sendiri jika Anda mendokumentasikannya sehingga pengguna dapat menerima risiko tersebut. Untuk mengetahui petunjuknya, lihat Mengonfigurasi keamanan untuk server MCP Google Workspace.

Ikuti praktik terbaik berikut:

  • Hanya gunakan alat tepercaya. Jangan pernah menghubungkan server MCP Dokumen ke aplikasi yang tidak tepercaya atau belum diverifikasi.
  • Berhati-hatilah dengan input yang tidak tepercaya. Jangan meminta aplikasi AI Anda untuk memproses dokumen atau resource lain dari sumber yang belum diverifikasi. Input ini mungkin berisi petunjuk tersembunyi yang dapat membajak sesi Anda dan memungkinkan penyerang mengubah, mencuri, atau menghapus data Anda.
  • Tinjau semua tindakan. Selalu tinjau dengan cermat tindakan yang dilakukan oleh aplikasi AI atas nama Anda untuk memastikan tindakan tersebut akurat dan sesuai dengan maksud Anda.