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.

Bắt đầu sử dụng MCP của Google Workspace và Gemini CLI

1. Giới thiệu

Trong lớp học lập trình này, bạn sẽ tìm hiểu cách sử dụng Giao thức bối cảnh mô hình (MCP) để kết nối Gemini CLI với dữ liệu của bạn trên Google Workspace. MCP là một tiêu chuẩn mở cho phép các mô hình AI sử dụng các công cụ do máy chủ từ xa cung cấp một cách an toàn. Bạn sẽ sử dụng Gemini CLI làm ứng dụng để tương tác với Gmail, Google Drive, Lịch Google, Google Chat và People API mà không cần viết mã!

Kiến trúc MCP của Google Workspace

Bạn sẽ thực hiện

Bật các dịch vụ MCP của Google Workspace trong dự án trên đám mây của Google.
Định cấu hình Gemini CLI để sử dụng các dịch vụ MCP này.
Thử nghiệm tính năng tích hợp bằng các câu lệnh thú vị và hữu ích tương tác với dữ liệu của bạn trên Google Workspace.

Bạn cần có

Một trình duyệt web, chẳng hạn như Chrome
Một dự án trên Google Cloud
Tài khoản Google Workspace
Gemini CLI được cài đặt trên máy cục bộ của bạn

Bạn sẽ mất khoảng 30 phút để hoàn thành lớp học lập trình này.

Dễ dàng truy cập vào lớp học lập trình này

Mã QR để truy cập vào lớp học lập trình này

2. Trước khi bắt đầu

Tạo hoặc chọn một dự án trên Google Cloud

Trong Google Cloud Console, hãy chọn hoặc tạo một dự án trên đám mây của Google Cloud.

Bật API

Để sử dụng máy chủ MCP của Google Workspace, bạn phải bật các API Google Workspace tiêu chuẩn. Mặc dù một số máy chủ MCP hoạt động độc lập, nhưng một số máy chủ khác vẫn yêu cầu bật API tiêu chuẩn cơ bản:

Gmail và Chat vẫn cần có API tiêu chuẩn.
Drive yêu cầu API tiêu chuẩn cho một số công cụ.
Lịch không yêu cầu bật API tiêu chuẩn.
People API xử lý cả quyền truy cập tiêu chuẩn và chức năng MCP, vì vậy, API này không có dịch vụ MCP riêng biệt để bật.

Bật dịch vụ MCP

Tiếp theo, hãy bật các dịch vụ MCP chuyên biệt cho sản phẩm.

Đị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.
Thiết lập ứng dụng Chat:
- Trong trường Tên ứng dụng, hãy nhập Chat MCP.
- Trong trường Avatar URL (URL hình đại diện), hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.
- Trong phần Nội dung mô tả, hãy nhập Chat MCP server.
- Trong phần Chức năng, hãy tắt chế độ Bật các tính năng tương tác.
- Trong phần Nhật ký, hãy chọn Ghi lỗi vào Logging.
Nhấp vào Lưu.

3. Định cấu hình ứng dụng khách và màn hình xin phép bằng OAuth

Máy chủ MCP của Google Workspace sử dụng OAuth 2.0 để xác thực an toàn. Bạn phải định cấu hình màn hình xin phép bằng OAuth và tạo ứng dụng khách cho ứng dụng dành cho máy tính.

Các máy chủ MCP của Google Workspace sử dụng OAuth 2.0 để xác thực. Trước tiên, bạn phải định cấu hình màn hình xin phép.

