กำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace

เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: พร้อมใช้งานเป็นส่วนหนึ่งของโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace ซึ่งให้สิทธิ์ทดลองใช้ฟีเจอร์บางอย่างก่อนเปิดตัว

Google Workspace มีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ Agent AI โต้ตอบกับข้อมูล Google Workspace ได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace จะช่วยให้คุณเปิดใช้แอปพลิเคชัน AI เช่น Google Antigravity และ Claude เพื่อดำเนินการในแอปพลิเคชัน Google Workspace เช่น Gmail, Google ไดรฟ์, Google เอกสาร, Google ชีต, Google สไลด์, Google ปฏิทิน, Google Chat และ Google Classroom ได้ ผลิตภัณฑ์ Google Workspace แต่ละรายการ มีเซิร์ฟเวอร์ MCP เฉพาะของตัวเอง

เซิร์ฟเวอร์ MCP ของ Google Workspace มอบวิธีมาตรฐานสำหรับ AI Agent ในการดำเนินการต่อไปนี้

• อ่านข้อมูล: ค้นหาอีเมล ดึงข้อมูลไฟล์ และแสดงรายการกิจกรรมในปฏิทิน
• ดำเนินการ: สร้างอีเมลฉบับร่าง อัปโหลดไฟล์ และกำหนดเวลาการประชุม
• เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้

ข้อกำหนดเบื้องต้น

• การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace

• โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์

• ไคลเอ็นต์ MCP เช่น Google Antigravity

• หากต้องการเรียกใช้คำสั่งในหน้านี้ ให้ตั้งค่า gcloud CLI ในสภาพแวดล้อมการพัฒนาซอฟต์แวร์ในเครื่องโดยทำตามขั้นตอนต่อไปนี้

  1. ติดตั้ง Google Cloud CLI หากติดตั้ง gcloud CLI ไว้ก่อนหน้านี้ ให้ตรวจสอบว่าคุณมีเวอร์ชันล่าสุดโดยเรียกใช้ gcloud components update
  2. หากใช้ผู้ให้บริการข้อมูลประจำตัว (IdP) ภายนอก ให้ลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวภายนอก ดูข้อมูลเพิ่มเติมได้ที่หัวข้อลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวแบบรวมศูนย์
  3. เริ่มต้น gcloud CLI

• หากกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Classroom ให้ใช้ชั้นเรียนทดสอบของ Google Classroom ที่มีบัญชีนักเรียนทดสอบอย่างน้อย 1 บัญชี หากไม่มีชั้นเรียน Google Classroom ที่ใช้ทดสอบได้ ให้สร้างชั้นเรียนใน UI และเพิ่มนักเรียนทดสอบ

กำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Workspace คุณต้องเปิดใช้เซิร์ฟเวอร์ดังกล่าวในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google แล้วกำหนดค่าไคลเอ็นต์ MCP ให้เชื่อมต่อกับเซิร์ฟเวอร์เหล่านั้น

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Workspace คุณต้องเปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

• Gmail API
• Google Drive API
• Google Docs API
• Google Sheets API
• Google Slides API
• Google Calendar API
• Google Chat API
• People API

• Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud

คอนโซล

เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้ API

เปิดใช้บริการ MCP

หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับผลิตภัณฑ์ Google Workspace แต่ละรายการ คุณต้องเปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ Google Cloud

• Gmail MCP API
• Google Drive MCP API
• Google Docs MCP API
• Google Sheets MCP API
• Google Slides MCP API
• Google Calendar MCP API
• Google Chat MCP API
• People MCP API

• Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud

คอนโซล

เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้บริการ MCP

กำหนดค่าแอปใน Chat

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Chat คุณต้องกำหนดค่าแอป Chat ในโปรเจ็กต์ Google Cloud

1. ในคอนโซล Google Cloud ให้ค้นหา Google Chat API แล้วคลิก Google Chat API > จัดการ > การกำหนดค่า

   ไปที่ Google Chat API

