Đây là máy chủ Giao thức bối cảnh mô hình (MCP) do Gmail API cung cấp. Máy chủ này cung cấp các công cụ để nhà phát triển xây dựng ứng dụng mô hình ngôn ngữ lớn (LLM) dựa trên Gmail.
Máy chủ Giao thức bối cảnh mô hình (MCP) hoạt động như một proxy giữa một dịch vụ bên ngoài cung cấp bối cảnh, dữ liệu hoặc các tính năng cho một Mô hình ngôn ngữ lớn (LLM) hoặc ứng dụng AI. 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 phản hồi của các hệ thống này thành một định dạng mà ứng dụng AI có thể hiểu được.
Thiết lập máy chủ
Bạn phải định cấu hình máy chủ MCP Gmail 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ủ cho ứng dụng MCP) sử dụng để thiết lập một kết nối an toàn, được chuẩn hoá. Đây là điểm liên hệ để LLM yêu cầu bối cảnh, gọi một công cụ hoặc truy cập vào một tài nguyên. Điểm cuối MCP của Google có thể là điểm cuối toàn cầu hoặc điểm cuối theo khu vực.
Máy chủ MCP của Gmail API có điểm cuối MCP toàn cầu sau đây:
- https://gmailmcp.googleapis.com/mcp/v1
Công cụ MCP
Công cụ MCP là một hàm hoặc tính năng có thể thực thi mà máy chủ MCP hiển thị 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 gmailmcp.googleapis.com có các công cụ sau:
| Công cụ MCP | |
|---|---|
| create_draft |
Tạo một thư nháp mới trong tài khoản Gmail của người dùng đã xác thực. Công cụ này nhận địa chỉ người nhận, tiêu đề và nội dung thư làm dữ liệu đầu vào. Công cụ này trả về mã nhận dạng của thư nháp Gmail đã tạo. |
| list_drafts |
Liệt kê các thư nháp trong tài khoản Gmail của người dùng đã xác thực. Công cụ này có thể lọc thư nháp dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về danh sách thư nháp, bao gồm cả mã nhận dạng và tiêu đề của các thư nháp đó. |
| get_thread | Truy xuất một chuỗi email cụ thể từ tài khoản Gmail của người dùng đã xác thực, bao gồm cả danh sách các thư trong chuỗi đó. |
| search_threads |
Liệt kê các chuỗi email từ tài khoản Gmail của người dùng đã xác thực. Công cụ này có thể lọc chuỗi dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về danh sách chuỗi, bao gồm cả mã nhận dạng và các thư liên quan. Mỗi thư liên quan chứa thông tin chi tiết như trích đoạn nội dung thư, tiêu đề, người gửi, người nhận, v.v. Xin lưu ý rằng công cụ này không trả về toàn bộ nội dung thư; hãy sử dụng công cụ "get_thread" với mã nhận dạng chuỗi để tìm nạp toàn bộ nội dung thư nếu cần. |
| label_thread |
Thêm nhãn vào toàn bộ chuỗi trong tài khoản Gmail của người dùng đã xác thực. Thao tác này ảnh hưởng đến tất cả các thư hiện có trong chuỗi và mọi thư trong tương lai được thêm vào chuỗi đó. Nếu không chắc chắn về mã nhận dạng chuỗi, hãy sử dụng công cụ Nếu không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ |
| unlabel_thread |
Xoá nhãn khỏi toàn bộ chuỗi trong tài khoản Gmail của người dùng đã xác thực. Nếu không chắc chắn về mã nhận dạng chuỗi, hãy sử dụng công cụ search_threads trước. Nếu không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ list_labels trước.
|
| list_labels |
Liệt kê tất cả các nhãn do người dùng xác định có trong tài khoản Gmail của người dùng đã xác thực. Sử dụng công cụ này để khám phá id của nhãn người dùng trước khi gọi label_thread, unlabel_thread, label_message hoặc unlabel_message. Công cụ này không trả về nhãn hệ thống nhưng có thể sử dụng với các mã nhận dạng đã biết: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".
|
| label_message |
Thêm một hoặc nhiều nhãn vào một thư cụ thể trong tài khoản Gmail của người dùng đã xác thực. Để tìm mã nhận dạng thư, hãy sử dụng các công cụ như |
| unlabel_message |
Xoá một hoặc nhiều nhãn khỏi một thư cụ thể trong tài khoản Gmail của người dùng đã xác thực. Để tìm mã nhận dạng thư, hãy sử dụng các công cụ như search_threads hoặc get_thread. Nếu không chắc chắn về mã nhận dạng nhãn của người dùng, hãy sử dụng công cụ list_labels trước để khám phá các nhãn hiện có và mã nhận dạng của các nhãn đó.
|
| create_label | Tạo một nhãn mới trong tài khoản Gmail của người dùng đã xác thực. |
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á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://gmailmcp.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 }' |