Cho phép các trợ lý AI tìm kiếm trên Workspace bằng Máy chủ tìm kiếm chung MCP cho Workspace

Máy chủ MCP Tìm kiếm chung cho Google Workspace sử dụng tiêu chuẩn Giao thức ngữ cảnh mô hình (MCP) để cho phép các tác nhân AI tìm kiếm các cấu phần phần mềm của bạn trên Workspace. Máy chủ này cung cấp một cách để tìm kiếm trên nhiều sản phẩm của Google Workspace, bao gồm cả thư trong Gmail, tệp trong Google Drive, sự kiện trên Lịch Google và không gian cũng như tin nhắn trong Google Chat, bằng một công cụ duy nhất.

Máy chủ MCP Tìm kiếm chung cung cấp một cách thức chuẩn hoá để các tác nhân AI tìm thông tin trên toàn bộ tài khoản Google Workspace của bạn mà không cần gọi các công cụ riêng cho từng sản phẩm.

Điều kiện tiên quyết

Định cấu hình máy chủ MCP của tính năng Tìm kiếm toàn bộ

Để sử dụng Máy chủ MCP của tìm kiếm phổ quát, bạn phải bật máy chủ này trong dự án trên đám mây của Google Cloud, sau đó định cấu hình ứng dụng MCP để kết nối với máy chủ đó.

Bật API

Để sử dụng Máy chủ MCP của Universal Search, hãy bật API MCP của Google Workspace trong dự án trên đám mây của Google Cloud của bạn:

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn.

Giao diện dòng lệnh

Bật các API trong Google Cloud Console:

Bật API

Máy chủ MCP của Universal Search sử dụng OAuth 2.0 để xác thực và uỷ quyền. Bạn phải định cấu hình màn hình xin phép bằng OAuth trước khi có thể tạo mã ứng dụng khách OAuth.

Nếu bạn đã định cấu hình màn hình xin phép bằng OAuth cho các máy chủ MCP khác, hãy đảm bảo bạn đã thêm các phạm vi bắt buộc cho Máy chủ MCP của Universal Search.

Khi xác thực bằng Máy chủ MCP của tính năng Tìm kiếm chung, bạn có thể chọn xác thực tất cả phạm vi được yêu cầu hoặc chỉ một số phạm vi trong số đó. Máy chủ tôn trọng những lựa chọn này và chỉ tìm kiếm trên những sản phẩm đã được cấp quyền truy cập.

Ví dụ: nếu bạn xác thực bằng tất cả các phạm vi sau:

  • 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
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.memberships.readonly

Máy chủ MCP Tìm kiếm chung sẽ tìm kiếm trên Gmail, Google Drive, Lịch Google và Google Chat.

Tuy nhiên, nếu bạn bỏ qua https://www.googleapis.com/auth/gmail.readonly và chỉ cấp quyền truy cập vào https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.spaces.readonly và https://www.googleapis.com/auth/chat.memberships.readonly, thì tính năng tìm kiếm chung chỉ trả về kết quả từ Google Drive, Lịch Google và Google Chat. Tính năng này không tìm kiếm email của bạn hoặc trả về kết quả trong Gmail.

  1. Trong Google Cloud Console, hãy chuyển đến Nền tảng xác thực của Google > Truy cập dữ liệu.
  2. Nhấp vào Thêm hoặc xoá phạm vi.

  3. Thêm một hoặc nhiều phạm vi sau:

    • 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
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly

    Thêm https://www.googleapis.com/auth/chat.spaces.readonly và https://www.googleapis.com/auth/chat.memberships.readonly để máy chủ có thể biết ai đang tham gia từng cuộc trò chuyện trên Google Chat. Nếu không có các tiêu đề này, kết quả trên Google Chat sẽ được coi là nội dung chia sẻ bên ngoài và có thể cần người dùng xác nhận hoặc bị lọc ra.

  4. Nhấp vào Cập nhật, rồi nhấp vào Lưu.

Để biết hướng dẫn chi tiết về cách thiết lập màn hình xin phép, hãy xem bài viết Định cấu hình máy chủ MCP của Google Workspace.

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

Để thêm Máy chủ MCP của Universal Search vào ứng dụng MCP, hãy làm theo hướng dẫn dành cho ứng dụng của bạn.

Mã ứng dụng khách OAuth 2.0 do người dùng uỷ quyền gọi Máy chủ MCP của tính năng Tìm kiếm chung phải chọn Sử dụng ứng dụng khách này cho một tác nhân dựa trên AI trong Nền tảng xác thực của Google > Ứng dụng khách. Để cập nhật một mã ứng dụng khách OAuth 2.0 hiện có, hãy chọn chế độ cài đặt này trong Google Auth Platform > Clients (Ứng dụng), như mô tả trong phần Quản lý ứng dụng OAuth. Nếu bạn không thể thay đổi chế độ cài đặt này trên một ứng dụng khách hiện có hoặc nếu ứng dụng khách đó cũng hỗ trợ các tính năng không phải tác nhân, hãy tạo một mã ứng dụng khách OAuth 2.0 mới cho tác nhân AI của bạn. Đối với các yêu cầu bị từ chối, tài khoản dịch vụ có quyền uỷ quyền trên toàn miền hoặc Google Apps Script, hãy xem phần Khắc phục sự cố.

