Máy chủ MCP của Google Workspace trong Antigravity

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 Antigravity với dữ liệu 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 an toàn các công cụ do máy chủ từ xa cung cấp. Bạn sẽ thiết lập Antigravity để tương tác với Gmail, Google Drive, Lịch Google, Google Chat và People API mà không cần viết bất kỳ mã nào!

Cấu 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 Cloud của bạn.
Định cấu hình Antigravity để truy cập vào các dịch vụ MCP này.
Kiểm thử việc 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 như Chrome
Một dự án trên Google Cloud
Tài khoản Google Workspace
Antigravity được cài đặt trên máy cục bộ của bạn

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

Trong Google Cloud Console, hãy 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ủ 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 những máy chủ khác vẫn yêu cầu bạn 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 đối với một số công cụ.
Lịch không yêu cầu bạn 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 để bật.

Bật dịch vụ MCP

Tiếp theo, hãy bật các dịch vụ MCP chuyên dụng 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 bảng điều khiển Cloud, 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 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 mục Nhật ký, hãy chọn Ghi lỗi vào tính năng Ghi nhật ký.
Nhấp vào Lưu.

3. Định cấu hình sự đồng ý và ứng dụng khách OAuth

Các 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 một ứng dụng web.

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 bảng điều khiển Cloud, hãy chuyển đến Google Auth Platform > Thương hiệu. Nhấp vào Bắt đầu nếu bạn chưa đị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ộ).
Thiết lập 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 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 kiểm thử.
Chuyển đến Quyền truy cập vào 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 những phạm vi sau cho các máy chủ mà 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 OAuth

Truy cập vào Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng.
Chọn Ứng dụng web làm loại ứng dụng.
Đặt tên tệp này là Antigravity.
Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI rồi nhập https://antigravity.google/oauth-callback.
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. Bạn sẽ cần những thông tin này trong bước tiếp theo.

4. Thiết lập Antigravity

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

Thêm máy chủ MCP tuỳ chỉnh

Mở MCP Servers (Máy chủ MCP) thông qua trình đơn thả xuống ... ở đầu bảng điều khiển tác nhân của trình chỉnh sửa.

Nhấp vào Manage MCP Servers (Quản lý máy chủ MCP), rồi nhấp vào View raw config (Xem cấu hình thô).

Sửa đổi tệp mcp_config.json vừa mở bằng cấu hình máy chủ MCP tuỳ chỉnh sau. Trước khi thực hiện, hãy thay thế các phần giữ chỗ <YOUR_CLIENT_ID> và <YOUR_CLIENT_SECRET> bằng mã ứng dụng OAuth và khoá bí mật của ứng dụng OAuth mà bạn đã tạo ở các bước trước:

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Quay lại phần Quản lý máy chủ MCP rồi nhấp vào Làm mới.

Xác thực máy chủ MCP tuỳ chỉnh

Mở Antigravity User Settings (Chế độ cài đặt người dùng Antigravity) thông qua trình đơn thả xuống Editor-Specific settings (Chế độ cài đặt dành riêng cho trình chỉnh sửa) ở đầu cửa sổ.

Chuyển đến phần Tuỳ chỉnh.

Đối với mỗi máy chủ có trong phần INSTALLED MCP SERVERS (CÁC MÁY CHỦ MCP ĐÃ CÀI ĐẶT):
1. Nhấp vào Xác thực.

Thực hiện quy trình xác thực trong cửa sổ trình duyệt mới mở ra.
Sau khi hoàn tất, hãy nhấp vào Sao chép vào khay nhớ tạm.

Đóng cửa sổ trình duyệt.
Dán mã uỷ quyền mà bạn vừa sao chép vào trường văn bản xuất hiện trong phần cài đặt của Antigravity.
Nhấp vào Gửi.

5. Công cụ kiểm thử

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 ví dụ cho từng dịch vụ.

Lịch Google

Hãy thử tìm kiếm trong lịch biểu của bạn:

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

Google Chat

Thử tìm kiếm thư:

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

Google Drive

Hãy thử tìm kiếm hoặc đọc tệp:

"Tìm những tệp trên Google Drive của tôi có chứa "[TỪ KHOÁ]".
"Liệt kê những tài liệu gần đây nhất mà tôi đã chỉnh sửa."
"Đọ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ử 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 cho "[EMAIL_ADDRESS]" để yêu cầu thông tin cập nhật về dự án "[PROJECT_NAME]"."

People API

Hãy thử tìm kiếm trong hồ sơ hoặc danh bạ của bạn:

"Theo hồ sơ trên Google của tôi, tên của 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 điều phối các tác vụ trên nhiều dịch vụ. Hãy thử những câu lệnh sau đây để khám phá 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 "[PROJECT_NAME] milestone updates" (thông tin cập nhật về 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 email nháp trong Gmail cho họ kèm theo bản tóm tắt."

Khám phá các công cụ khá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.

6. 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ụ: 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ếu bạn không còn dự định sử dụng thông tin đăng nhập đó nữa.

7. 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ủ MCP chính thức của Google Workspace bằng Antigravity.