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 thành phần trong Workspace của bạn. 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 trên Google Drive, sự kiện trên Lịch Google, cũng như không gian và tin nhắn trên Google Chat bằng một công cụ duy nhất.

Máy chủ MCP của Universal Search cung cấp một cách thức chuẩn hoá để các tác nhân AI tìm kiế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 lẻ theo 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 Tìm kiếm chung, bạn phải bật máy chủ này trong dự án trên đám mây Google Cloud, sau đó định cấu hình ứng dụng MCP để kết nối với máy chủ đó.

Bật các API

Để sử dụng Máy chủ MCP Tìm kiếm chung, hãy bật Google Workspace MCP API và các API cho những sản phẩm mà bạn muốn tìm kiếm trong dự án Google Cloud của mình:

  • API Gmail
  • API Google Drive
  • API Lịch Google
  • Google Chat API

  • Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

Thay PROJECT_ID bằng mã dự án trên Google Cloud.

Giao diện dòng lệnh

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

Bật các 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 đồng ý OAuth trước khi có thể tạo mã ứng dụng OAuth.

Nếu bạn đã định cấu hình màn hình xin phép 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 Tìm kiếm chung.

Khi xác thực bằng Máy chủ MCP Tìm kiếm chung, bạn có thể chọn xác thực tất cả các phạm vi được yêu cầu hoặc chỉ một số phạm vi trong số đó. Máy chủ sẽ tuân thủ những lựa chọn này và chỉ tìm kiếm trong các sản phẩm mà bạn đã 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

Máy chủ MCP của tính năng 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 chỉ cấp quyền truy cập cho https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly và https://www.googleapis.com/auth/chat.messages.readonly (và bỏ qua https://www.googleapis.com/auth/gmail.readonly), thì tính năng tìm kiếm chung sẽ chỉ trả về kết quả từ Google Drive, Google Lịch 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ả trên Gmail.

  1. Trong Cloud Console, hãy chuyển đến Google Auth Platform > Data Access (Quyền truy cập dữ liệu).
  2. Nhấp vào Add or Remove Scopes (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

  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 các máy chủ MCP của Google Workspace.

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

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

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 và khoá bí mật OAuth 2.0 thuộc loại Ứng dụng web. Trong phần 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. Để biết hướng dẫn, hãy xem phần Đị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 mà bạn đã tạo.
    • OAUTH_CLIENT_SECRET: Khoá bí mật của ứng dụng 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. Khởi độ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. Dùng các phím mũi tên để chọn workspace-universal, 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 trên 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 và đang chạy đúng cách:

    • Đố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 mục 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ủ đã xác minh và xác thực sẽ hiển thị trạng thái 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ác công cụ có sẵn của máy chủ đó.

Claude

Để thêm Máy chủ MCP Tìm kiếm toàn bộ 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 và khoá bí mật OAuth 2.0 thuộc loại Ứng dụng web. Để biết hướng dẫn, hãy xem phần Đị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 máy chủ MCP từ xa: https://workspacemcp.googleapis.com/mcp/v1
    • Mã ứng dụng OAuth và khoá bí mật của ứng dụng 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 và https://www.googleapis.com/auth/chat.messages.readonly.

Kiểm thử Máy chủ MCP Tìm kiếm chung

Hãy thử đặt cho ứng dụng MCP những câu hỏi cần 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 và những ghi chú cũng như tin nhắn trò chuyện mới nhất về kế hoạch đó là gì?"

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

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

Máy chủ MCP của Universal Search cung cấp công cụ sau:

  • search_corpus: Thực hiện tìm kiếm trên nhiều sản phẩm của Google Workspace (Google Drive, Gmail, Lịch Google và Google Chat) dựa trên cụm từ tìm kiếm được cung cấp.