MCP Reference: people.googleapis.com

Máy chủ Giao thức ngữ cảnh mô hình (MCP) đóng vai trò là một proxy giữa dịch vụ bên ngoài cung cấp ngữ cảnh, dữ liệu hoặc các chức năng cho Mô hình ngôn ngữ lớn (LLM) hoặc ứng dụng AI. Các máy chủ MCP kết nối các ứng dụng AI với các hệ thống bên ngoài như cơ sở dữ liệu và dịch vụ web, chuyển đổi các phản hồi của chúng sang định dạng mà ứng dụng AI có thể hiểu được.

Công cụ MCP

Công cụ MCP là một chức năng hoặc khả năng thực thi mà máy chủ MCP cung cấp cho một LLM hoặc ứng dụng AI để thực hiện một hành động trong thế giới thực.

Máy chủ MCP people.googleapis.com có các công cụ sau:

Công cụ MCP
search_directory_people

Tìm kiếm người dùng trong thư mục Google Workspace của tổ chức bạn. Tính năng này chỉ dành cho tài khoản Google Workspace (do doanh nghiệp, trường học và các tổ chức khác sử dụng) và không dành cho Tài khoản Google cá nhân.

CÁC QUY TẮC QUAN TRỌNG CẦN TUÂN THỦ:

  • Nếu công cụ này trả về nhiều kết quả, bạn nên trình bày các kết quả đó cho người dùng và nhắc người dùng làm rõ kết quả nào cần sử dụng trước khi tiếp tục.

  • Bạn tuyệt đối không được chuyển kết quả của công cụ này sang một công cụ khác (ví dụ: gửi email, tạo bản nháp, tạo sự kiện, v.v.) mà không có sự xác nhận rõ ràng của người dùng.

  • Ngay cả khi chỉ tìm thấy kết quả của một người, bạn vẫn phải trình bày thông tin chi tiết của người đó cho người dùng và nhắc người dùng xác minh rằng đây là người mà họ muốn tìm trước khi tiếp tục các bước tiếp theo.

  • Nếu công cụ này không trả về kết quả nào, hãy chuyển sang sử dụng công cụ search_contacts.
search_contacts

Tìm kiếm người liên hệ của người dùng.

CÁC QUY TẮC QUAN TRỌNG CẦN TUÂN THỦ:

  • Nếu công cụ này trả về nhiều kết quả, bạn nên trình bày các kết quả đó cho người dùng và nhắc người dùng làm rõ kết quả nào cần sử dụng trước khi tiếp tục.

  • Bạn tuyệt đối không được chuyển kết quả của công cụ này sang một công cụ khác (ví dụ: gửi email, tạo bản nháp, tạo sự kiện, v.v.) mà không có sự xác nhận rõ ràng của người dùng.

  • Ngay cả khi chỉ tìm thấy kết quả của một người, bạn vẫn phải trình bày thông tin chi tiết của người đó cho người dùng và nhắc người dùng xác minh rằng đây là người mà họ muốn tìm trước khi tiếp tục các bước tiếp theo.
get_user_profile Nhận thông tin hồ sơ về bản thân (tên và email).

Nhận thông số kỹ thuật của công cụ MCP

Để nhận thông số kỹ thuật của công cụ MCP cho tất cả công cụ trong máy chủ MCP, hãy sử dụng phương thức tools/list. Ví dụ sau đây minh hoạ cách sử dụng curl để liệt kê tất cả các công cụ và thông số kỹ thuật hiện có trong máy chủ MCP.

Yêu cầu Curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'