Antigravity

Để thêm Máy chủ MCP Universal Search vào Antigravity, hãy thêm cấu hình máy chủ vào tệp mcp_config.json. Các hướng dẫn này hỗ trợ Antigravity 2.0, Antigravity IDE và Antigravity CLI.

  1. Tạo mã ứng dụng khách OAuth 2.0 và khoá bí mật thuộc loại Ứng dụng web. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi thêm https://antigravity.google/oauth-callback vào trường URI. Chọn Sử dụng khách hàng này cho một tác nhân dựa trên AI. Để biết hướng dẫn, hãy xem bài viết Định cấu hình máy chủ MCP của Google Workspace.

  2. Mở hoặc tạo tệp cấu hình ~/.gemini/config/mcp_config.json.

  3. Thêm cấu hình workspace-universal vào mcp_config.json:

    {
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Thay thế nội dung sau:

    • OAUTH_CLIENT_ID: Mã ứng dụng khách mà bạn đã tạo.
    • OAUTH_CLIENT_SECRET: Khoá bí mật của ứng dụng khách mà bạn đã tạo.

  4. Tiết kiệm mcp_config.json.

  5. Xác thực máy chủ MCP. Bạn có thể xác thực bằng chế độ cài đặt GUI hoặc CLI:

    • Đối với Antigravity IDE hoặc GUI (Antigravity 2.0):

      1. Mở màn hình cài đặt (ví dụ: nhấp vào Cài đặt ở dưới cùng bên trái hoặc mở Cài đặt người dùng Antigravity).
      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. Tìm workspace-universal trong danh sách, nhấp vào Xác thực, đăng nhập vào Tài khoản Google của bạn, sao chép mã uỷ quyền, dán mã đó vào hộp thoại nhập rồi nhấp vào Gửi.

    • Đối với Antigravity CLI:

      1. Bắt đầu sử dụng Antigravity CLI:

        agy

      2. Mở bảng điều khiển quản lý MCP tương tác bằng cách chạy:

        /mcp

      3. Sử dụng các phím mũi tên để chọn workspace-universal, di chuyển đến thao tác Xác thực rồi nhấn phím Enter. Hoàn tất quy trình đăng nhập trong trình duyệt, sao chép mã uỷ quyền, dán mã đó vào lời nhắc của thiết bị đầu cuối rồi nhấn phím Enter.

  6. Xác minh rằng máy chủ được định cấu hình chính xác và đang chạy:

    • Đối với Antigravity IDE hoặc GUI: Nút Đăng xuất sẽ xuất hiện bên cạnh workspace-universal trong phần Tuỳ chỉnh > Máy chủ MCP đã cài đặt.
    • Đối với Antigravity CLI: Mở bảng điều khiển /mcp để xem các máy chủ MCP đã định cấu hình. Các máy chủ đã được xác minh và xác thực sẽ hiển thị Authed (Đã xác thực) bên cạnh tên của chúng trong bảng điều khiển TUI tương tác. Bạn có thể chọn máy chủ workspace-universal trong chế độ xem trang tổng quan để kiểm tra trạng thái và liệt kê tất cả công cụ có sẵn.

Claude

Để thêm Máy chủ MCP Universal Search vào Claude, hãy định cấu hình một trình kết nối tuỳ chỉnh.

  1. Tạo mã ứng dụng khách OAuth 2.0 và khoá bí mật thuộc loại Ứng dụng web, rồi chọn Sử dụng ứng dụng khách này cho một tác nhân dựa trên AI. Để biết hướng dẫn, hãy xem bài viết Định cấu hình máy chủ MCP của Google Workspace.

  2. Trong phần cài đặt Claude, hãy thêm một trình kết nối tuỳ chỉnh:

    • Tên máy chủ: Universal Search MCP Server
    • URL của máy chủ MCP từ xa: https://workspacemcp.googleapis.com/mcp/v1
    • Mã ứng dụng khách OAuth và Khoá bí mật của ứng dụng khách OAuth: Nhập thông tin đăng nhập của bạn.
    • Phạm vi: Bao gồm 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, https://www.googleapis.com/auth/chat.spaces.readonly và https://www.googleapis.com/auth/chat.memberships.readonly.

Kiểm thử máy chủ MCP của tính năng Tìm kiếm toàn bộ

Hãy thử đặt cho ứng dụng MCP những câu hỏi yêu cầu tìm kiếm trên nhiều sản phẩm:

  • "Tìm mọi nội dung liên quan đến Dự án X 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ì?"

Nếu các công cụ thực thi thành công và bạn nhận được phản hồi có liên quan từ nhiều sản phẩm, thì tức là Máy chủ MCP Tìm kiếm chung của bạn đã được định cấu hình đúng cách.

Công cụ được hỗ trợ

Máy chủ MCP của Universal Search cung cấp công cụ sau. Để biết giản đồ đầu vào và đầu ra, hãy xem Tài liệu tham khảo về MCP của tính năng Tìm kiếm chung.

  • search_corpus: Tìm kiếm trên nhiều sản phẩm của Google Workspace, bao gồm cả Drive, Gmail, Lịch và Chat, dựa trên câu hỏi được cung cấp.