Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Máy chủ MCP Google Workspace trong Google Antigravity 2.0, IDE và/hoặc 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 dữ liệu Google Workspace với Antigravity 2.0, IDE và/hoặc CLI. 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 mã!

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 Antigravity để truy cập vào các dịch vụ MCP này.
Kiểm thử quá trình 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 của bạn.

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
Antigravity 2.0, IDE và/hoặc CLI được cài đặt trên máy cục bộ của bạn. Bạn có thể xem thêm thông tin chi tiết và hướng dẫn cài đặt trên trang web chính thứ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

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ủ 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ụ.
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 để 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 ứ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 (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 Enable interactive features (Bật các tính năng tương tác).
- Trong phần Logs (Nhật ký), hãy chọn Log errors to Logging (Ghi nhật ký lỗi vào Nhật ký).
Nhấp vào Save (Lưu).

3. Định cấu hình màn hình đồng ý và ứng dụng khách 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 ứng dụng khách Ứng dụng web.

Các máy chủ Google Workspace MCP 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 > Branding (Nền tảng xác thực của Google > Xây dựng thương hiệu). Nhấp vào Get Started (Bắt đầu) nếu bạn 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ó 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 vào 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 các 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 khách OAuth

Chuyển đến Google Auth Platform > Clients (Nền tảng xác thực của Google > Ứng dụng khách) > Create Client (Tạo ứng dụng khách).
Chọn Web application (Ứng dụng web) làm loại ứng dụng.
Đặt tên là Antigravity.
Trong phần Authorized redirect URIs (URI chuyển hướng được uỷ quyền), hãy nhấp vào + Add URI (+ Thêm URI) rồi nhập https://antigravity.google/oauth-callback.
Nhấp vào Create (Tạo) rồi sao chép Client ID (Mã ứng dụng khách) và Client Secret (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 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 2.0, IDE và/hoặc CLI, hãy làm theo hướng dẫn trên trang web Antigravity.

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

Antigravity 2.0, IDE và CLI dùng chung một cấu hình MCP trung tâm trong tệp ~/.gemini/config/mcp_config.json.

Mở tệp này trong trình chỉnh sửa văn bản mà bạn muốn.
Lưu ý: Bạn có thể truy cập trực tiếp vào tệp này từ Antigravity IDE nếu đã cài đặt bằng cách làm theo các bước sau:
1. 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.
2. 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 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 trình giữ chỗ <YOUR_CLIENT_ID> và <YOUR_CLIENT_SECRET> bằng mã ứng dụng khách và khoá bí mật OAuth mà bạn đã tạo trong 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>"
      }
    }
    ...
  }
  ...
}

Lưu tệp này.

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

Bạn sẽ thấy tất cả các máy chủ MCP mà bạn đã định cấu hình là đã cài đặt trong Antigravity: gws-calendar, gws-chat, gws-drive, gws-gmail và gws-people. Bạn cần xác thực từng máy chủ trong số đó cho từng giao diện Antigravity vì các mã thông báo OAuth không được tập trung.

Antigrativity 2.0

Nhấp vào Settings (Cài đặt) ở dưới cùng bên trái.
Chuyển đến phần Customizations (Tuỳ chỉnh).
Trong phần Installed MCP Servers (Máy chủ MCP đã cài đặt), hãy nhấp vào Refresh (Làm mới).

Đối với từng máy chủ MCP đã cài đặt được liệt kê:
1. Nhấp vào Authenticate (Xác thực).
1. Thực hiện quy trình xác thực trong cửa sổ trình duyệt mới mở ra.
2. Sau khi hoàn tất, hãy nhấp vào Copy to Clipboard (Sao chép vào bảng nhớ tạm).
1. 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 2.0 rồi nhấp vào Submit (Gửi).
1. Nút Sign out (Đăng xuất) hiện đã thay thế nút Authenticate (Xác thực).

Antigrativity IDE

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

Chuyển đến phần Customizations (Tuỳ chỉnh).
Trong phần Installed MCP Servers (Máy chủ MCP đã cài đặt), hãy nhấp vào Refresh (Làm mới).

Đối với từng máy chủ MCP đã cài đặt được liệt kê:
1. Nhấp vào Authenticate (Xác thực).
1. Thực hiện quy trình xác thực trong cửa sổ trình duyệt mới mở ra.
2. Sau khi hoàn tất, hãy nhấp vào Copy to Clipboard (Sao chép vào bảng nhớ tạm).
1. Dán mã xác thực 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 IDE rồi nhấp vào Submit (Gửi).
1. Nút Sign out (Đăng xuất) hiện đã thay thế nút Authenticate (Xác thực).

Antigrativity CLI

Nhập /mcp rồi nhấn enter.

Đối với từng máy chủ MCP được liệt kê:
1. Chọn máy chủ đó bằng các phím mũi tên lên và xuống rồi nhấn enter.
2. Chọn Authenticate (Xác thực) bằng các phím mũi tên trái và phải rồi nhấn enter.
1. Mở URL xuất hiện trong một cửa sổ trình duyệt mới rồi thực hiện quy trình xác thực.
1. Sau khi hoàn tất, hãy nhấp vào Copy to Clipboard (Sao chép vào bảng nhớ tạm).
1. 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 thiết bị đầu cuối của bạn khi Antigravity CLI đang chạy rồi nhấn enter.
1. Trạng thái Authed (Đã xác thực) hiện đã thay thế trạng thái Auth Needed (Cần xác thực).

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

Giờ đây, bạn có thể tương tác với dữ liệu Google Workspace của mình 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ụ.