Trong Google Cloud Console, hãy chuyển đến Google Auth Platform > Xây dựng thương hiệu. Nhấp vào Bắt đầu nếu chưa được định cấu hình.
Định cấu hình Thông tin ứng dụng:
- Tên ứng dụng: Google Workspace MCP Servers
- Email hỗ trợ người dùng: Chọn email của bạn.
Định cấu hình Đối tượng: Chọn Nội bộ (hoặc Bên ngoài nếu không có lựa chọn Nội bộ).
Định cấu hình Thông tin liên hệ: Nhập địa chỉ email của bạn.
Xem xét và đồng ý với Chính sách dữ liệu người dùng, sau đó nhấp vào Tạo.
Nếu bạn chọn Bên ngoài, hãy chuyển đến phần Đối tượng rồi thêm email của bạn vào mục Người dùng thử nghiệm.
Chuyển đến phần Truy cập dữ liệu > Thêm hoặc xoá phạm vi. Trong phần Thêm phạm vi theo cách thủ công, hãy thêm các phạm vi sau cho những máy chủ bạn muốn sử dụng:
- 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.users.readstate.readonly
- Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
- Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
- People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
Nhấp vào Thêm vào bảng, sau đó nhấp vào Cập nhật, rồi nhấp vào Lưu.

Tạo mã ứng dụng khách OAuth

Khi định cấu hình ứng dụng OAuth 2.0 cho máy chủ MCP của Google Workspace, bạn phải bật chế độ cài đặt phân loại tác nhân (is_agentic) bằng cách chọn Sử dụng ứng dụng này cho tác nhân dựa trên AI. Những ứng dụng OAuth không bật chế độ cài đặt này sẽ bị chặn gọi các điểm cuối MCP của Google Workspace.

Chuyển đến Nền tảng xác thực của Google > Ứng dụng khách > Tạo ứng dụng khách (hoặc API và dịch vụ > Thông tin xác thực > Tạo thông tin xác thực > Mã ứng dụng khách OAuth).
Chọn Ứng dụng dành cho máy tính làm loại ứng dụng.
Đặt tên tệp này là Gemini CLI.
Chọn Sử dụng ứng dụng này cho một tác nhân dựa trên AI để bật cờ phân loại is_agentic trên ứng dụng OAuth.
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. Bạn sẽ cần những thông tin này trong bước tiếp theo.

4. Định cấu hình Gemini CLI

Bây giờ, hãy định cấu hình Gemini CLI để sử dụng các điểm cuối này. Nếu bạn chưa cài đặt Gemini CLI, hãy làm theo hướng dẫn cài đặt trên trang web Gemini CLI.

Tạo tệp cấu hình

Mở hoặc tạo ~/.gemini/settings.json trong thư mục gốc rồi thêm cấu hình sau. Thay thế phần giữ chỗ bằng thông tin đăng nhập OAuth của bạn.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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.users.readstate.readonly"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Xác thực và xác minh máy chủ MCP

Trước khi có thể sử dụng máy chủ MCP, bạn phải xác thực và xác minh rằng các máy chủ đó đã được kết nối.

Bắt đầu sử dụng Gemini CLI

Chạy lệnh sau trong cửa sổ dòng lệnh để khởi động Gemini CLI:

gemini

Xác thực

Xác thực bằng các dịch vụ bạn muốn kiểm thử bằng cách chạy lệnh tương ứng trong Gemini CLI. Bạn chỉ cần xác thực bằng các dịch vụ mà bạn dự định sử dụng trong lớp học lập trình này.

Lịch

/mcp auth calendar

Trò chuyện

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Mọi người

/mcp auth people

Làm theo lời nhắc trong trình duyệt để uỷ quyền cho từng dịch vụ.

Xác minh kết nối

Xác minh rằng các công cụ đã được tải và sẵn sàng:

/mcp list

Bạn sẽ thấy kết quả cho biết các dịch vụ là Ready cùng với các công cụ được liệt kê.

6. Kiểm thử máy chủ MCP

Giờ đây, bạn có thể tương tác với dữ liệu của mình trên Google Workspace bằng ngôn ngữ tự nhiên. Sau đây là một số câu lệnh mẫu cho từng dịch vụ.

Lịch Google

Hãy thử hỏi Gemini về lịch biểu của bạn:

"Tôi có những cuộc họp nào sắp tới trong tuần này?"
"Chiều mai tôi có rảnh không?"

Google Chat

Hãy thử hỏi Gemini để tìm tin nhắn:

"Tìm tin nhắn có chứa "[TỪ KHOÁ]" trong "[TÊN_KHÔNG_GIÂN]""

Google Drive

