MCP Reference: gmailmcp.googleapis.com

นี่คือเซิร์ฟเวอร์ MCP ที่ Gmail API จัดหาให้ เซิร์ฟเวอร์นี้มีเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์เพื่อสร้างแอปพลิเคชัน LLM บน Gmail

เซิร์ฟเวอร์ Model Context Protocol (MCP) ทำหน้าที่เป็นพร็อกซีระหว่างบริการภายนอกที่ให้บริบท ข้อมูล หรือความสามารถแก่โมเดลภาษาขนาดใหญ่ (LLM) หรือแอปพลิเคชัน AI เซิร์ฟเวอร์ MCP จะเชื่อมต่อแอปพลิเคชัน AI กับระบบภายนอก เช่น ฐานข้อมูลและบริการเว็บ โดยแปลการตอบกลับเป็นรูปแบบที่แอปพลิเคชัน AI เข้าใจได้

การตั้งค่าเซิร์ฟเวอร์

คุณต้องกำหนดค่าเซิร์ฟเวอร์ Gmail MCP ก่อนใช้งาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Google และ Google Cloud ได้ที่ ภาพรวมของเซิร์ฟเวอร์ MCP ของ Google Cloud

ปลายทางของเซิร์ฟเวอร์

ปลายทางบริการ MCP คือที่อยู่เครือข่ายและอินเทอร์เฟซการสื่อสาร (โดยปกติจะเป็น URL) ของเซิร์ฟเวอร์ MCP ที่แอปพลิเคชัน AI (โฮสต์สำหรับไคลเอ็นต์ MCP) ใช้เพื่อสร้างการเชื่อมต่อที่ปลอดภัยและได้มาตรฐาน ซึ่งเป็นจุดติดต่อสำหรับ LLM ในการขอบริบท เรียกเครื่องมือ หรือเข้าถึงทรัพยากร ปลายทาง MCP ของ Google อาจเป็นแบบทั่วโลกหรือระดับภูมิภาค

เซิร์ฟเวอร์ MCP ของ Gmail API มีปลายทาง MCP ทั่วโลกดังนี้

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

เครื่องมือ MCP

เครื่องมือ MCP คือฟังก์ชันหรือความสามารถที่ดำเนินการได้ซึ่งเซิร์ฟเวอร์ MCP แสดงต่อ LLM หรือแอปพลิเคชัน AI เพื่อดำเนินการในโลกแห่งความเป็นจริง

เครื่องมือ

เซิร์ฟเวอร์ MCP ของ gmailmcp.googleapis.com มีเครื่องมือดังนี้

เครื่องมือ MCP
create_draft

สร้างอีเมลฉบับร่างใหม่ในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

เครื่องมือนี้รับอีเมลของผู้รับ หัวเรื่อง และเนื้อหาเป็นข้อมูลป้อนเข้า และแสดงผลรหัสของฉบับร่าง Gmail ที่สร้างขึ้น
list_drafts

แสดงรายการอีเมลฉบับร่างจากบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

เครื่องมือนี้สามารถกรองฉบับร่างตามสตริงค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการฉบับร่าง รวมถึงรหัสและหัวเรื่อง
get_thread ดึงข้อมูลชุดข้อความอีเมลที่เฉพาะเจาะจงจากบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว รวมถึงรายการข้อความในชุดข้อความ
search_threads

แสดงรายการชุดข้อความอีเมลจากบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

เครื่องมือนี้สามารถกรองชุดข้อความตามสตริงค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการชุดข้อความ รวมถึงรหัสและข้อความที่เกี่ยวข้อง ข้อความที่เกี่ยวข้องแต่ละข้อความจะมีรายละเอียดต่างๆ เช่น ข้อมูลสรุปของเนื้อหาข้อความ หัวเรื่อง ผู้ส่ง ผู้รับ เป็นต้น โปรดทราบว่าเครื่องมือนี้จะไม่แสดงเนื้อหาข้อความฉบับเต็ม ให้ใช้เครื่องมือ "get_thread" กับรหัสชุดข้อความเพื่อดึงข้อมูลเนื้อหาข้อความฉบับเต็มหากจำเป็น
label_thread

เพิ่มป้ายกำกับลงในชุดข้อความทั้งหมดในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว การดำเนินการนี้จะส่งผลต่อข้อความทั้งหมดที่อยู่ในชุดข้อความในปัจจุบันและข้อความที่จะเพิ่มลงในชุดข้อความในอนาคต

หากไม่แน่ใจเกี่ยวกับรหัสชุดข้อความ ให้ใช้เครื่องมือ search_threads ก่อน

หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อนเพื่อค้นหาป้ายกำกับที่พร้อมใช้งานและรหัสของป้ายกำกับ
unlabel_thread นำป้ายกำกับออกจากชุดข้อความทั้งหมดในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว หากไม่แน่ใจเกี่ยวกับรหัสชุดข้อความ ให้ใช้เครื่องมือ search_threads ก่อน หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อน
list_labels แสดงรายการป้ายกำกับทั้งหมดที่ผู้ใช้กำหนดไว้ซึ่งพร้อมใช้งานในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ใช้เครื่องมือนี้เพื่อค้นหา id ของป้ายกำกับของผู้ใช้ก่อนที่จะเรียก label_thread, unlabel_thread, label_message, หรือ unlabel_message เครื่องมือนี้จะไม่แสดงป้ายกำกับของระบบ แต่สามารถใช้กับรหัสที่รู้จักกันดีได้ เช่น "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT"
label_message

เพิ่มป้ายกำกับอย่างน้อย 1 รายการลงในข้อความที่เฉพาะเจาะจงในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

หากต้องการค้นหารหัสข้อความ ให้ใช้เครื่องมือต่างๆ เช่น search_threads หรือ get_thread หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อนเพื่อค้นหาป้ายกำกับที่พร้อมใช้งานและรหัสของป้ายกำกับ
unlabel_message นำป้ายกำกับอย่างน้อย 1 รายการออกจากข้อความที่เฉพาะเจาะจงในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว หากต้องการค้นหารหัสข้อความ ให้ใช้เครื่องมือต่างๆ เช่น search_threads หรือ get_thread หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อนเพื่อค้นหาป้ายกำกับที่พร้อมใช้งานและรหัสของป้ายกำกับ
create_label สร้างป้ายกำกับใหม่ในบัญชี Gmail ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว

ดูข้อกำหนดของเครื่องมือ MCP

หากต้องการดูข้อกำหนดของเครื่องมือ MCP สำหรับเครื่องมือทั้งหมดในเซิร์ฟเวอร์ MCP ให้ใช้เมธอด tools/list ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อแสดงรายการเครื่องมือทั้งหมดและข้อกำหนดของเครื่องมือที่พร้อมใช้งานในเซิร์ฟเวอร์ MCP ในปัจจุบัน

คำขอ 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
}'