MCP Reference: chatmcp.googleapis.com

Chat MCP API cung cấp MCP từ xa cho các tính năng trò chuyện của Google Chat.

Máy chủ Giao thức ngữ cảnh mô hình (MCP) hoạt động như 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.

Thiết lập máy chủ

Bạn phải thiết lập máy chủ MCP của Chat trước khi sử dụng. Để biết thêm thông tin về cách sử dụng máy chủ MCP từ xa của Google và Google Cloud, hãy xem bài viết Tổng quan về máy chủ MCP của Google Cloud.

Điểm cuối của máy chủ

Điểm cuối dịch vụ MCP là địa chỉ mạng và giao diện giao tiếp (thường là một URL) của máy chủ MCP mà một ứng dụng AI (Máy chủ lưu trữ cho ứng dụng MCP) sử dụng để thiết lập một kết nối an toàn, tiêu chuẩn. Đây là đầu mối liên hệ để LLM yêu cầu ngữ cảnh, gọi một công cụ hoặc truy cập vào một tài nguyên. Các điểm cuối MCP của Google có thể là toàn cầu hoặc theo khu vực.

Máy chủ MCP của Chat API có điểm cuối MCP chung sau đây:

  • https://chatmcp.googleapis.com/mcp/v1

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.

Công cụ

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

Công cụ MCP
list_messages Truy xuất tin nhắn từ một cuộc trò chuyện cụ thể trên Google Chat (Không gian, tin nhắn trực tiếp (DM) hoặc tin nhắn trực tiếp theo nhóm). Cho phép lọc theo chuỗi, phạm vi thời gian và số lượng tin nhắn. Ngoài ra, bạn có thể truy xuất trang tiếp theo của các thông báo để có thêm ngữ cảnh. Tin nhắn riêng tư (chỉ một người dùng xem được) sẽ bị lọc.
search_conversations

Tìm kiếm các cuộc trò chuyện trên Google Chat theo tên hiển thị.

Nếu bạn chỉ cung cấp người tham gia, công cụ này sẽ tìm thấy tin nhắn trực tiếp 1:1 (nếu bạn cung cấp một người tham gia) hoặc cuộc trò chuyện nhóm (nếu bạn cung cấp nhiều người tham gia) có người tham gia được chỉ định và người dùng gọi.

Nếu bạn chỉ cung cấp một truy vấn, thì công cụ này sẽ tìm kiếm những cuộc trò chuyện có truy vấn là một chuỗi con không phân biệt chữ hoa chữ thường trong tên hiển thị của cuộc trò chuyện.

Nếu bạn cung cấp cả người tham gia và cụm từ tìm kiếm, công cụ này sẽ tìm các cuộc trò chuyện theo người tham gia rồi lọc theo tên hiển thị.

Nếu bạn không cung cấp người tham gia hoặc truy vấn, thì công cụ này sẽ liệt kê tất cả các cuộc trò chuyện mà người dùng gọi là thành viên.

Công cụ này chỉ liệt kê những cuộc trò chuyện mà người dùng gọi là thành viên.

LƯU Ý QUAN TRỌNG: Danh sách "cuộc trò chuyện" trống không có nghĩa là không còn kết quả nào nữa. Nếu có "next_page_token", bạn có thể tìm nạp thêm các trang. Nếu bạn nhận được một danh sách trống nhưng có "next_page_token", hãy hỏi người dùng xem bạn có nên tiếp tục tìm kiếm hay không.

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://chatmcp.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
}'