Định cấu hình máy chủ MCP của Tài liệu

Google Tài liệu cung cấp một máy chủ Giao thức ngữ cảnh mô hình (MCP) từ xa, cho phép các tác nhân AI tương tác một cách an toàn với dữ liệu trong Google Tài liệu. Bằng cách định cấu hình máy chủ MCP của Google Tài liệu, bạn cho phép các ứng dụng AI như Google Antigravity và Claude thực hiện các thao tác trong Google Tài liệu.

Máy chủ MCP của Google Tài liệu cung cấp một cách thức chuẩn hoá để các tác nhân AI:

  • Đọc dữ liệu: Đọc thông tin cấu trúc tài liệu và nội dung văn bản.
  • Thực hiện thao tác: Cập nhật kiểu và cấu trúc tài liệu bằng cách cập nhật hàng loạt.
  • Tôn trọng tính bảo mật: Kế thừa các quyền và chế độ kiểm soát quản trị dữ liệu giống như người dùng.

Điều kiện tiên quyết

  • Một dự án trên Google Cloud. Để tạo dự án, hãy xem bài viết Tạo dự án.

  • Một ứng dụng MCP, chẳng hạn như Google Antigravity.

  • Để chạy các lệnh trên trang này, hãy thiết lập gcloud CLI trong một trong các môi trường phát triển sau:

    Cloud Shell

    Để sử dụng một thiết bị đầu cuối trực tuyến đã thiết lập gcloud CLI, hãy kích hoạt Cloud Shell:

    Kích hoạt Cloud Shell

    Bộ biên dịch ngôn ngữ lệnh cục bộ

    Để sử dụng môi trường phát triển cục bộ, hãy làm theo các bước sau:

    1. Cài đặt Google Cloud CLI. Nếu bạn đã cài đặt gcloud CLI trước đó, hãy đảm bảo rằng bạn đang dùng phiên bản mới nhất bằng cách chạy gcloud components update.
    2. Nếu bạn đang sử dụng một nhà cung cấp dịch vụ danh tính bên ngoài (IdP), hãy đăng nhập vào gcloud CLI bằng danh tính liên kết của bạn. Để biết thêm thông tin, hãy xem bài viết Đăng nhập vào gcloud CLI bằng danh tính liên kết của bạn.
    3. Khởi động CLI gcloud.

Định cấu hình máy chủ MCP của Google Tài liệu

Để sử dụng máy chủ MCP của Google Tài liệu, bạn phải bật máy chủ này trong dự án trên đám mây của Google Cloud, sau đó định cấu hình ứng dụng MCP để kết nối với máy chủ đó.

Bật API

Để sử dụng máy chủ MCP của Google Tài liệu, bạn phải bật API sau trong dự án trên đám mây của Google:

  • Google Docs API

CLI

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

Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn.

Giao diện dòng lệnh

Bật API trong bảng điều khiển Cloud của Google:

Bật API

Bật các dịch vụ MCP

Để bật các thành phần MCP cho Google Tài liệu, bạn phải bật dịch vụ sau trong dự án trên Google Cloud:

  • Google Docs MCP API

CLI

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

Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn.

Giao diện dòng lệnh

Bật các dịch vụ MCP trong bảng điều khiển Cloud của Google:

Bật các dịch vụ MCP

Máy chủ MCP của Google Tài liệu sử dụng OAuth 2.0 để xác thực và uỷ quyền. Bạn phải định cấu hình màn hình xin phép bằng OAuth trước khi có thể tạo mã ứng dụng OAuth.

  1. Trong bảng điều khiển Cloud, hãy chuyển đến Nền tảng xác thực của Google > Thương hiệu.

    Chuyển đến phần Thương hiệu

  2. Nếu đã định cấu hình Nền tảng xác thực của Google, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phần Thương hiệu, Đối tượng, và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo cho biết Nền tảng xác thực của Google chưa được định cấu hình yet, hãy nhấp vào Bắt đầu:

    1. Trong phần Thông tin ứng dụng, ở mục Tên ứng dụng, hãy nhập Docs MCP Server.
    2. Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email của bạn hoặc một nhóm thích hợp trên Google.
    3. Nhấp vào Tiếp theo.
    4. Trong phần Đối tượng, hãy chọn Nội bộ. Nếu bạn không thể chọn Nội bộ, hãy chọn Bên ngoài.
    5. Nhấp vào Tiếp theo.
    6. Trong phần Thông tin liên hệ, hãy nhập một Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
    7. Nhấp vào Tiếp theo.
    8. Trong phần Hoàn tất, hãy xem lại Chính sách dữ liệu người dùng của các dịch vụ API của Google và nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của các dịch vụ API của Google.
    9. Nhấp vào Tiếp tục.
    10. Nhấp vào Tạo.
    11. Nếu bạn chọn loại người dùng là Bên ngoài, hãy thêm người dùng thử nghiệm:
      1. Nhấp vào Đối tượng.
      2. Trong phần Người dùng thử nghiệm, hãy nhấp vào Thêm người dùng.
      3. Nhập địa chỉ email của bạn và mọi người dùng thử nghiệm được uỷ quyền khác, sau đó nhấp vào Lưu.

  3. Nhấp vào Quyền truy cập dữ liệu > Thêm hoặc xoá phạm vi. Một bảng điều khiển sẽ xuất hiện kèm theo danh sách các phạm vi cho từng API mà bạn đã bật trong dự án trên Google Cloud.

    1. Trong phần Thêm phạm vi theo cách thủ công, hãy dán các phạm vi cho máy chủ MCP của Google Tài liệu:

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

    2. Nhấp vào Thêm vào bảng.

    3. Nhấp vào Cập nhật.

    4. Sau khi chọn các phạm vi mà ứng dụng của bạn yêu cầu, trên trang Quyền truy cập dữ liệu, hãy nhấp vào Lưu.

