Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Định cấu hình các máy chủ MCP của Google Workspace

Google Workspace cung cấp các máy chủ Giao thức bối cảnh mô hình (MCP) từ xa, cho phép các tác nhân AI tương tác an toàn với dữ liệu trong Google Workspace. Bằng cách định cấu hình máy chủ MCP của Google Workspace, bạn cho phép các ứng dụng AI như Google Antigravity và Claude thực hiện các hành động trong các ứng dụng của Google Workspace như Gmail, Google Drive, Google Tài liệu, Google Trang tính, Google Trang trình bày, Lịch Google, Google Chat và Google Lớp học. Mỗi sản phẩm của Google Workspace đều có máy chủ MCP riêng.

Máy chủ MCP của Google Workspace cung cấp một cách thức chuẩn hoá để các tác nhân AI:

Đọc dữ liệu: Tìm kiếm email, truy xuất tệp và liệt kê các sự kiện trên lịch.
Hành động: Tạo email nháp, tải tệp lên và lên lịch họp.
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

Là thành viên của Chương trình Bản dùng trước cho nhà phát triển của Google Workspace.
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 khách 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ôi trường phát triển cục bộ bằng cách 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 có 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 nhà cung cấp danh tính (IdP) bên ngoài, hãy đăng nhập vào CLI gcloud 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.
3. Khởi động CLI gcloud.
Nếu bạn định cấu hình máy chủ MCP của Google Lớp học, hãy tạo một lớp học thử nghiệm trên Google Lớp học có ít nhất một tài khoản học viên thử nghiệm. Nếu bạn không có lớp học nào trên Google Lớp học để dùng cho việc kiểm thử, hãy tạo một lớp học trong giao diện người dùng rồi thêm một học viên thử nghiệm.

Định cấu hình máy chủ MCP của Google Workspace

Để sử dụng máy chủ MCP của Google Workspace, bạn phải bật các máy chủ đó 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 các máy chủ đó.

Bật API

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

API Gmail
API Google Drive
Google Docs API
API Google Trang tính
API Google Trang trình bày
API Lịch Google
Google Chat API
People API
Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.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 API trong Google Cloud Console:

Bật API

Bật dịch vụ MCP

Để bật các thành phần MCP cho từng sản phẩm của Google Workspace, bạn phải bật các dịch vụ sau trong dự án trên đám mây của Google:

Gmail MCP API
Google Drive MCP API
Google Docs MCP API
API MCP của Google Trang tính
Google Slides MCP API
API MCP của Lịch Google
Google Chat MCP API
People MCP API
Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.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 Google Cloud Console:

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

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

Để sử dụng máy chủ MCP của Google Chat, bạn phải định cấu hình một ứng dụng Chat trong dự án trên đám mây của Google.

Trong Google Cloud Console, hãy tìm Google Chat API rồi nhấp vào Google Chat API > Quản lý > Cấu hình.

Chuyển đến Google Chat API
Thiết lập ứng dụng Chat:
1. Trong trường Tên ứng dụng, hãy nhập Chat MCP.
2. Trong trường URL hình đại diện, hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.
3. Trong phần Nội dung mô tả, hãy nhập Chat MCP server.
4. Trong phần Chức năng, hãy tắt các tính năng tương tác bằng cách tắt chế độ Bật các tính năng tương tác.
5. Trong phần Nhật ký, hãy chọn Ghi nhật ký lỗi vào tính năng Ghi nhật ký.
Nhấp vào Lưu.

Để tìm hiểu thêm về cách xây dựng ứng dụng Chat, hãy xem bài viết Chọn cấu trúc ứng dụng Google Chat.

Máy chủ MCP của Google Workspace 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 khách OAuth.

Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Xây dựng thương hiệu.

