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

Tư cách thành viên trong 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 định cấu hình máy chủ MCP của Google Lớp học, bạn cần có một lớp học thử nghiệm trên Google Lớp học với í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 > Manage (Quản lý) > Configuration (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 Logs (Nhật ký), hãy chọn Log errors to Logging (Ghi lỗi vào 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 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 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 nào khác được uỷ quyền, sau đó nhấp vào Lưu.
Nhấp vào 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 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 Cloud.
1. Trong phần 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
    - https://www.googleapis.com/auth/chat.users.spacesettings
  - 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.

Mã ứng dụng khách OAuth 2.0 do người dùng uỷ quyền gọi máy chủ MCP của Google Workspace phải chọn Sử dụng ứng dụng khách này cho một tác nhân dựa trên AI trong Nền tảng xác thực của Google > Ứng dụng khách. Để cập nhật mã ứng dụng khách OAuth 2.0 hiện có, hãy chọn chế độ cài đặt này trong Nền tảng xác thực của Google > Ứng dụng, như mô tả trong phần Quản lý ứng dụng OAuth. Nếu bạn không thể thay đổi chế độ cài đặt này trên một ứng dụng khách hiện có hoặc nếu ứng dụng khách đó cũng hỗ trợ các tính năng không phải của tác nhân, hãy tạo một mã ứng dụng khách OAuth 2.0 mới cho tác nhân AI của bạn. Đối với các yêu cầu bị từ chối, tài khoản dịch vụ có quyền uỷ quyền trên toàn miền hoặc Google Apps Script, hãy xem phần Khắc phục sự cố.

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 (Nền tảng xác thực của Google) > 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 mà 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 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 mục Installed MCP Servers (Máy chủ MCP đã cài đặt), hãy nhấp vào Refresh (Làm mới).
  4. Đối với mỗi máy chủ trong danh sách (gmail, drive, docs, sheets, slides, calendar, chat, people và classroom), hãy nhấp vào Authenticate (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 Submit (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 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 Authed (Đã 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 (Nền tảng xác thực của Google) > 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 Cài đặt > Trình kết nối 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 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
    - Tệp 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
- Tệp 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 một 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 khác nhau, hãy xem bài viết Định cấu hình MCP trong ứng dụng AI.

Thêm máy chủ MCP Kiến thức cho nhà phát triển

Máy chủ MCP Kiến thức cho Google Developers là một máy chủ từ xa tìm kiếm tài liệu chính thức, trực tiếp dành cho nhà phát triển của Google, bao gồm cả developers.google.com/workspace, để tác nhân AI của bạn có thể tra cứu các phương thức API, phạm vi OAuth và mã mẫu hiện tại thay vì chỉ dựa vào dữ liệu huấn luyện. Máy chủ này cung cấp các công cụ search_documents, get_documents và answer_query, đồng thời bổ sung cho các máy chủ MCP của Google Workspace, cho phép tác nhân của bạn hành động dựa trên dữ liệu của Google Workspace. Việc thêm máy chủ MCP Kiến thức cho nhà phát triển cùng với các máy chủ đó sẽ giúp tác nhân của bạn trả lời các câu hỏi về việc xây dựng bằng API Google Workspace từ tài liệu hiện tại.

Để thêm máy chủ này vào ứng dụng AI của bạn, hãy làm theo hướng dẫn trong phần Định cấu hình IDE hoặc tác nhân lập trình rồi chọn ứng dụng của bạn. Để giúp nhân viên hỗ trợ quyết định thời điểm tìm kiếm tài liệu và công cụ cần sử dụng, hãy cài đặt cả kỹ năng của nhân viên hỗ trợ retrieving-developer-knowledge.

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 của bạn, 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.
"Khi nào tôi có cuộc họp tiếp theo với Ariel?"

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 về 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.
"Kiểm tra tài liệu chính thức của Google Workspace để biết phạm vi OAuth mà công cụ Gmail create_draft yêu cầu, sau đó soạn email gửi đến ariel@example.com để xác nhận kế hoạch tiếp thị."

Nếu bạn đã thêm máy chủ MCP Kiến thức cho nhà phát triển, thì ứng dụng sẽ gọi search_documents để tìm phạm vi trong tài liệu tham khảo về MCP của Gmail, sau đó sử dụng gmail.create_draft để tạo bản nháp.

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

Khắc phục sự cố

Hãy tham khảo các phần sau để giải quyết các vấn đề thường gặp về việc xác thực và kết nối với máy chủ MCP của Google Workspace.

Kiểm tra sự kiện trong nhật ký OAuth

Nếu bạn gặp vấn đề khi kết nối với máy chủ MCP, hãy kiểm tra lỗi trong nhật ký OAuth. Hãy yêu cầu quản trị viên Google Workspace xem xét sự kiện trong nhật ký OAuth trong công cụ điều tra bảo mật.

Yêu cầu bị từ chối từ ứng dụng OAuth do người dùng uỷ quyền

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 mã ứng dụng khách OAuth 2.0 do người dùng uỷ quyền cho quy trình OAuth 3 bên của bạn đã chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI trong Nền tảng xác thực của Google > Ứng dụng:

Ứng dụng hiện có hỗ trợ chế độ cài đặt này: Chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI trên ứng dụng OAuth hiện có của bạn.
Không thể cập nhật ứng dụng hiện có: Tạo một ứng dụng OAuth mới, chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI rồi cập nhật ứng dụng của bạn để sử dụng ứng dụng đó.
Ứng dụng khách hiện tại cũng hỗ trợ các tính năng không phải tác nhân: Tạo một ứng dụng OAuth riêng cho tác nhân AI và giữ lại ứng dụng khách hiện tại cho các tính năng không phải tác nhân.

Để biết hướng dẫn, hãy xem phần Định cấu hình ứng dụng MCP và Quản lý ứng dụng OAuth.

Tài khoản dịch vụ có quyền uỷ quyền trên toàn miền

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 cho OAuth 2 châ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 vì tài khoản dịch vụ không được quản lý trong Google Auth Platform > Ứng dụng:

Kiểm soát quyền truy cập: Các yêu cầu gửi đến máy chủ MCP từ những tài khoản dịch vụ này không bị từ chối do thiếu chế độ cài đặt tác nhân. Thay vào đó, quyền truy cập được quản lý 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 về chế độ cài đặt của quản trị viên, 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.
Hành động nhạy cảm: Máy chủ MCP của Google Workspace vẫn trả về lời nhắc lấy thông tin biểu mẫu để xác nhận có sự can thiệp của con người nằm trong quy trình đối với các lệnh gọi công cụ nhạy cảm được thực hiện thông qua tính năng mạo danh người dùng uỷ quyền trên toàn miền.

Yêu cầu từ Apps Script

Nếu gọi máy chủ MCP từ Apps Script, 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 trên ứng dụng OAuth mặc định mà Apps Script tạo và quản lý cho tập lệnh của bạn. Đ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 Google Cloud tiêu chuẩn.

Để gọi máy chủ MCP từ Apps Script, 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ì tức là ứng dụng MCP của bạn 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 OIDC, thì bạn sẽ không nhận được mã thông báo truy cập.

Kiểm tra xem ứng dụng MCP của bạn có hỗ trợ các tham số uỷ quyền tuỳ chỉnh hay không:

Ứng dụng khách hỗ trợ các tham số uỷ quyền tuỳ chỉnh: 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 prompt=consent.
Ứng dụng không hỗ trợ các tham số uỷ quyền tuỳ chỉnh: Đă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 chỉ dẫn ẩ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

Thêm máy chủ MCP Kiến thức cho nhà phát triển

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

Khắc phục sự cố

Kiểm tra sự kiện trong nhật ký OAuth

Yêu cầu bị từ chối từ ứng dụng OAuth do người dùng uỷ quyền

Tài khoản dịch vụ có quyền uỷ quyền trên toàn miền

Yêu cầu từ Apps Script

Lời nhắc đăng nhập lặp lại hằng giờ

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