2. ตั้งค่าแอป Chat โดยทำดังนี้

   1. ในช่องชื่อแอป ให้ป้อน Chat MCP
   2. ในช่อง Avatar URL ให้ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png
   3. ในคำอธิบาย ให้ป้อน Chat MCP server
   4. ในส่วนฟังก์ชันการทำงาน ให้ปิดฟีเจอร์แบบอินเทอร์แอกทีฟโดยสลับเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟเป็นปิด
   5. ในส่วนบันทึก ให้เลือกบันทึกข้อผิดพลาดไปยัง Logging

3. คลิกบันทึก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างแอปใน Chat ได้ที่หัวข้อเลือกสถาปัตยกรรมแอปใน Google Chat

ตั้งค่าหน้าจอขอความยินยอม OAuth

เซิร์ฟเวอร์ MCP ของ Google Workspace ใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้

1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์

   ไปที่การสร้างแบรนด์

2. หากกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถกำหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ให้คลิกเริ่มต้นใช้งาน

   1. ในส่วน App Information ให้พิมพ์ Workspace MCP Servers ใน App name
   2. ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลของคุณหรือ Google Group ที่เหมาะสม
   3. คลิกถัดไป
   4. ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือกภายในไม่ได้ ให้เลือกภายนอก
   5. คลิกถัดไป
   6. ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณสามารถรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์ได้
   7. คลิกถัดไป
   8. ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้สำหรับบริการ Google API และหากคุณยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
   9. คลิกต่อไป
   10. คลิกสร้าง
   11. หากเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
       1. คลิกกลุ่มเป้าหมาย
       2. ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
       3. ป้อนอีเมลของคุณและผู้ใช้ทดสอบที่ได้รับอนุญาตคนอื่นๆ แล้วคลิกบันทึก

3. คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

   1. ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับเซิร์ฟเวอร์ MCP ที่ต้องการใช้ ดังนี้

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google ไดรฟ์:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • Google เอกสาร:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • Google ชีต:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • Google สไลด์:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • Google ปฏิทิน:
        • https://www.googleapis.com/auth/calendar.calendarlist.readonly
        • https://www.googleapis.com/auth/calendar.events.freebusy
        • https://www.googleapis.com/auth/calendar.events.readonly
      • Google Chat:
        • https://www.googleapis.com/auth/chat.spaces.readonly
        • https://www.googleapis.com/auth/chat.memberships.readonly
        • https://www.googleapis.com/auth/chat.messages.readonly
        • https://www.googleapis.com/auth/chat.messages.create
        • https://www.googleapis.com/auth/chat.users.readstate
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly

   2. คลิกเพิ่มลงในตาราง

   3. คลิกอัปเดต

   4. หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ให้คลิกบันทึกในหน้าการเข้าถึงข้อมูล

กำหนดค่าไคลเอ็นต์ MCP

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ลงในไคลเอ็นต์ MCP ให้ทำตามวิธีการสำหรับไคลเอ็นต์ของคุณ

Antigravity

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ลงใน Antigravity ให้เพิ่มการกำหนดค่าเซิร์ฟเวอร์ลงในไฟล์ mcp_config.json วิธีการเหล่านี้รองรับ Antigravity 2.0, Antigravity IDE และ Antigravity CLI

1. สร้างรหัสไคลเอ็นต์ OAuth 2.0 และรหัสลับโดยทำดังนี้

   1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

   2. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน

   3. ป้อนชื่อ

   4. ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://antigravity.google/oauth-callback ในช่อง URI

   5. เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI

   6. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

2. เปิดหรือสร้างไฟล์การกำหนดค่า ~/.gemini/config/mcp_config.json