Hãy thử hỏi Gemini để tìm hoặc đọc tệp:

"Tìm tệp trên Google Drive của tôi có chứa "[TỪ KHOÁ]"."
"Liệt kê những tài liệu tôi chỉnh sửa gần đây nhất."
"Đọc nội dung trong tài liệu "[FILE_NAME]" của tôi và tóm tắt các mục tiêu chính".

Gmail

Hãy thử hỏi Gemini để tìm kiếm hoặc quản lý email của bạn:

"Tóm tắt 5 email gần đây nhất mà tôi nhận được."
"Soạn email gửi đến "[EMAIL_ADDRESS]" để yêu cầu cập nhật thông tin về dự án "[PROJECT_NAME]"."

People API

Hãy thử hỏi Gemini về hồ sơ hoặc người liên hệ của bạn:

"Theo hồ sơ trên Google của tôi, tên tôi là gì?"
"Tìm thông tin liên hệ của [TÊN]".

Kết hợp nhiều dịch vụ

Sức mạnh thực sự của MCP được thể hiện khi Gemini điều phối các nhiệm vụ trên nhiều dịch vụ. Hãy thử những câu lệnh sau để trải nghiệm các tính năng trên nhiều dịch vụ:

"Tìm các tệp trong Drive liên quan đến "thông tin cập nhật về mốc quan trọng của [TÊN_DỰ_ÁN]", tóm tắt nội dung của các tệp đó, tìm địa chỉ email của "[TÊN]" và tạo một thư nháp trong Gmail để gửi cho họ kèm theo bản tóm tắt."

Khám phá thêm công cụ

Đây chỉ là một vài ví dụ về những việc bạn có thể làm. Để xem danh sách đầy đủ các công cụ có sẵn cho từng dịch vụ và dùng thử, hãy tham khảo phần Sản phẩm được hỗ trợ trong tài liệu chính thức.

7. Dọn dẹp

Để dọn dẹp dự án mà không xoá dự án, bạn có thể tắt các API và dịch vụ MCP mà bạn đã bật:

Trong Google Cloud Console, hãy chuyển đến Trang tổng quan về API và dịch vụ.
Nhấp vào từng API Google Workspace và MCP mà bạn đã bật (ví dụ: Lịch MCP, Chat MCP) rồi nhấp vào Tắt API.

Xoá thông tin xác thực ứng dụng OAuth trong bảng điều khiển Nền tảng xác thực của Google nếu bạn không còn dự định sử dụng thông tin xác thực đó nữa.

8. Xin chúc mừng

Xin chúc mừng! Bạn đã định cấu hình và thử nghiệm thành công các máy chủ MCP chính thức của Google Workspace bằng Gemini CLI.

Kiến thức bạn học được

Cách bật các dịch vụ MCP của Google Workspace trong Google Cloud.
Cách định cấu hình ứng dụng OAuth cho MCP.
Cách sử dụng Gemini CLI để tương tác với dữ liệu Google Workspace bằng các công cụ tiêu chuẩn.

Bắt đầu sử dụng MCP của Google Workspace và Gemini CLI

1. Giới thiệu

Bạn sẽ thực hiện

Bạn cần có

Dễ dàng truy cập vào lớp học lập trình này

2. Trước khi bắt đầu

Tạo hoặc chọn một dự án trên Google Cloud

Bật API

Bật dịch vụ MCP

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

3. Định cấu hình ứng dụng khách và màn hình xin phép bằng OAuth

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

Tạo mã ứng dụng khách OAuth

4. Định cấu hình Gemini CLI

Tạo tệp cấu hình

5. Xác thực và xác minh máy chủ MCP

Bắt đầu sử dụng Gemini CLI

Xác thực

Lịch

Trò chuyện

Drive

Gmail

Mọi người

Xác minh kết nối

6. Kiểm thử máy chủ MCP

Lịch Google

Google Chat

Google Drive

Gmail

People API

Kết hợp nhiều dịch vụ

Khám phá thêm công cụ

7. Dọn dẹp

8. Xin chúc mừng

Kiến thức bạn học được

Tài liệu tham khảo