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 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ả tin nhắn 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 Tìm kiếm chung cung cấp một cách 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 cho từng sản phẩm.
Điều kiện tiên quyết
Một dự án trên Google Cloud. Để tạo một 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 một thiết bị đầu cuối trực tuyến đã thiết lập CLI gcloud, hãy kích hoạt Cloud Shell:
Bộ biên dịch ngôn ngữ lệnh cục bộ
Để sử dụng môi trường phát triển cục bộ, hãy làm theo các bước sau:
- Cài đặt Google Cloud CLI.
Nếu bạn đã cài đặt CLI 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. - Nếu bạn đang sử dụng một nhà cung cấp danh tính bên ngoài (IdP), hãy đăng nhập vào CLI gcloud bằng danh tính liên kết của bạn. Để biết thêm thông tin, hãy xem bài viết Đăng nhập vào CLI gcloud bằng danh tính liên kết của bạn.
- Khởi động CLI gcloud.
- Cài đặt Google Cloud CLI.
Nếu bạn đã cài đặt CLI 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
Định cấu hình Máy chủ MCP Tìm kiếm chung
Để 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 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 các API
Để sử dụng Máy chủ MCP Tìm kiếm chung, hãy bật API Google Workspace MCP và các API cho những sản phẩm mà bạn muốn tìm kiếm trong dự án trên Google Cloud:
- API Gmail
- API Google Drive
- API Lịch Google
- Google Chat API
API Google Workspace MCP
CLI
gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
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 bảng điều khiển Cloud:
Thiết lập màn hình xin phép bằng OAuth
Máy chủ MCP Tìm kiếm chung 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 thì mới 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 bằng OAuth cho các máy chủ MCP khác, hãy đảm bảo rằng 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ủ các lựa chọn này và chỉ tìm kiếm trên những 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.readonlyhttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/chat.messages.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 chỉ cấp quyền truy cập vào 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 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 trong email của bạn hoặc trả về kết quả trên Gmail.
- Trong bảng điều khiển Cloud, hãy chuyển đến Nền tảng xác thực của Google > Quyền truy cập dữ liệu.
- Nhấp vào Thêm hoặc xoá phạm vi.
Thêm một hoặc nhiều phạm vi sau:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/chat.messages.readonly
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 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 Tìm kiếm chung 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.
Tạo mã ứng dụng và khoá bí mật của ứng dụng OAuth 2.0 thuộc loại Ứng dụng web. Trong phần URI chuyển hướng được cho phép, hãy nhấp vào + Thêm URI, rồi thêm
https://antigravity.google/oauth-callbackvào trường URI. Để 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.Mở hoặc tạo tệp cấu hình
~/.gemini/antigravity/mcp_config.json.Thêm cấu hình
workspace-universalvàomcp_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.
Lưu
mcp_config.json.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):
- 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).
- Chuyển đến phần Tuỳ chỉnh.
- Trong phần Máy chủ MCP đã cài đặt, hãy nhấp vào Làm mới.
- Tìm
workspace-universaltrong danh sách, nhấp vào Xác thực, đăng nhập vào Tài khoản Google, sao chép mã uỷ quyền, dán mã đó vào hộp thoại nhập và nhấp vào Gửi.
Đối với Antigravity CLI:
Khởi động Antigravity CLI:
agyMở bảng điều khiển quản lý MCP tương tác bằng cách chạy:
/mcpSử 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 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 Enter.
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-universaltrong 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ủ đã xác minh và xác thực sẽ hiển thị Đã 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-universaltrong chế độ xem trang tổng quan để kiểm tra trạng thái của máy chủ đó và xem danh sách tất cả các công cụ có sẵn.
- Đối với Antigravity IDE hoặc GUI: Nút Đăng xuất sẽ xuất hiện bên cạnh
Claude
Để thêm Máy chủ MCP Tìm kiếm chung vào Claude, hãy định cấu hình một trình kết nối tuỳ chỉnh.
Tạo mã ứng dụng và khoá bí mật của ứng dụng OAuth 2.0 thuộc loại Ứng dụng web. Để 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.
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.readonlyvàhttps://www.googleapis.com/auth/chat.messages.readonly.
- Tên máy chủ:
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 yêu cầu tìm kiếm trên nhiều sản phẩm:
- "Tìm mọi thứ 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ị là 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 câu trả lời có liên quan từ nhiều sản phẩm, thì Máy chủ MCP Tìm kiếm chung của bạn đã được định cấu hình đúng cách.
Các công cụ được hỗ trợ
Máy chủ MCP Tìm kiếm chung 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 truy vấn được cung cấp.