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 Toàn cầu 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 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

  • Một dự án trên Google Cloud. Để tạo dự án, hãy xem bài viết Tạo dự án.

  • Một ứng dụng MCP, chẳng hạn như Google Antigravity.

  • Để chạy các lệnh trên trang này, hãy thiết lập CLI gcloud trong một trong các môi trường phát triển sau:

    Cloud Shell

    Để sử dụng thiết bị đầu cuối trực tuyến với giao diện dòng lệnh gcloud đã được thiết lập sẵn, hãy kích hoạt Cloud Shell:

    Kích hoạt Cloud Shell

    Local shell

    Để sử dụng môi trường phát triển cục bộ, hãy làm theo các bước sau:

    1. Cài đặt Google Cloud CLI. Nếu bạn đã cài đặt giao diện dòng lệnh gcloud trước đó, hãy đảm bảo rằng bạn đang dùng phiên bản mới nhất bằng cách chạy gcloud components update.
    2. Nếu bạn đang sử dụng một nhà cung cấp dịch vụ danh tính (IdP) bên ngoài, hãy đăng nhập vào gcloud CLI bằng danh tính được liên kết của bạn. Để biết thêm thông tin, hãy xem phần Đăng nhập vào gcloud CLI bằng danh tính liên kết.
    3. Khởi động CLI gcloud.

Cấu hình máy chủ MCP tìm kiếm toàn cầu

Để 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 đã 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 cần thiết cho Máy chủ MCP Tìm kiếm Toàn cầu.

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ủ tôn trọng các lựa chọn này và chỉ tìm kiếm trong các sản phẩm mà người dùng đã 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), tìm kiếm toàn diện chỉ trả về kết quả từ Google Drive, Google Calendar và Google Chat. Nó không tìm kiếm trong email của bạn hoặc trả về kết quả tìm kiếm của 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 Thêm hoặc xóa 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 Cấu hình máy chủ Google Workspace MCP.

Đị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 Các URI chuyển hướng được ủy 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 của bạn (ví dụ: nhấp vào Cài đặt ở góc dưới 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ã xác thực, dán vào hộp thoại nhập liệu và 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 IDE hoặc GUI của Antigravity: Một nút Đăng xuất sẽ hiển thị bên cạnh workspace-universal trong phần Tùy 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 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 bảng điều khiển để kiểm tra trạng thái và liệt kê tất cả các công cụ có sẵn của nó.

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 câu hỏi cho khách hàng MCP của bạn về những vấn đề cần tìm kiếm thông tin trên nhiều sản phẩm khác nhau:

  • "Tìm bất cứ thứ gì 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.