Máy chủ MCP Google Workspace trong Google Antigravity 2.0, IDE và/hoặc CLI

1. Giới thiệu

Lưu ý: Bạn có còn sử dụng Gemini CLI không? Hướng dẫn này đề cập đến Antigravity CLI. Bạn có thể xem thêm thông tin về cách chuyển đổi trong bài đăng trên blog chính thức này về Antigravity CLI.

Bạn đang dùng Gemini Enterprise? Nếu tổ chức của bạn sử dụng Gemini Enterprise, thì quản trị viên của khách hàng đủ điều kiện có thể quản lý tập trung và đưa các máy chủ MCP đã được phê duyệt vào danh sách cho phép. Tìm hiểu thêm trong bài đăng trên blog về Antigravity Enterprise và Codelab về máy chủ MCP của Google Workspace có tích hợp Antigravity trong Gemini Enterprise.

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 của bạn trên 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 các công cụ do máy chủ từ xa cung cấp một cách an toàn. Bạn sẽ thiết lập Antigravity để tương tác với Gmail, Google Drive, Google Tài liệu, Google Trang tính, Google Trang trình bày, 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ụ MCP của Google Workspace trong dự án trên đám mây của Google.
• Định cấu hình Antigravity để truy cập vào 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 đám mây của Google Cloud đã đăng ký tham gia Chương trình Bản dùng trước cho nhà phát triển của Google Workspace
• 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ể tìm 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

Chương trình Bản dùng trước cho nhà phát triển của Google Workspace: Quyền truy cập vào máy chủ MCP của Google Workspace là một phần của Chương trình Bản dùng trước công khai cho nhà phát triển. Nếu bạn chưa đăng ký, vui lòng đăng ký và đảm bảo tài khoản của bạn được chấp nhận tham gia chương trình tại https://developers.google.com/workspace/preview.

Điều kiện tiên quyết đối với doanh nghiệp: Đối với khách hàng đủ điều kiện, nếu tổ chức của bạn thực thi các chính sách của Gemini Enterprise, thì trước tiên, quản trị viên phải bật Công cụ AI cho nhà phát triển và đưa các điểm cuối của máy chủ MCP trong Google Workspace vào danh sách cho phép trong Cloud Console thì bạn mới có thể kết nối. Tìm hiểu thêm trong bài đăng trên blog về Antigravity Enterprise và Codelab về máy chủ MCP của Google Workspace có tích hợp Antigravity trong Gemini Enterprise.

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.

Bật API

Bật dịch vụ MCP

Tiếp theo, hãy bật các dịch vụ MCP của Google Workspace.

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.

1. 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.

Chuyển đến Google Chat API

2. 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 Logs (Nhật ký), hãy chọn Log errors to Logging (Ghi lỗi vào Nhật ký).
3. 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

Lưu ý dành cho doanh nghiệp: Trong môi trường Google Workspace của doanh nghiệp, quản trị viên Cloud hoặc Gemini Enterprise thường cung cấp màn hình xin phép bằng OAuth và Mã ứng dụng khách một cách tập trung. Nếu quản trị viên đã cung cấp cho bạn một Mã ứng dụng khách được phê duyệt, thì bạn có thể bỏ qua bước này và chuyển thẳng đến phần Định cấu hình Antigravity.

Các máy chủ MCP của Google Workspace sử dụng OAuth 2.0 để xác thực và uỷ quyền 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 web.

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

Trước tiên, bạn phải định cấu hình màn hình xin phép.

1. 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.
2. Đị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.
3. Đị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ộ).
4. Định cấu hình Thông tin liên hệ: Nhập địa chỉ email của bạn.
5. 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.
6. 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.
7. 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:
   • Một cỡ: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • 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.readonly
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. 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

1. 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).
2. Chọn Ứng dụng web làm loại ứng dụng.
3. Đặt tên tệp này là Antigravity.
4. 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.
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. 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 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.

1. Mở tệp đó 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 từ Antigravity IDE nếu đã cài đặt bằng cách làm theo các bước sau:

   1. Mở 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ô).
2. Sửa đổi cấu hình máy chủ MCP tuỳ chỉnh sau đây. Trước khi thực hiện, hãy thay thế 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.
3. Lưu.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

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

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

