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 ngữ cảnh mô hình (MCP) để kết nối Gemini CLI với dữ liệu Google Workspace. MCP là một tiêu chuẩn mở cho phép các mô hình AI sử dụng an toàn các công cụ do máy chủ từ xa cung cấp. 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ã!

Cấu trúc MCP của Google Workspace

Bạn sẽ thực hiện

Bật các dịch vụ Google Workspace MCP trong dự án trên đám mây của Google Cloud.
Định cấu hình Gemini CLI để sử dụng các dịch vụ MCP này.
Kiểm thử 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 Google Workspace.

Bạn cần có

Một trình duyệt web như Chrome
Một dự án trên Google Cloud
Một tài khoản Google Workspace
Gemini CLI được cài đặt trên máy cục bộ

Bạn sẽ chỉ mất khoảng 30 phút để hoàn tất 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, chọn hoặc tạo một dự án trên Google Cloud.

Bật các API

Để sử dụng các máy chủ Google Workspace MCP, 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 những 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 yêu cầu các API tiêu chuẩn của chúng.
Drive yêu cầu API tiêu chuẩn cho một số công cụ.
Bạn không cần bật API tiêu chuẩn cho Lịch.
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 để bật.

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

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

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

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

Trong bảng điều khiển Cloud, hãy tìm kiếm Google Chat API rồi nhấp vào Google Chat API > Manage (Quản lý) > Configuration (Định cấu hình).
Thiết lập ứng dụng Chat:
- Trong trường App name (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 Description (Nội dung mô tả), hãy nhập Chat MCP server.
- Trong phần Functionality (Chức năng), hãy tắt các tính năng tương tác bằng cách chuyển Enable interactive features (Bật các tính năng tương tác) sang trạng thái tắt.
- Trong phần Logs (Nhật ký), hãy chọn Log errors to Logging (Ghi lỗi vào Cloud Logging).
Nhấp vào Save (Lưu).

3. Định cấu hình màn hình đồng ý và ứng dụng OAuth

Các máy chủ Google Workspace MCP 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 một ứng dụng cho máy tính.

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

Trong bảng điều khiển Cloud, hãy chuyển đến Google Auth Platform > Branding (Thương hiệu). Nhấp vào Get Started (Bắt đầu) nếu chưa định cấu hình.
Định cấu hình App Information (Thông tin ứng dụng):
- App name (Tên ứng dụng): Google Workspace MCP Servers
- User support email (Email hỗ trợ người dùng): Chọn email của bạn.
Định cấu hình Audience (Đối tượng): Chọn Internal (Nội bộ) (hoặc External (Bên ngoài) nếu không có lựa chọn Nội bộ).
Định cấu hình Contact Information (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 về dữ liệu người dùng, sau đó nhấp vào Create (Tạo).
Nếu bạn chọn External (Bên ngoài), hãy chuyển đến Audience (Đối tượng) rồi thêm email của bạn trong phần Test users (Người dùng thử nghiệm).
Chuyển đến Data Access (Quyền truy cập dữ liệu) > Add or Remove Scopes (Thêm hoặc xoá phạm vi). Trong phần Manually add scopes (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 Add to Table (Thêm vào bảng), sau đó nhấp vào Update (Cập nhật) và cuối cùng là Save (Lưu).

Tạo mã ứng dụng OAuth

Chuyển đến Google Auth Platform > Clients (Ứng dụng) > Create Client (Tạo ứng dụng).
Chọn Desktop app (Ứng dụng cho máy tính) làm loại ứng dụng.
Đặt tên là Gemini CLI.
Nhấp vào Create (Tạo) rồi sao chép Client ID (Mã ứng dụng) và Client Secret (Khoá bí mật của ứng dụng). 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 chính rồi thêm cấu hình sau. Thay thế phần giữ chỗ bằng thông tin đăng nhập OAuth.

{
  "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 các máy chủ MCP

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

Bắt đầu Gemini CLI

Chạy lệnh sau trong cửa sổ dòng lệnh để bắt đầu 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ụ ở trạng thái Ready (Sẵn sàng) cùng với danh sách các công cụ của chúng.

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

Giờ đây, bạn có thể tương tác với dữ liệu Google Workspace bằng ngôn ngữ tự nhiên. Dưới đâ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:

"What are my upcoming meetings this week?"
"Do I have any free time tomorrow afternoon?" (Tôi có thời gian rảnh vào chiều mai không?)

Google Chat

Hãy thử yêu cầu Gemini tìm kiếm tin nhắn:

"Tìm tin nhắn có chứa ‘[KEYWORD]' trong ‘[SPACE_NAME]'"

Google Drive

Hãy thử yêu cầu Gemini tìm hoặc đọc tệp:

"Tìm các tệp trên Google Drive của tôi có chứa ‘[KEYWORD]'."
"List the most recent documents I edited." (Liệt kê các tài liệu gần đây nhất mà tôi đã chỉnh sửa).
"Read the content of my ‘[FILE_NAME]' doc and summarize the main goals." (Đọc nội dung của tài liệu "[FILE_NAME]" và tóm tắt các mục tiêu chính).

Gmail

Hãy thử yêu cầu Gemini tìm kiếm hoặc quản lý email của bạn:

"Summarize the last 5 emails I received."
"Draft an email to ‘[EMAIL_ADDRESS]' requesting an update on the ‘[PROJECT_NAME]' project." (Soạn một email gửi đến "[EMAIL_ADDRESS]" yêu cầu cập nhật về dự án "[PROJECT_NAME]").

People API

Hãy thử hỏi Gemini về hồ sơ hoặc danh bạ của bạn:

"According to my Google profile, what is my name?" (Theo hồ sơ trên Google của tôi, tên của tôi là gì?)
"Find contact info for ‘[NAME]'."

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 tác vụ trên nhiều dịch vụ. Hãy thử các câu lệnh sau đây minh hoạ khả năng trên nhiều dịch vụ:

"Tìm các tệp trong Drive liên quan đến "các bản cập nhật cột mốc [PROJECT_NAME]", tóm tắt nội dung của các tệp đó, tìm địa chỉ email của "[NAME]" rồi tạo một bản nháp Gmail gửi cho họ kèm theo bản tóm tắt."

Khám phá thêm các 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ử các công cụ đó, 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 API & Services Dashboard (Bảng điều khiển API và dịch vụ).
Nhấp vào từng API Google Workspace và API MCP mà bạn đã bật (ví dụ: Calendar MCP, Chat MCP) rồi nhấp vào Disable API (Tắt API).

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

8. Xin chúc mừng

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

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

Cách bật các dịch vụ Google Workspace MCP 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 các API

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

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

3. Định cấu hình màn hình đồng ý và ứng dụng OAuth

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

Tạo mã ứng dụng 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 các máy chủ MCP

Bắt đầu 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ử các 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ác 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