Gmail มีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ AI Agent โต้ตอบกับข้อมูล Gmail ได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ MCP ของ Gmail จะช่วยให้คุณเปิดใช้แอปพลิเคชัน AI เช่น Google Antigravity และ Claude เพื่อดำเนินการใน Gmail ได้
เซิร์ฟเวอร์ MCP ของ Gmail มีวิธีมาตรฐานสำหรับ AI Agent ในการดำเนินการต่อไปนี้
- อ่านข้อมูล: ค้นหาอีเมล ดึงข้อมูลชุดข้อความ และแสดงรายการป้ายกำกับ
- ดำเนินการ: สร้างอีเมลฉบับร่างและติดป้ายกำกับข้อความ
- เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้
ข้อกำหนดเบื้องต้น
การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace
โปรเจ็กต์ Google Cloud คุณสามารถสร้างหรือเลือกโปรเจ็กต์ได้ในระหว่างการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว หรือดูหัวข้อสร้างโปรเจ็กต์
โฮสต์ MCP ซึ่งเป็นแอปพลิเคชัน AI เช่น Google Antigravity หรือ Claude แอปพลิเคชัน AI จะสร้างการเชื่อมต่อไคลเอ็นต์ MCP สำหรับเซิร์ฟเวอร์ MCP แต่ละรายการ
หากต้องการเรียกใช้คำสั่ง
gcloudสำหรับการตั้งค่าด้วยตนเองในหน้านี้ ให้ตั้งค่า gcloud CLI ในสภาพแวดล้อมการพัฒนาซอฟต์แวร์ในเครื่องโดยทำตามขั้นตอนต่อไปนี้- ติดตั้ง Google Cloud CLI
หากติดตั้ง gcloud CLI ไว้ก่อนหน้านี้ ให้ตรวจสอบว่าคุณมีเวอร์ชันล่าสุดโดยเรียกใช้
gcloud components update - หากคุณใช้ผู้ให้บริการข้อมูลประจำตัว (IdP) ภายนอก ให้ลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวภายนอก ดูข้อมูลเพิ่มเติมได้ที่หัวข้อลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวแบบรวม
- เริ่มต้น gcloud CLI
- ติดตั้ง Google Cloud CLI
หากติดตั้ง gcloud CLI ไว้ก่อนหน้านี้ ให้ตรวจสอบว่าคุณมีเวอร์ชันล่าสุดโดยเรียกใช้
กำหนดค่าเซิร์ฟเวอร์ MCP ของ Gmail
หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Gmail ให้ตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ด้วยไคลเอ็นต์ OAuth 2.0 ของ AI Agent และกำหนดค่าแอปพลิเคชัน AI ให้เชื่อมต่อกับโปรเจ็กต์ดังกล่าว โดยทำดังนี้
- การใช้งานส่วนตัว: หากคุณกำลังเชื่อมต่อแอปพลิเคชัน AI สำหรับบัญชี Google ของคุณเอง ให้ใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัวเพื่อกำหนดค่าโปรเจ็กต์ เปิดใช้ API และบริการ MCP และสร้างไคลเอ็นต์ OAuth ในหน้าเดียว
- การตั้งค่าสำหรับผู้ใช้หลายคนหนึ่งเครื่องหรือการตั้งค่าที่กำหนดเอง: หากผู้ใช้หลายคนจะลงชื่อเข้าใช้ด้วยไคลเอ็นต์ OAuth ของคุณ หรือหากต้องการเปิดใช้เฉพาะ API, บริการ MCP และขอบเขต OAuth บางรายการ ให้เริ่มที่เปิดใช้ API
การตั้งค่าอย่างรวดเร็วสำหรับการใช้งานส่วนตัว
ใช้การเริ่มต้นใช้งานโหมดส่วนตัวในคอนโซล Google Cloud เพื่อสร้างไคลเอ็นต์ OAuth 2.0 ที่ใช้ได้กับบัญชี Google ของคุณเท่านั้น และไม่จำเป็นต้องมีการตรวจสอบแอปหรือการตั้งค่าหน้าจอขอความยินยอม OAuth แยกต่างหาก โดยทำดังนี้
เปิดการเริ่มต้นใช้งานโหมดส่วนตัวในคอนโซล Google Cloud ปุ่มนี้จะเลือกไคลเอ็นต์เว็บแอปพลิเคชันไว้ล่วงหน้า ซึ่ง Google Antigravity และ Claude กำหนดให้ต้องใช้
หากไคลเอ็นต์ MCP ใช้ขั้นตอน OAuth บนเดสก์ท็อปหรืออุปกรณ์เคลื่อนที่แทน URI การเปลี่ยนเส้นทางเว็บ ให้เปิดการตั้งค่าโหมดส่วนตัวสำหรับไคลเอ็นต์แอปบนเดสก์ท็อป, Android หรือ iOS หรือเปลี่ยนประเภทแอปพลิเคชันในหน้าเว็บ
ในส่วนเลือกโปรเจ็กต์ ให้เลือกโปรเจ็กต์โหมดส่วนตัวที่มีอยู่ หรือคลิกสร้างโปรเจ็กต์ใหม่ หากได้รับข้อความแจ้ง ให้กรอกแบบฟอร์มการสร้างโปรเจ็กต์ให้เสร็จสมบูรณ์
กำหนดค่ารายละเอียดไคลเอ็นต์ OAuth ดังนี้
- ป้อนชื่อของไคลเอ็นต์
- หากประเภทแอปพลิเคชันเป็นเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม URI Callback ของไคลเอ็นต์ MCP ดังนี้
- สำหรับ Antigravity:
https://antigravity.google/oauth-callback - สำหรับ Claude:
https://claude.ai/api/mcp/auth_callback
- สำหรับ Antigravity:
- ตรวจสอบว่าได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI
อ่านนโยบายข้อมูลผู้ใช้บริการ Google API เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้ แล้วคลิกต่อไป
คอนโซลจะเปิดใช้ Google Workspace API หลักและบริการ MCP ในโปรเจ็กต์ของคุณ และสร้างไคลเอ็นต์ OAuth
คัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ แล้วเชื่อมต่อไคลเอ็นต์กับเซิร์ฟเวอร์ MCP โดยข้ามขั้นตอนที่ 1 เนื่องจากคุณมีรหัสไคลเอ็นต์ OAuth และรหัสลับอยู่แล้ว
เปิดใช้ API
โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
หากต้องการใช้เซิร์ฟเวอร์ Gmail MCP ให้เปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
Gmail API
CLI
gcloud services enable gmail.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้
เปิดใช้บริการ MCP
โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับ Gmail ให้เปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
Gmail MCP API
CLI
gcloud services enable gmailmcp.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้
ตั้งค่าหน้าจอขอความยินยอม OAuth
โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
เซิร์ฟเวอร์ MCP ของ Gmail ใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์
หากกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถกำหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ให้คลิกเริ่มต้นใช้งาน
- ในส่วน App Information ให้พิมพ์
Gmail MCP Serverใน App name - ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลของคุณหรือ Google Group ที่เหมาะสม
- คลิกถัดไป
- ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือกภายในไม่ได้ ให้เลือกภายนอก
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้บริการ Google API และหากคุณยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- หากเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
- คลิกกลุ่มเป้าหมาย
- ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
- ป้อนอีเมลของคุณและผู้ใช้ทดสอบที่ได้รับอนุญาตคนอื่นๆ แล้วคลิกบันทึก
- ในส่วน App Information ให้พิมพ์
คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับเซิร์ฟเวอร์ MCP ของ Gmail ดังนี้
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.composehttps://www.googleapis.com/auth/gmail.modify
คลิกเพิ่มลงในตาราง
คลิกอัปเดต
หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ในหน้าการเข้าถึงข้อมูล ให้คลิกบันทึก
กำหนดค่าแอปพลิเคชัน AI
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Gmail ลงในแอปพลิเคชัน AI ให้ทำตามวิธีการสำหรับแอปพลิเคชันของคุณ
รหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์ซึ่งเรียกใช้เซิร์ฟเวอร์ Gmail MCP ต้องเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ หากต้องการอัปเดตรหัสไคลเอ็นต์ OAuth 2.0 ที่มีอยู่ ให้เลือกการตั้งค่านี้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ ตามที่อธิบายไว้ในหัวข้อจัดการไคลเอ็นต์ OAuth หากคุณเปลี่ยนการตั้งค่านี้ในไคลเอ็นต์ที่มีอยู่ไม่ได้ หรือหากไคลเอ็นต์รองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย ให้สร้างรหัสไคลเอ็นต์ OAuth 2.0 ใหม่สำหรับ AI Agent สำหรับคำขอที่ถูกปฏิเสธ บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน หรือ Google Apps Script โปรดดูหัวข้อการแก้ปัญหา
Antigravity
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Gmail ไปยัง Antigravity ให้เพิ่มการกำหนดค่าเซิร์ฟเวอร์ลงในไฟล์ mcp_config.json วิธีการเหล่านี้รองรับ Antigravity 2.0, Antigravity IDE และ Antigravity CLI
สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 หรือข้ามไปยังขั้นตอนถัดไปหากคุณสร้างไว้แล้วในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client
เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน
ป้อนชื่อ
ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม
https://antigravity.google/oauth-callbackในช่อง URIเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์
เปิดหรือสร้างไฟล์การกำหนดค่า
~/.gemini/config/mcp_config.jsonเพิ่มการกำหนดค่า
mcpServersลงในmcp_config.jsonดังนี้{ "mcpServers": { "gmail": { "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }แทนที่ค่าต่อไปนี้
OAUTH_CLIENT_ID: รหัสไคลเอ็นต์ที่คุณสร้างขึ้นOAUTH_CLIENT_SECRET: รหัสลับไคลเอ็นต์ที่คุณสร้าง
ประหยัด
mcp_config.jsonตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP คุณสามารถตรวจสอบสิทธิ์โดยใช้การตั้งค่า GUI หรือ CLI ก็ได้ ดังนี้
สำหรับ Antigravity IDE หรือ GUI (Antigravity 2.0)
- เปิดหน้าจอการตั้งค่า (เช่น คลิกการตั้งค่าที่ด้านซ้ายล่าง หรือเปิดการตั้งค่าผู้ใช้ Antigravity)
- ไปที่การปรับแต่ง
- ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช
- ค้นหา
gmailในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง
สำหรับ Antigravity CLI
เริ่ม Antigravity CLI:
agyเปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้
/mcpใช้ปุ่มลูกศรเพื่อเลือก
gmailจากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter
ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้
- สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะปรากฏข้างเซิร์ฟเวอร์ในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง
- สำหรับ Antigravity CLI: เปิดแผง
/mcpเพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงตรวจสอบสิทธิ์แล้วข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์ใดก็ได้ในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มี
เซิร์ฟเวอร์ MCP ระยะไกลพร้อมใช้งานใน Antigravity แล้ว
Claude
หากต้องการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Gmail กับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Gmail ไปยัง Claude ให้กำหนดค่าเครื่องมือเชื่อมต่อที่กำหนดเองด้วยรหัสไคลเอ็นต์ OAuth และรหัสลับ
สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 หรือข้ามไปยังขั้นตอนถัดไปหากคุณสร้างไว้แล้วในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client
เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน
ป้อนชื่อ
ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม
https://claude.ai/api/mcp/auth_callbackในช่อง URIเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์
กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้
- ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
- คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
- ป้อนรายละเอียดการเชื่อมต่อสำหรับ Gmail ดังนี้
- ชื่อเซิร์ฟเวอร์:
Gmail - URL ของเซิร์ฟเวอร์ MCP ระยะไกล:
https://gmailmcp.googleapis.com/mcp/v1
- ชื่อเซิร์ฟเวอร์:
- ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
- คลิกเพิ่ม
อื่นๆ
แอปพลิเคชัน AI จำนวนมากมีวิธีเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล โดยปกติแล้ว คุณจะต้องป้อนรายละเอียดเกี่ยวกับเซิร์ฟเวอร์ เช่น ชื่อ, ปลายทาง, โปรโตคอลการรับส่ง และวิธีการตรวจสอบสิทธิ์ สำหรับเซิร์ฟเวอร์ MCP ระยะไกลของ Gmail ให้ป้อนข้อมูลต่อไปนี้
ชื่อเซิร์ฟเวอร์:
gmailURL ของเซิร์ฟเวอร์:
https://gmailmcp.googleapis.com/mcp/v1การส่ง: HTTP ที่สตรีมได้
การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของ Gmail ใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI สำหรับการตั้งค่าส่วนบุคคลของผู้ใช้รายเดียว คุณสามารถสร้างไคลเอ็นต์เว็บ, เดสก์ท็อป, Android หรือ iOS โดยใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
หากต้องการหลีกเลี่ยงข้อความแจ้งให้ลงชื่อเข้าใช้ทุกชั่วโมงด้วยไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชัน ให้กำหนดค่าไคลเอ็นต์ MCP เพื่อขอสิทธิ์เข้าถึงแบบออฟไลน์โดยใช้
access_type=offlineหรือขอบเขตoffline_accessโปรดดูรายละเอียดที่หัวข้อข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อแอปพลิเคชัน AI ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI
ทดสอบเซิร์ฟเวอร์ MCP ของ Gmail
หลังจากกำหนดค่าแอปพลิเคชัน AI แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ
ลองถามคำถามต่อไปนี้กับแอปพลิเคชัน AI ของคุณ
"Ariel พูดว่าอะไรในอีเมลฉบับล่าสุดเกี่ยวกับแผนการตลาดของเรา"
ไคลเอ็นต์จะกรองอีเมลจาก Ariel โดยใช้
gmail.search_threads, ดึงเนื้อหาของชุดข้อความล่าสุดด้วยgmail.get_threadแล้วสรุปให้คุณ"ร่างอีเมลถึง ariel@example.com เพื่อแจ้งว่าฉันอนุมัติแผนการตลาดแล้ว"
ไคลเอ็นต์จะใช้
gmail.create_draftเพื่อสร้างอีเมลในโฟลเดอร์ฉบับร่าง ซึ่งช่วยให้คุณตรวจสอบและส่งอีเมลจาก Gmail ได้
หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ MCP ของ Gmail ได้รับการกำหนดค่าอย่างถูกต้อง
การแก้ปัญหา
ใช้ส่วนต่อไปนี้เพื่อแก้ไขปัญหาการตรวจสอบสิทธิ์และการเชื่อมต่อที่พบบ่อยกับเซิร์ฟเวอร์ MCP ของ Gmail
ตรวจสอบเหตุการณ์ในบันทึกของ OAuth
หากพบปัญหาในการเชื่อมต่อกับเซิร์ฟเวอร์ MCP ให้ตรวจสอบข้อผิดพลาดในบันทึก OAuth ขอให้ผู้ดูแลระบบ Google Workspace ตรวจสอบเหตุการณ์ในบันทึกของ OAuth ในเครื่องมือตรวจสอบความปลอดภัย
คำขอที่ถูกปฏิเสธจากไคลเอ็นต์ OAuth ที่ผู้ใช้มอบสิทธิ์
หากคำขอไปยังเซิร์ฟเวอร์ MCP ถูกปฏิเสธ ให้ตรวจสอบว่ารหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์สำหรับขั้นตอน OAuth แบบ 3 ทางได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ไว้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์
- ไคลเอ็นต์ที่มีอยู่รองรับการตั้งค่า: เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ในไคลเอ็นต์ OAuth ที่มีอยู่
- อัปเดตไคลเอ็นต์ที่มีอยู่ไม่ได้: สร้างไคลเอ็นต์ OAuth ใหม่โดยเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI แล้วอัปเดตแอปเพื่อใช้ไคลเอ็นต์ดังกล่าว
- ไคลเอ็นต์ที่มีอยู่ยังรองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย: สร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับ AI Agent และเก็บไคลเอ็นต์ที่มีอยู่ไว้สำหรับฟีเจอร์ที่ไม่ใช่ Agent
โปรดดูวิธีการที่หัวข้อกำหนดค่าแอปพลิเคชัน AI และจัดการไคลเอ็นต์ OAuth
บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน
หากแอปใช้บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมนสำหรับ OAuth แบบ 2-legged คุณจะเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ไม่ได้ เนื่องจากบัญชีบริการไม่ได้จัดการในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์
- การควบคุมการเข้าถึง: คำขอไปยังเซิร์ฟเวอร์ MCP จากบัญชีบริการเหล่านี้จะไม่ถูกปฏิเสธเนื่องจากไม่มีการตั้งค่าตัวแทน แต่จะควบคุมการเข้าถึงด้วยการตั้งค่าการมอบสิทธิ์ทั่วทั้งโดเมนที่ผู้ดูแลระบบ Google Workspace เป็นผู้จัดการ ดูรายละเอียดเกี่ยวกับการตั้งค่าของผู้ดูแลระบบได้ที่หัวข้อควบคุมการเข้าถึง API ด้วยการมอบสิทธิ์ทั่วทั้งโดเมน
- การดำเนินการที่มีความละเอียดอ่อน: เซิร์ฟเวอร์ MCP ของ Google Workspace จะยังคงแสดงพรอมต์การดึงข้อมูลแบบฟอร์มสำหรับการยืนยันแบบมีมนุษย์ร่วมในการเรียกใช้เครื่องมือที่มีความละเอียดอ่อนซึ่งดำเนินการผ่านการสวมบทบาทเป็นผู้ใช้ที่มีการมอบสิทธิ์ทั่วทั้งโดเมน
คำขอจาก Apps Script
หากเรียกใช้เซิร์ฟเวอร์ MCP จาก Apps Script คุณจะเลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ในไคลเอ็นต์ OAuth เริ่มต้นที่ Apps Script สร้างและจัดการสำหรับสคริปต์ของคุณไม่ได้ ซึ่งจะมีผลแม้ว่าสคริปต์จะใช้โปรเจ็กต์ Google Cloud มาตรฐานก็ตาม
หากต้องการเรียกใช้เซิร์ฟเวอร์ MCP จาก Apps Script ให้ทำดังนี้
- ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ สร้างไคลเอ็นต์ OAuth แล้วเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
- ในสคริปต์ ให้ใช้ไลบรารี OAuth2 สำหรับ Apps Script เพื่อให้สิทธิ์ผู้ใช้ด้วยไคลเอ็นต์ OAuth นั้น
- เมื่อเรียกใช้เซิร์ฟเวอร์ MCP ให้ส่งโทเค็นเพื่อการเข้าถึงที่ไลบรารีแสดงผลแทนโทเค็นจาก
ScriptApp.getOAuthToken
โปรเจ็กต์ Apps Script ที่ไม่ได้เรียกใช้เซิร์ฟเวอร์ MCP ของ Google Workspace จะไม่ได้รับผลกระทบ
ข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง
หากระบบแจ้งให้คุณลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง แสดงว่าไคลเอ็นต์ MCP ไม่ได้รับหรือใช้โทเค็นการรีเฟรช ซึ่งมักเกิดขึ้นในสถานการณ์ต่อไปนี้
- ไม่มีการเข้าถึงแบบออฟไลน์ในไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชัน: ไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชันจะใช้การเข้าถึงแบบออนไลน์โดยค่าเริ่มต้น ซึ่งต่างจากไคลเอ็นต์ OAuth ของแอปบนเดสก์ท็อป หากต้องการขอโทเค็นการรีเฟรช ให้ใส่
access_type=offlineหรือใส่ขอบเขต OpenID Connect (OIDC)offline_accessควบคู่ไปกับขอบเขต API อย่างน้อย 1 รายการ และอย่าตั้งค่าaccess_type=online - การให้สิทธิ์อีกครั้งแก่แอปที่ได้รับความยินยอมแล้ว: เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเมื่อผู้ใช้ให้สิทธิ์เข้าถึงแบบออฟไลน์เป็นครั้งแรก หากผู้ใช้ให้สิทธิ์ไคลเอ็นต์ OAuth ของคุณแล้วโดยไม่มีการเข้าถึงแบบออฟไลน์ หรือหากไคลเอ็นต์ MCP ของคุณสูญเสียโทเค็นการรีเฟรชที่จัดเก็บไว้ การลงชื่อเข้าใช้ครั้งต่อๆ ไปอาจไม่แสดงโทเค็นการรีเฟรชใหม่ รวม
prompt=consentไว้ในคำขอการให้สิทธิ์ หรือนำสิทธิ์เข้าถึงของแอปออกในการเชื่อมต่อบัญชี Google แล้วลงชื่อเข้าใช้อีกครั้ง - โทเค็นสำหรับผู้ถือแบบคงที่: หากคุณส่งโทเค็นเพื่อการเข้าถึงแบบข้อมูลดิบในส่วนหัว
Authorizationเช่น เอาต์พุตจากgcloud auth print-access-tokenโทเค็นจะหมดอายุหลังจากผ่านไป 1 ชั่วโมง เว้นแต่ไคลเอ็นต์จะรีเฟรช
โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง
ข้อมูลอ้างอิงเกี่ยวกับเครื่องมือ
เครื่องมือต่อไปนี้พร้อมใช้งานสำหรับเซิร์ฟเวอร์ MCP ของ Gmail ดูสคีมาอินพุตและเอาต์พุตได้ที่เอกสารอ้างอิง MCP ของ Gmail
create_draftget_messageget_threadlabel_messagelabel_threadlist_draftslist_labelssearch_threadsunlabel_messageunlabel_thread
ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม
เมื่อคุณแสดงโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ จะมีความเสี่ยงต่อการโจมตีแบบแทรกพรอมต์โดยอ้อม เนื่องจากแอปพลิเคชัน AI เช่น Google Antigravity มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ MCP ของ Gmail จึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ของคุณได้
เพื่อลดความเสี่ยงเหล่านี้ คุณต้องคัดกรองพรอมต์และคำตอบเพื่อหาเนื้อหาที่เป็นอันตรายหรือการโจมตีแบบแทรกพรอมต์ คุณสามารถใช้ Model Armor ที่ Google มีให้ หรือจะใช้โซลูชันของคุณเองก็ได้หากคุณจัดทำเอกสารเพื่อให้ผู้ใช้ยอมรับความเสี่ยงนั้นได้ โปรดดูวิธีการที่หัวข้อกำหนดค่าความปลอดภัยสำหรับเซิร์ฟเวอร์ MCP ของ Google Workspace
ทำตามแนวทางปฏิบัติแนะนำต่อไปนี้
- ใช้เฉพาะเครื่องมือที่เชื่อถือได้ อย่าเชื่อมต่อเซิร์ฟเวอร์ Gmail MCP กับแอปพลิเคชันที่ไม่น่าเชื่อถือหรือไม่ได้รับการยืนยัน
- โปรดระมัดระวังอินพุตที่ไม่น่าเชื่อถือ หลีกเลี่ยงการขอให้แอปพลิเคชัน AI ประมวลผลอีเมลหรือแหล่งข้อมูลอื่นๆ จากแหล่งที่มาที่ไม่ได้รับการยืนยัน ข้อมูลที่ป้อนเหล่านี้อาจมีคำสั่งที่ซ่อนอยู่ซึ่งสามารถลักลอบใช้เซสชันของคุณและทำให้ผู้โจมตีแก้ไข ขโมย หรือลบข้อมูลของคุณได้
- ตรวจสอบการดำเนินการทั้งหมด โปรดตรวจสอบการดำเนินการที่แอปพลิเคชัน AI ทำในนามของคุณอย่างรอบคอบเสมอ เพื่อให้แน่ใจว่าการดำเนินการนั้นถูกต้องและตรงกับความตั้งใจของคุณ