Định cấu hình ứng dụng MCP

Để thêm máy chủ MCP từ xa của Google Tài liệu vào ứng dụng MCP, hãy làm theo hướng dẫn cho ứng dụng của bạn.

Antigravity

Để thêm máy chủ MCP từ xa của Google Tài liệu vào Antigravity, hãy thêm cấu hình máy chủ vào tệp mcp_config.json. Các hướng dẫn này hỗ trợ Antigravity 2.0, Antigravity IDE và Antigravity CLI.

  1. Tạo mã ứng dụng và khoá bí mật của OAuth 2.0:

    1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng

      Chuyển đến phần Tạo ứng dụng

    2. Chọn Ứng dụng web làm loại ứng dụng.

    3. Nhập Tên.

    4. Trong phần URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, sau đó thêm https://antigravity.google/oauth-callback vào trường URI.

    5. Nhấp vào Tạo rồi sao chép Mã ứng dụng và Khoá bí mật của ứng dụng.

  2. Mở hoặc tạo tệp cấu hình ~/.gemini/antigravity/mcp_config.json.

  3. Thêm cấu hình mcpServers vào mcp_config.json:

    {
  "mcpServers": {
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Thay thế nội dung sau:

    • OAUTH_CLIENT_ID: Mã ứng dụng mà bạn đã tạo.
    • OAUTH_CLIENT_SECRET: Khoá bí mật của ứng dụng mà bạn đã tạo.

  4. Lưu mcp_config.json.

  5. Xác thực máy chủ MCP. Bạn có thể xác thực bằng chế độ cài đặt GUI hoặc CLI:

    • Đối với Antigravity IDE hoặc GUI (Antigravity 2.0):

      1. Mở màn hình cài đặt (ví dụ: nhấp vào Cài đặt ở dưới cùng bên trái hoặc mở Cài đặt người dùng Antigravity).
      2. Chuyển đến phần Tuỳ chỉnh.
      3. Trong phần Máy chủ MCP đã cài đặt, hãy nhấp vào Làm mới.
      4. Tìm docs trong danh sách, nhấp vào Xác thực, đăng nhập vào Tài khoản Google của bạn, sao chép mã uỷ quyền, dán mã đó vào hộp thoại nhập và nhấp vào Gửi.

    • Đối với Antigravity CLI:

      1. Khởi động Antigravity CLI:

        agy

      2. Mở bảng điều khiển quản lý MCP tương tác bằng cách chạy:

        /mcp

      3. Sử dụng các phím mũi tên để chọn docs, chuyển đến thao tác Xác thực rồi nhấn Enter. Hoàn tất quy trình đăng nhập trong trình duyệt, sao chép mã uỷ quyền, dán mã đó vào lời nhắc trên thiết bị đầu cuối rồi nhấn Enter.

  6. Xác minh rằng máy chủ được định cấu hình và đang chạy đúng cách:

    • Đối với Antigravity IDE hoặc GUI: Nút Đăng xuất sẽ xuất hiện bên cạnh máy chủ trong phần Tuỳ chỉnh > Máy chủ MCP đã cài đặt.
    • Đối với Antigravity CLI: Mở bảng điều khiển /mcp để xem các máy chủ MCP mà bạn đã định cấu hình. Các máy chủ đã xác minh và xác thực sẽ hiển thị Đã xác thực bên cạnh tên của chúng trong bảng điều khiển TUI tương tác. Bạn có thể chọn bất kỳ máy chủ nào trong chế độ xem trang tổng quan để kiểm tra trạng thái và liệt kê tất cả các công cụ có sẵn của máy chủ đó.

Bạn có thể sử dụng máy chủ MCP từ xa trong Antigravity.

Claude

Để sử dụng máy chủ MCP từ xa của Google Tài liệu với Claude.ai hoặc Claude Desktop, bạn phải có gói Claude Enterprise, Pro, Max hoặc Team.

Để thêm máy chủ MCP từ xa của Google Tài liệu vào Claude, hãy định cấu hình một trình kết nối tuỳ chỉnh bằng mã ứng dụng và khoá bí mật của OAuth.

  1. Tạo mã ứng dụng và khoá bí mật của OAuth 2.0:

    1. Trong bảng điều khiển Google Cloud, hãy chuyển đến Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng

      Chuyển đến phần Tạo ứng dụng

    2. Chọn Ứng dụng web làm loại ứng dụng.

    3. Nhập Tên.

    4. Trong phần URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, sau đó thêm https://claude.ai/api/mcp/auth_callback vào trường URI.

    5. Nhấp vào Tạo rồi sao chép Mã ứng dụng và Khoá bí mật của ứng dụng.

  2. Định cấu hình máy chủ MCP trong Claude:

    1. Trong Claude.ai hoặc Claude Desktop, hãy chuyển đến phần Cài đặt (hoặc Cài đặt quản trị) > Trình kết nối.
    2. Nhấp vào Thêm trình kết nối tuỳ chỉnh.
    3. Nhập thông tin chi tiết về kết nối cho sản phẩm Google Tài liệu:
      • Tên máy chủ: Google Docs.
      • URL máy chủ MCP từ xa: https://docsmcp.googleapis.com/mcp/v1
    4. Trong phần Cài đặt nâng cao, hãy nhập Mã ứng dụng OAuth và Khoá bí mật của ứng dụng OAuth.
    5. Nhấp vào Thêm.

Khác

Nhiều ứng dụng AI có cách kết nối với máy chủ MCP từ xa. Thông thường, bạn cần nhập thông tin chi tiết về máy chủ, chẳng hạn như tên, điểm cuối, giao thức truyền tải và phương thức xác thực. Đối với máy chủ MCP từ xa của Google Tài liệu, hãy nhập thông tin sau:

Để biết thêm thông tin chi tiết về cách kết nối các loại ứng dụng khác nhau, hãy xem bài viết Định cấu hình MCP trong ứng dụng AI.

Kiểm thử máy chủ MCP của Google Tài liệu

Sau khi định cấu hình ứng dụng MCP, bạn có thể xác minh kết nối bằng cách chạy một số câu lệnh kiểm thử.

Hãy thử hỏi ứng dụng MCP của bạn những câu hỏi sau:

  • "Cho tôi xem nội dung cấu trúc của Google Tài liệu abcd123."

    Ứng dụng này tìm nạp cấu trúc và nội dung của tài liệu bằng cách sử dụng docs.read_doc.

  • "Chèn tiêu đề 'Kế hoạch tiếp thị của tôi' vào Google Tài liệu abcd123."

    Ứng dụng này thực hiện docs.update_doc để cập nhật các thành phần cấu trúc và chèn văn bản.

Nếu các công cụ thực thi thành công và bạn nhận được các phản hồi có liên quan, thì máy chủ MCP của Google Tài liệu đã được định cấu hình đúng cách.

Khắc phục sự cố

Nếu gặp vấn đề khi kết nối với máy chủ MCP, bạn có thể kiểm tra lỗi trong nhật ký OAuth. Yêu cầu quản trị viên kiểm tra Sự kiện trong nhật ký OAuth trong công cụ điều tra bảo mật.

Tài liệu tham khảo về công cụ

Bạn có thể sử dụng các công cụ sau cho máy chủ MCP của Google Tài liệu:

  • read_doc
  • update_doc

Lưu ý quan trọng về bảo mật: Tiêm câu lệnh (prompt injection) gián tiếp

Khi bạn cho phép một mô hình ngôn ngữ tiếp xúc với dữ liệu không đáng tin cậy, sẽ có nguy cơ bị tấn công bằng cách chèn câu lệnh gián tiếp . Vì các ứng dụng MCP như Google Antigravity có quyền truy cập vào các công cụ và API mạnh mẽ thông qua máy chủ MCP của Google Tài liệu, nên chúng có thể đọc, sửa đổi và xoá dữ liệu trong Tài khoản Google của bạn.

Để giảm thiểu những rủi ro này, hãy làm theo các phương pháp hay nhất sau:

  • Chỉ sử dụng các công cụ đáng tin cậy. Không bao giờ kết nối máy chủ MCP của Google Tài liệu với các ứng dụng không đáng tin cậy hoặc chưa được xác minh.
  • Thận trọng với các dữ liệu đầu vào không đáng tin cậy. Tránh yêu cầu ứng dụng MCP của bạn xử lý tài liệu hoặc các tài nguyên khác từ các nguồn chưa được xác minh. Các dữ liệu đầu vào này có thể chứa các hướng dẫn ẩn có thể chiếm quyền điều khiển phiên của bạn, cho phép kẻ tấn công sửa đổi, đánh cắp hoặc xoá dữ liệu của bạn.
  • Xem xét tất cả các thao tác. Luôn xem xét kỹ các thao tác mà ứng dụng AI thực hiện thay mặt bạn để đảm bảo các thao tác đó chính xác và phù hợp với ý định của bạn.