3. เพิ่มการกำหนดค่า mcpServers ลงใน mcp_config.json ดังนี้

   {
     "mcpServers": {
       "gmail": {
         "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "drive": {
         "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "docs": {
         "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "sheets": {
         "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "slides": {
         "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "calendar": {
         "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "chat": {
         "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "people": {
         "serverUrl": "https://people.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "classroom": {
         "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       }
     }
   }
   

   แทนที่ค่าต่อไปนี้

   • OAUTH_CLIENT_ID: รหัสไคลเอ็นต์ที่คุณสร้าง
   • OAUTH_CLIENT_SECRET: รหัสลับไคลเอ็นต์ที่คุณสร้าง

4. ประหยัด mcp_config.json

5. ตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP คุณสามารถตรวจสอบสิทธิ์โดยใช้การตั้งค่า GUI หรือ CLI ก็ได้ ดังนี้

   • สำหรับ Antigravity IDE หรือ GUI (Antigravity 2.0)

     1. เปิดหน้าจอการตั้งค่า (เช่น คลิกการตั้งค่าที่ด้านซ้ายล่าง หรือเปิดการตั้งค่าผู้ใช้ Antigravity)
     2. ไปที่การปรับแต่ง
     3. ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช
     4. สำหรับเซิร์ฟเวอร์แต่ละรายการที่แสดง (gmail, drive, docs, sheets, slides, calendar, chat, people และ classroom) ให้คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง

   • สำหรับ Antigravity CLI

     1. เริ่ม Antigravity CLI:

        agy
        

     2. เปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้

        /mcp
        

     3. ตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP แต่ละรายการโดยทำดังนี้

        1. ใช้ปุ่มลูกศรเพื่อเลือกเซิร์ฟเวอร์ ย้ายไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter
        2. ทำขั้นตอนเหล่านี้ซ้ำกับเซิร์ฟเวอร์แต่ละรายการที่คุณกำหนดค่า (gmail, drive, docs, sheets, slides, calendar, chat, people และ classroom)

6. ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้

   • สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้างเซิร์ฟเวอร์แต่ละรายการในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง
   • สำหรับ Antigravity CLI: เปิดแผง /mcp เพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงคำว่า Authed ข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์ใดก็ได้ในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มี

เซิร์ฟเวอร์ MCP ระยะไกลพร้อมใช้งานใน Antigravity แล้ว

Claude

หากต้องการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace กับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ไปยัง Claude ให้กำหนดค่าเครื่องมือเชื่อมต่อที่กำหนดเองด้วยรหัสไคลเอ็นต์ OAuth และรหัสลับ

1. สร้างรหัสไคลเอ็นต์ OAuth 2.0 และรหัสลับโดยทำดังนี้

   1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

   2. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน

   3. ป้อนชื่อ

   4. ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://claude.ai/api/mcp/auth_callback ในช่อง URI

   5. เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI

   6. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

2. กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้

   1. ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า (หรือการตั้งค่าผู้ดูแลระบบ) > เครื่องมือเชื่อมต่อ
   2. คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง

   3. ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ Google Workspace ที่ต้องการเพิ่ม ดังนี้

      • ชื่อเซิร์ฟเวอร์: ชื่อเซิร์ฟเวอร์ เช่น Gmail
      • URL ของเซิร์ฟเวอร์ MCP ระยะไกล: URL ของผลิตภัณฑ์ Google Workspace เช่น รายการใดรายการหนึ่งต่อไปนี้
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google ไดรฟ์: https://drivemcp.googleapis.com/mcp/v1
        • Google เอกสาร: https://docsmcp.googleapis.com/mcp/v1
        • Google ชีต: https://sheetsmcp.googleapis.com/mcp/v1
        • Google สไลด์: https://slidesmcp.googleapis.com/mcp/v1
        • Google ปฏิทิน: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

   4. ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth

   5. คลิกเพิ่ม

   6. ทำขั้นตอนเหล่านี้ซ้ำสำหรับผลิตภัณฑ์ Google Workspace แต่ละรายการที่ต้องการเพิ่ม

อื่นๆ

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

• ชื่อเซิร์ฟเวอร์: googleworkspace

• เซิร์ฟเวอร์: ผลิตภัณฑ์ Google Workspace แต่ละรายการมี URL ของเซิร์ฟเวอร์ของตนเอง ดังนี้

  • Gmail: https://gmailmcp.googleapis.com/mcp/v1
  • Google ไดรฟ์: https://drivemcp.googleapis.com/mcp/v1
  • Google เอกสาร: https://docsmcp.googleapis.com/mcp/v1
  • Google ชีต: https://sheetsmcp.googleapis.com/mcp/v1
  • Google สไลด์: https://slidesmcp.googleapis.com/mcp/v1
  • Google ปฏิทิน: https://calendarmcp.googleapis.com/mcp/v1
  • Google Chat: https://chatmcp.googleapis.com/mcp/v1
  • People API: https://people.googleapis.com/mcp/v1
  • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

• การส่งข้อมูล: HTTP ที่สตรีมได้

• การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

  ไคลเอ็นต์ MCP ต้องใช้โทเค็นการรีเฟรชเพื่อป้องกันไม่ให้ผู้ใช้ต้องลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเมื่อคำขอการให้สิทธิ์มี access_type=offline เท่านั้น การขอเฉพาะขอบเขต offline_access ของ OpenID Connect (OIDC) จะไม่แสดงผลลัพธ์ใดๆ หากไคลเอ็นต์ MCP รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง ให้เพิ่ม access_type=offline ลงในคำขอการให้สิทธิ์ หากต้องการรับโทเค็นการรีเฟรชใหม่สำหรับผู้ใช้ที่ให้สิทธิ์เข้าถึงแล้ว ให้เพิ่ม prompt=consent ด้วย หากไคลเอ็นต์ MCP ไม่รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง ผู้ใช้จะต้องลงชื่อเข้าใช้อีกครั้งทุกครั้งที่โทเค็นเพื่อการเข้าถึงหมดอายุ โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อไคลเอ็นต์ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI

ทดสอบเซิร์ฟเวอร์ MCP ของ Google Workspace

หลังจากกำหนดค่าไคลเอ็นต์ MCP แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ

ลองถามคำถามต่อไปนี้กับไคลเอ็นต์ MCP ของคุณ

• "Ariel พูดว่าอะไรในอีเมลฉบับล่าสุดเกี่ยวกับแผนการตลาดของเรา"

  ไคลเอ็นต์จะกรองอีเมลจาก Ariel โดยใช้ gmail.search_threads, ดึงเนื้อหาของชุดข้อความล่าสุดด้วย gmail.get_thread แล้วสรุปให้คุณ

• "ร่างอีเมลถึง [e-mail] เพื่อแจ้งว่าฉันอนุมัติแผนการตลาด"

  ไคลเอ็นต์จะใช้ gmail.create_draft เพื่อสร้างอีเมลในโฟลเดอร์ฉบับร่าง ซึ่งช่วยให้คุณตรวจสอบและส่งอีเมลจาก Gmail ได้

• "สรุปไฟล์แผนการตลาด"

  ไคลเอ็นต์จะเรียกใช้ drive.search_files เพื่อค้นหา "แผนการตลาด" จากนั้นใช้ drive.read_file_content เพื่อดึงข้อมูลและสรุปเนื้อหา

• "แสดงเนื้อหาเชิงโครงสร้างของบันทึกการประชุมใน Google เอกสาร"

  ไคลเอ็นต์จะดึงข้อมูลโครงสร้างและเนื้อหาของเอกสารโดยใช้ docs.read_doc

• "อ่านชีต Sheet1 จาก Google ชีตยอดขายรายไตรมาส"

  ไคลเอ็นต์จะดึงค่าตารางกริดโดยใช้ sheets.get_values

• "แสดงเลย์เอาต์ที่อธิบายด้วยคำพูดของงานนำเสนอใน Google สไลด์ชื่อภาพรวมผลิตภัณฑ์"

  ไคลเอ็นต์จะดึงโครงสร้างเลย์เอาต์ภาพของงานนำเสนอโดยใช้ slides.read_presentation

• "ฉันจะประชุมกับ Ariel ครั้งถัดไปเมื่อไร"

  ลูกค้าตรวจสอบกำหนดการของคุณโดยใช้ calendar.list_events และให้รายละเอียดการประชุมครั้งถัดไปกับ Ariel

• "ฉันชื่ออะไรตามโปรไฟล์ Google"

  ไคลเอ็นต์จะใช้ people.get_user_profile เพื่อดึงข้อมูลโปรไฟล์ Google Workspace ของคุณ

• "ตอนนี้ฉันสอนชั้นเรียนอะไรอยู่"

  ไคลเอ็นต์จะตรวจสอบกำหนดการของคุณโดยใช้ classroom.list_course_summaries และสรุปหลักสูตรที่ใช้งานอยู่ซึ่งคุณมีบทบาทเป็นครู

• "ร่างประกาศเกี่ยวกับการทัศนศึกษาที่กำลังจะมาถึงสำหรับชั้นเรียนธรณีวิทยาของฉัน"

  ไคลเอ็นต์จะใช้ classroom.create_announcement เพื่อร่างประกาศ ซึ่งคุณสามารถตรวจสอบและโพสต์ในแอป Google Classroom ได้

หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ MCP ของ Google Workspace ได้รับการกำหนดค่าอย่างถูกต้อง

การแก้ปัญหา

หากพบปัญหาในการเชื่อมต่อกับเซิร์ฟเวอร์ MCP คุณสามารถตรวจสอบข้อผิดพลาดในบันทึก OAuth ได้ ขอให้ผู้ดูแลระบบตรวจสอบเหตุการณ์ในบันทึกของ OAuth ในเครื่องมือตรวจสอบความปลอดภัย

หากคำขอไปยังเซิร์ฟเวอร์ MCP ถูกปฏิเสธ ให้ตรวจสอบว่าไคลเอ็นต์ OAuth 2.0 ของคุณได้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ หากเปลี่ยนการตั้งค่านี้ในไคลเอ็นต์ OAuth ที่มีอยู่ไม่ได้ ให้สร้างไคลเอ็นต์ OAuth ใหม่โดยเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI แล้วอัปเดตแอปเพื่อใช้ไคลเอ็นต์ดังกล่าว หากใช้ไคลเอ็นต์ OAuth ที่มีอยู่สำหรับทั้งฟีเจอร์ AI Agent และฟีเจอร์ที่ไม่ใช่ Agent ให้สร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับ AI Agent และเก็บไคลเอ็นต์ที่มีอยู่ไว้สำหรับฟีเจอร์ที่ไม่ใช่ Agent ดูวิธีการได้ที่หัวข้อกำหนดค่าไคลเอ็นต์ MCP และจัดการไคลเอ็นต์ OAuth

หากแอปใช้บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน คุณจะไม่สามารถเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI เนื่องจากระบบไม่ได้จัดการบัญชีบริการในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ คำขอไปยังเซิร์ฟเวอร์ MCP จากบัญชีบริการที่ใช้การมอบสิทธิ์ทั่วทั้งโดเมนจะไม่ถูกปฏิเสธด้วยเหตุผลนี้ การเข้าถึงจะควบคุมโดยการตั้งค่าการมอบสิทธิ์ทั่วทั้งโดเมนที่ผู้ดูแลระบบ Google Workspace เป็นผู้จัดการ ดูรายละเอียดได้ที่หัวข้อควบคุมการเข้าถึง API ด้วยการมอบสิทธิ์ทั่วทั้งโดเมน

หากคุณเรียกใช้เซิร์ฟเวอร์ MCP จาก Google Apps Script, Apps Script จะสร้างและจัดการไคลเอ็นต์ OAuth เริ่มต้นสำหรับสคริปต์ของคุณ แต่คุณจะเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ไม่ได้ ซึ่งจะมีผลแม้ว่าสคริปต์จะใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google Cloud มาตรฐานก็ตาม แต่ให้ทำดังนี้แทน

1. ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ สร้างไคลเอ็นต์ OAuth แล้วเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
2. ในสคริปต์ ให้ใช้ไลบรารี OAuth2 สำหรับ Apps Script เพื่อให้สิทธิ์ผู้ใช้ด้วยไคลเอ็นต์ OAuth นั้น
3. เมื่อเรียกใช้เซิร์ฟเวอร์ MCP ให้ส่งโทเค็นเพื่อการเข้าถึงที่ไลบรารีแสดงผลแทนโทเค็นจาก ScriptApp.getOAuthToken

โปรเจ็กต์ Apps Script ที่ไม่ได้เรียกใช้เซิร์ฟเวอร์ MCP จะไม่ได้รับผลกระทบ

หากระบบแจ้งให้คุณลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง แสดงว่าไคลเอ็นต์ MCP ไม่ได้รับโทเค็นการรีเฟรช เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเฉพาะเมื่อคำขอการให้สิทธิ์มี access_type=offline การขอเฉพาะขอบเขต offline_access ของ OpenID Connect (OIDC) จะไม่แสดงผล หากไคลเอ็นต์ MCP ของคุณรองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง ให้เพิ่ม access_type=offline ลงในคำขอให้สิทธิ์ หากต้องการรับโทเค็นการรีเฟรชใหม่สำหรับผู้ใช้ที่ให้สิทธิ์เข้าถึงแล้ว ให้เพิ่ม prompt=consent ด้วย หากไคลเอ็นต์ MCP ไม่รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง คุณต้องลงชื่อเข้าใช้อีกครั้งทุกครั้งที่โทเค็นเพื่อการเข้าถึงหมดอายุ โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง

ผลิตภัณฑ์ที่รองรับ

ผลิตภัณฑ์ Google Workspace ต่อไปนี้รองรับเซิร์ฟเวอร์ MCP ของ Google Workspace และมีเครื่องมือต่อไปนี้

• Gmail
  • create_draft
  • get_message
  • get_thread
  • label_message
  • label_thread
  • list_drafts
  • list_labels
  • search_threads
  • unlabel_message
  • unlabel_thread
• Google ไดรฟ์
  • copy_file
  • create_file
  • download_file_content
  • get_file_metadata
  • get_file_permissions
  • list_recent_files
  • read_file_content
  • search_files
• Google เอกสาร
  • read_doc
  • update_doc
• Google ชีต
  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension
• Google สไลด์
  • read_presentation
  • update_presentation
• Google ปฏิทิน
  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • search_events
  • suggest_time
  • update_event
• Google Chat
  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
• People API
  • get_user_profile
  • search_contacts
  • search_directory_people
• Google Classroom
  • create_announcement
  • create_course_work
  • create_course_work_rubric
  • create_topic
  • get_announcements
  • get_course_roster
  • get_course_work
  • get_course_work_rubric
  • get_courses
  • get_guardian_info
  • list_announcement_summaries
  • list_course_summaries
  • list_course_work_submissions
  • list_course_work_summaries
  • list_topics
  • update_course_work

ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม

เมื่อคุณแสดงโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ อาจมีความเสี่ยงที่จะเกิดการโจมตีแบบแทรกพรอมต์โดยอ้อม เนื่องจากไคลเอ็นต์ MCP เช่น Google Antigravity มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ MCP ของ Google Workspace ไคลเอ็นต์จึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ของคุณได้

โปรดทำตามแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อลดความเสี่ยงเหล่านี้

• ใช้เฉพาะเครื่องมือที่เชื่อถือได้ อย่าเชื่อมต่อเซิร์ฟเวอร์ MCP ของ Google Workspace กับแอปพลิเคชันที่ไม่น่าเชื่อถือหรือไม่ได้รับการยืนยัน
• โปรดระมัดระวังอินพุตที่ไม่น่าเชื่อถือ หลีกเลี่ยงการขอให้ไคลเอ็นต์ MCP ประมวลผลอีเมล เอกสาร หรือแหล่งข้อมูลอื่นๆ จากแหล่งที่มาที่ไม่ได้รับการยืนยัน ข้อมูลเหล่านี้อาจมีคำสั่งที่ซ่อนอยู่ซึ่งสามารถลักลอบใช้เซสชันของคุณ ซึ่งช่วยให้ผู้โจมตีแก้ไข ขโมย หรือลบข้อมูลของคุณได้
• ตรวจสอบการดำเนินการทั้งหมด โปรดตรวจสอบการดำเนินการที่ไคลเอ็นต์ AI ทำในนามของคุณอย่างละเอียดทุกครั้งเพื่อให้แน่ใจว่าถูกต้องและสอดคล้องกับความตั้งใจของคุณ

หัวข้อที่เกี่ยวข้อง

• เซิร์ฟเวอร์ MCP ของ Google Workspace ใน Antigravity (Codelab)
• สร้าง AI Agent ของ Google Workspace ด้วย ADK และ MCP
• เครื่องมือเชื่อมต่อเซิร์ฟเวอร์ MCP ของ Google Workspace ในแอป Gemini Enterprise