Chuyển đến phần Xây dựng thương hiệu
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, hãy nhấp vào Bắt đầu:
1. Trong phần App Information (Thông tin ứng dụng), trong mục App name (Tên ứng dụng), hãy nhập Workspace MCP Servers.
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 trên Google Groups phù hợp.
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 Địa chỉ email để nhận thông báo về mọi thay đổi đối với dự án của bạn.
7. Nhấp vào Tiếp theo.
8. Trong phần Hoàn tất, hãy xem Chính sách dữ liệu người dùng của dịch vụ API của Google. 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 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 Bên ngoài cho loại người dùng, 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à bất kỳ người dùng thử nghiệm được uỷ quyền nào khác, sau đó nhấp vào Lưu.
Nhấp vào Data Access (Truy cập dữ liệu) > Add or Remove Scopes (Thêm hoặc xoá phạm vi). Một bảng điều khiển sẽ xuất hiện cùng với danh sách phạm vi cho từng API mà bạn đã bật trong dự án trên đám mây của Google.
1. Trong mục Thêm phạm vi theo cách thủ công, hãy dán phạm vi cho các máy chủ MCP mà bạn muốn sử dụng:
  - Gmail:
    - https://www.googleapis.com/auth/gmail.readonly
    - https://www.googleapis.com/auth/gmail.compose
  - Google Drive:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
  - Google Tài liệu:
    - 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
  - Google Trang tính:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/spreadsheets.readonly
    - https://www.googleapis.com/auth/spreadsheets
  - Google Trang trình bày:
    - https://www.googleapis.com/auth/drive.readonly
    - https://www.googleapis.com/auth/drive.file
    - https://www.googleapis.com/auth/presentations.readonly
    - https://www.googleapis.com/auth/presentations
  - Lịch Google:
    - https://www.googleapis.com/auth/calendar.calendarlist.readonly
    - https://www.googleapis.com/auth/calendar.events.freebusy
    - https://www.googleapis.com/auth/calendar.events.readonly
  - Google Chat:
    - https://www.googleapis.com/auth/chat.spaces.readonly
    - https://www.googleapis.com/auth/chat.memberships.readonly
    - https://www.googleapis.com/auth/chat.messages.readonly
    - https://www.googleapis.com/auth/chat.messages.create
    - https://www.googleapis.com/auth/chat.users.readstate
  - People API:
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Lớp học:
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.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 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 Workspace vào ứng dụng MCP, hãy làm theo hướng dẫn dành cho ứng dụng của bạn.

Antigravity

Để thêm máy chủ MCP từ xa của Google Workspace 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.

Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:
1. Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Clients (Ứng dụng khách) > Create Client (Tạo ứng dụng khách)
  
  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 mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://antigravity.google/oauth-callback vào trường URI.
5. Chọn Sử dụng khách hàng này cho một tác nhân dựa trên AI.
6. Nhấp vào Tạo rồi sao chép Mã ứng dụng khách và Khoá bí mật của ứng dụng khách.
Mở hoặc tạo tệp cấu hình ~/.gemini/config/mcp_config.json.

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

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.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 khách bạn đã tạo.
OAUTH_CLIENT_SECRET: Khoá bí mật của ứng dụng khách mà bạn đã tạo.

Tiết kiệm mcp_config.json.
Xác thực máy chủ MCP. Bạn có thể xác thực bằng cách sử dụ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 Settings (Cài đặt) ở dưới cùng bên trái hoặc mở Antigravity User Settings (Cài đặt người dùng Antigravity)).
  2. Chuyển đến phần Tuỳ chỉnh.
  3. Trong mục Máy chủ MCP đã cài đặt, hãy nhấp vào Làm mới.
  4. Đối với mỗi máy chủ được liệt kê (gmail, drive, docs, sheets, slides, calendar, chat, people và classroom), hãy 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 rồi nhấp vào Gửi.
- Đối với Antigravity CLI:
  1. Bắt đầu sử dụ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. Xác thực từng máy chủ MCP:
    1. Sử dụng các phím mũi tên để chọn máy chủ, di chuyển đến thao tác Authenticate (Xác thực) rồi nhấn phím 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 của thiết bị đầu cuối rồi nhấn phím Enter.
    2. Lặp lại các bước này cho từng máy chủ mà bạn đã định cấu hình (gmail, drive, docs, sheets, slides, calendar, chat, people và classroom).
Xác minh rằng các máy chủ được định cấu hình đúng cách và đang chạy:
- Đối với Antigravity IDE hoặc GUI: Nút Đăng xuất sẽ xuất hiện bên cạnh mỗi 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 đã định cấu hình. Các máy chủ đã được xác minh và xác thực sẽ hiển thị trạng thái Đã 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ông cụ có sẵn của máy chủ đó.