Khắc phục sự cố lỗi chính sách doanh nghiệp: Nếu một máy chủ MCP hiển thị biểu tượng Unauthorized / Blocked by Admin Policy khi bạn nhấp vào Làm mới, thì dịch vụ đó không có trong danh sách cho phép của Gemini Enterprise tại tổ chức của bạn. Hãy liên hệ với quản trị viên để thêm điểm cuối dịch vụ và chia sẻ Lớp học lập trình dành cho quản trị viên Gemini Enterprise với họ để được hướng dẫn cách thiết lập.

Antigravity 2.0

1. Nhấp vào Cài đặt ở dưới cùng bên trái.
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ủ MCP đã cài đặt trong danh sách:
   1. Nhấp vào Xác thực.
   
   2. Thực hiện quy trình xác thực trong cửa sổ trình duyệt mới mở.
   3. Sau khi hoàn tất, hãy nhấp vào Sao chép vào bảng nhớ tạm.
   
   4. Dán mã xác thực 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 Gửi.
   
   5. Nút Đăng xuất hiện được hiển thị thay cho nút Xác thực.
   

Antigravity IDE

1. 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ổ.

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ủ MCP đã cài đặt trong danh sách:
   1. Nhấp vào Xác thực.
   
   2. Thực hiện quy trình xác thực trong cửa sổ trình duyệt mới mở.
   3. Sau khi hoàn tất, hãy nhấp vào Sao chép vào bảng nhớ tạm.
   
   4. Dán mã xác thực 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 Gửi.
   
   5. Nút Đăng xuất hiện được hiển thị thay cho nút Xác thực.
   

Antigravity CLI

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

2. Đối với mỗi máy chủ MCP trong danh sách:
   1. Chọn mục đó bằng phím mũi tên lên và xuống rồi nhấn phím Enter.
   2. Chọn Xác thực bằng các phím mũi tên trái và phải rồi nhấn phím enter.
   
   3. Mở URL hiển thị trong cửa sổ trình duyệt mới và thực hiện quy trình xác thực.
   
   4. Sau khi hoàn tất, hãy nhấp vào Sao chép vào bảng nhớ tạm.
   
   5. Dán mã xác thực bạn vừa sao chép vào trường văn bản hiển thị trong thiết bị đầu cuối đang chạy Antigravity CLI rồi nhấn phím Enter.
   
   6. Trạng thái Đã xác thực hiện được hiển thị thay cho trạng thái 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 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ưu ý: Thay thế phần giữ chỗ trong ngoặc vuông trong các câu lệnh bên dưới (ví dụ: [NAME], [FILE_NAME]) bằng giá trị thực tế từ dữ liệu của bạn trên Google Workspace.

Một cỡ

Hãy thử tìm kiếm trên nhiều sản phẩm:

• "Tóm tắt trong vài câu về những việc gần đây nhất xảy ra trong tài khoản Google Workspace của tôi."
• "Tìm mọi nội dung liên quan đến [PROJECT_NAME] trong email, tài liệu và tin nhắn trò chuyện của tôi."
• "Cuộc họp tiếp theo của tôi về kế hoạch tiếp thị diễn ra khi nào? Ghi chú và tin nhắn trò chuyện mới nhất về cuộc họp đó là gì?"

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 gửi đến "[EMAIL_ADDRESS]" để yêu cầu cập nhật thông tin về dự án "[PROJECT_NAME]"."

Google Drive

Hãy thử tìm kiế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".

Google Tài liệu, Trang tính, Trang trình bày

Thử tìm kiếm tài nguyên trên Drive:

• "Cho tôi xem nội dung cấu trúc của tệp Google Tài liệu [DOCS_TITLE]."
• "Đọc trang tính Sheet1 trong tệp Google Trang tính [SHEETS_TITLE]"
• "Cho tôi xem bố cục được mô tả bằng lời của tệp Google Trang trình bày [SLIDES_TITLE]."

Lịch Google

Thử tìm kiếm 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

Thử tìm kiếm thư:

• "Tìm tin nhắn có chứa "[TỪ_KHOÁ]" trong "[TÊN_KHÔNG_GIAN]""

People API

Hãy thử tìm 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 đ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.

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:

1. Trong Google Cloud Console, hãy chuyển đến Trang tổng quan về API và dịch vụ.
2. 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.

7. 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 Antigravity.

Tài liệu tham khảo

• Giới thiệu về Giao thức ngữ cảnh mô hình (MCP)
• Định cấu hình máy chủ MCP của Google Workspace
• Định cấu hình màn hình xin phép bằng OAuth
• Tổng quan về Antigravity Enterprise
• Máy chủ MCP của Google Workspace có Antigravity trong Lớp học lập trình Gemini Enterprise
• Antigravity