Các máy chủ MCP từ xa đã sẵn sàng để sử dụng trong Antigravity.

Claude

Để sử dụng máy chủ MCP từ xa của Google Workspace 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 Workspace 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 khách OAuth và khoá bí mật.

Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:
1. Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Clients (Ứng dụng khách) > Create Client (Tạo ứng dụng khách)
  
  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 mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://claude.ai/api/mcp/auth_callback vào trường URI.
5. Chọn Sử dụng khách hàng này cho một tác nhân dựa trên AI.
6. Nhấp vào Tạo rồi sao chép Mã ứng dụng khách và Khoá bí mật của ứng dụng khách.
Đị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 Settings (Cài đặt) (hoặc Admin settings (Cài đặt quản trị)) > Connectors (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 kết nối cho sản phẩm Google Workspace mà bạn muốn thêm:
  - Tên máy chủ: Tên của máy chủ, chẳng hạn như Gmail.
  - URL máy chủ MCP từ xa: URL của sản phẩm Google Workspace, chẳng hạn như một trong những URL sau:
    - Gmail: https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive: https://drivemcp.googleapis.com/mcp/v1
    - Google Tài liệu: https://docsmcp.googleapis.com/mcp/v1
    - Google Trang tính: https://sheetsmcp.googleapis.com/mcp/v1
    - Google Trang trình bày: https://slidesmcp.googleapis.com/mcp/v1
    - Lịch Google: https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat: https://chatmcp.googleapis.com/mcp/v1
    - People API: https://people.googleapis.com/mcp/v1
    - Google Lớp học: https://classroommcp.googleapis.com/mcp/v1
4. Trong phần Cài đặt nâng cao, hãy nhập Mã ứng dụng khách OAuth và Khoá bí mật của ứng dụng khách OAuth.
5. Nhấp vào Thêm.
6. Lặp lại các bước này cho từng sản phẩm của Google Workspace mà bạn muốn 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 pháp xác thực. Đối với máy chủ MCP từ xa của Google Workspace, hãy nhập thông tin sau:

Tên máy chủ: googleworkspace
Máy chủ: Mỗi sản phẩm của Google Workspace đều có URL máy chủ riêng:
- Gmail: https://gmailmcp.googleapis.com/mcp/v1
- Google Drive: https://drivemcp.googleapis.com/mcp/v1
- Google Tài liệu: https://docsmcp.googleapis.com/mcp/v1
- Google Trang tính: https://sheetsmcp.googleapis.com/mcp/v1
- Google Trang trình bày: https://slidesmcp.googleapis.com/mcp/v1
- Lịch Google: https://calendarmcp.googleapis.com/mcp/v1
- Google Chat: https://chatmcp.googleapis.com/mcp/v1
- People API: https://people.googleapis.com/mcp/v1
- Google Lớp học: https://classroommcp.googleapis.com/mcp/v1
Truyền tải: HTTP có thể truyền trực tuyến
Xác thực: Máy chủ MCP từ xa của Google Workspace sử dụng OAuth 2.0. Khi tạo ứng dụng OAuth 2.0, hãy chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI. Để biết thông tin chi tiết, hãy xem bài viết Tìm hiểu về quy trình xác thực và uỷ quyền.

Ứng dụng MCP của bạn cần có mã làm mới để người dùng không phải đăng nhập lại sau mỗi giờ. Máy chủ OAuth 2.0 của Google chỉ cấp mã làm mới khi yêu cầu uỷ quyền có chứa access_type=offline. Nếu chỉ yêu cầu phạm vi offline_access của OpenID Connect (OIDC), thì bạn sẽ không nhận được mã thông báo truy cập. Nếu ứng dụng MCP của bạn hỗ trợ các tham số uỷ quyền tuỳ chỉnh, hãy thêm access_type=offline vào yêu cầu uỷ quyền. Để nhận mã làm mới mới cho người dùng đã cấp quyền truy cập, hãy thêm cả prompt=consent. Nếu ứng dụng MCP của bạn không hỗ trợ các tham số uỷ quyền tuỳ chỉnh, thì người dùng phải đăng nhập lại mỗi khi mã truy cập hết hạn. Để biết thông tin chi tiết, hãy xem phần Làm mới mã truy cập.

Để biết thêm thông tin chi tiết về cách kết nối các loại ứng dụng, 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 Workspace

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:

"Ariel đã nói gì trong email gần đây nhất về kế hoạch tiếp thị của chúng ta?"

Ứng dụng khách lọc email của Ariel bằng gmail.search_threads, truy xuất nội dung của chuỗi thư mới nhất bằng gmail.get_thread, sau đó tóm tắt nội dung đó cho bạn.
"Soạn email gửi đến ariel@example.com để thông báo rằng tôi phê duyệt kế hoạch tiếp thị."

Ứng dụng này sử dụng gmail.create_draft để tạo email trong thư mục thư nháp, cho phép bạn xem lại và gửi email đó từ Gmail.
"Tóm tắt tệp Kế hoạch tiếp thị".

Ứng dụng gọi drive.search_files để tìm "Kế hoạch tiếp thị", sau đó sử dụng drive.read_file_content để truy xuất và tóm tắt nội dung của kế hoạch đó.
"Cho tôi xem nội dung cấu trúc của Ghi chú cuộc họp trên Google Tài liệu".

Ứng dụng tìm nạp cấu trúc và nội dung của tài liệu bằng docs.read_doc.
"Đọc trang tính Trang tính 1 trong tệp Google Trang tính Doanh số hằng quý".

Ứng dụng tìm nạp các giá trị lưới bằng sheets.get_values.
"Cho tôi xem bố cục được mô tả bằng lời của bản trình bày Tổng quan về sản phẩm trên Google Trang trình bày."

Ứng dụng khách tìm nạp cấu trúc bố cục trực quan của bản trình bày bằng slides.read_presentation.
"Cuộc họp tiếp theo của tôi với Ariel là khi nào?"

Khách hàng kiểm tra lịch biểu của bạn bằng calendar.list_events và trình bày chi tiết cuộc họp tiếp theo của bạn với Ariel.
"Theo Hồ sơ trên Google của tôi, tên tôi là gì?"

Ứng dụng khách sử dụng people.get_user_profile để truy xuất thông tin hồ sơ của bạn trên Google Workspace.
"Tôi đang dạy những lớp nào?"

Ứng dụng kiểm tra lịch biểu của bạn bằng classroom.list_course_summaries và tóm tắt các khoá học đang hoạt động mà bạn có vai trò giáo viên.
"Soạn thông báo về chuyến đi thực tế sắp tới cho lớp địa chất của tôi."

Ứng dụng khách sử dụng classroom.create_announcement để soạn thông báo, bạn có thể xem lại và đăng thông báo đó trong ứng dụng Google Lớp học.

Nếu các công cụ thực thi thành công và bạn nhận được phản hồi phù hợp, thì tức là máy chủ MCP của Google Workspace đã được định cấu hình chính xác.

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.

Nếu yêu cầu của bạn đến máy chủ MCP bị từ chối, hãy xác minh rằng ứng dụng OAuth 2.0 của bạn đã chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI trong Nền tảng xác thực của Google > Ứng dụng. Nếu bạn không thể thay đổi chế độ cài đặt này trên một ứng dụng OAuth hiện có, hãy tạo một ứng dụng OAuth mới và chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI, sau đó cập nhật ứng dụng của bạn để sử dụng ứng dụng OAuth mới. Nếu một ứng dụng OAuth hiện có được dùng cho cả tính năng tác nhân AI và tính năng không phải tác nhân, hãy tạo một ứng dụng OAuth riêng cho tác nhân AI và giữ lại ứng dụng hiện có cho các tính năng không phải tác nhân. Để biết hướng dẫn, hãy xem bài viết Định cấu hình ứng dụng MCP và Quản lý ứng dụng OAuth.

Nếu ứng dụng của bạn sử dụng tài khoản dịch vụ có tính năng uỷ quyền trên toàn miền, thì bạn không thể chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI cho ứng dụng đó vì tài khoản dịch vụ không được quản lý trong Nền tảng xác thực của Google > Ứng dụng. Yêu cầu đến máy chủ MCP từ các tài khoản dịch vụ sử dụng tính năng uỷ quyền trên toàn miền sẽ không bị từ chối vì lý do này. Quyền truy cập được kiểm soát bằng chế độ cài đặt uỷ quyền trên toàn miền do quản trị viên Google Workspace quản lý. Để biết thông tin chi tiết, hãy xem bài viết Kiểm soát quyền truy cập API bằng tính năng uỷ quyền trên toàn miền.

Nếu bạn gọi máy chủ MCP từ Google Apps Script, Apps Script sẽ tạo và quản lý một ứng dụng OAuth mặc định cho kịch bản của bạn, nhưng bạn không thể chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI cho ứng dụng đó. Điều này áp dụng ngay cả khi tập lệnh của bạn sử dụng một dự án trên đám mây Google Cloud tiêu chuẩn. Thay vào đó, hãy làm như sau:

Trong Google Cloud Console, hãy chuyển đến Nền tảng xác thực của Google > Ứng dụng, tạo một ứng dụng OAuth rồi chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI.
Trong tập lệnh, hãy sử dụng thư viện OAuth2 cho Apps Script để uỷ quyền cho người dùng bằng ứng dụng OAuth đó.
Khi bạn gọi máy chủ MCP, hãy gửi mã truy cập mà thư viện trả về thay vì mã thông báo từ ScriptApp.getOAuthToken.

Những dự án Apps Script không gọi máy chủ MCP sẽ không bị ảnh hưởng.

Nếu bạn được nhắc đăng nhập lại sau mỗi giờ, thì ứng dụng MCP của bạn sẽ không nhận được mã làm mới. Máy chủ OAuth 2.0 của Google chỉ cấp mã làm mới khi yêu cầu uỷ quyền có chứa access_type=offline. Nếu chỉ yêu cầu phạm vi offline_access của OpenID Connect (OIDC), thì bạn sẽ không nhận được mã thông báo truy cập. Nếu ứng dụng MCP của bạn hỗ trợ các tham số uỷ quyền tuỳ chỉnh, hãy thêm access_type=offline vào yêu cầu uỷ quyền. Để nhận mã làm mới mới cho người dùng đã cấp quyền truy cập, hãy thêm cả prompt=consent. Nếu ứng dụng MCP của bạn không hỗ trợ các tham số uỷ quyền tuỳ chỉnh, thì bạn phải đăng nhập lại mỗi khi mã truy cập hết hạn. Để biết thông tin chi tiết, hãy xem phần Làm mới mã truy cập.

Các sản phẩm được hỗ trợ

Các sản phẩm sau đây của Google Workspace hỗ trợ máy chủ MCP của Google Workspace và cung cấp các công cụ sau:

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

Khi bạn cho mô hình ngôn ngữ tiếp xúc với dữ liệu không đáng tin cậy, có nguy cơ xảy ra cuộc tấn công 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 Workspace, nên các ứng dụng này 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 đây:

Chỉ sử dụng các công cụ đáng tin cậy. Tuyệt đối không kết nối máy chủ MCP của Google Workspace với các ứng dụng không đáng tin cậy hoặc chưa được xác minh.
Hãy thận trọng với dữ liệu đầu vào không đáng tin cậy. Tránh yêu cầu ứng dụng MCP xử lý email, 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. Những thông tin đầu vào này có thể chứa các lệnh ẩn có thể chiếm đoạt 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 tất cả hành động. Hãy luôn xem xét kỹ các hành động mà ứng dụng AI thực hiện thay mặt bạn để đảm bảo các hành động đó là chính xác và phù hợp với ý định của bạn.

Định cấu hình các máy chủ MCP của Google Workspace Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Định cấu hình máy chủ MCP của Google Workspace

Bật API

CLI

Giao diện dòng lệnh

Bật dịch vụ MCP

CLI

Giao diện dòng lệnh

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

Thiết lập màn hình xin phép bằng OAuth

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

Antigravity

Claude

Khác

Kiểm thử máy chủ MCP của Google Workspace

Khắc phục sự cố

Các sản phẩm được hỗ trợ

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

Chủ đề có liên quan

Định cấu hình các máy chủ MCP của Google Workspace