เซิร์ฟเวอร์ MCP ของ Google Workspace ใน Antigravity

1. บทนำ

หมายเหตุ: หากใช้ Gemini CLI โปรดไปที่ Codelab นี้ แทน คู่มือนี้ใช้สำหรับ Antigravity โดยเฉพาะ

ใน Codelab นี้ คุณจะได้เรียนรู้วิธีใช้ Model Context Protocol (MCP) เพื่อเชื่อมต่อ Antigravity กับข้อมูล Google Workspace MCP เป็นมาตรฐานแบบเปิดที่ช่วยให้โมเดล AI ใช้เครื่องมือที่เซิร์ฟเวอร์ระยะไกลจัดหาให้ได้อย่างปลอดภัย คุณจะได้ตั้งค่า Antigravity ให้โต้ตอบกับ Gmail, Google ไดรฟ์, Google ปฏิทิน, Google Chat และ People API โดยไม่ต้องเขียนโค้ด

สิ่งที่คุณจะได้ทำ

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

สิ่งที่คุณต้องมี

• เว็บเบราว์เซอร์ เช่น Chrome
• โปรเจ็กต์ Google Cloud
• บัญชี Google Workspace
• Antigravity ที่ติดตั้งในเครื่องภายใน

เข้าถึง Codelab นี้ได้ง่ายๆ

2. ก่อนเริ่มต้น

โปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace: การเข้าถึงเซิร์ฟเวอร์ Google Workspace MCP เป็นส่วนหนึ่งของโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์แบบสาธารณะ หากยังไม่ได้ลงชื่อสมัครใช้ โปรดลงชื่อสมัครใช้และตรวจสอบว่าบัญชีของคุณได้รับการยอมรับเข้าร่วมโปรแกรมที่ https://developers.google.com/workspace/preview

สร้างหรือเลือกโปรเจ็กต์ Google Cloud

ใน คอนโซล Google Cloud ให้เลือกหรือสร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ Google Workspace MCP คุณต้องเปิดใช้ Google Workspace API มาตรฐาน แม้ว่าเซิร์ฟเวอร์ MCP บางรายการจะทำงานแยกกัน แต่เซิร์ฟเวอร์อื่นๆ ยังคงกำหนดให้ต้องเปิดใช้ API มาตรฐานพื้นฐาน

• Gmail และ Chat ยังคงต้องใช้ API มาตรฐาน
• ไดรฟ์ ต้องใช้ API มาตรฐานสำหรับเครื่องมือบางอย่าง
• ปฏิทิน ไม่กำหนดให้ต้องเปิดใช้ API มาตรฐาน
• People API จัดการทั้งสิทธิ์การเข้าถึงระดับมาตรฐานและฟังก์ชันการทำงานของ MCP จึงไม่มีบริการ MCP แยกต่างหากให้เปิดใช้

เปิดใช้ API

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

จากนั้นเปิดใช้บริการ MCP เฉพาะสำหรับผลิตภัณฑ์

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

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

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

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

ไปที่ Google Chat API

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

3. กำหนดค่าคำยินยอมและไคลเอ็นต์ OAuth

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

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

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

1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์ คลิกเริ่มต้นใช้งาน หากยังไม่ได้กำหนดค่า
2. กำหนดค่าข้อมูลแอป:
   • ชื่อแอป: Google Workspace MCP Servers
   • อีเมลสนับสนุนสำหรับผู้ใช้: เลือกอีเมลของคุณ
3. กำหนดค่ากลุ่มเป้าหมาย: เลือกภายใน (หรือภายนอก หากไม่มีตัวเลือกภายใน)
4. กำหนดค่าข้อมูลติดต่อ: ป้อนอีเมลของคุณ
5. อ่านและยอมรับนโยบายข้อมูลผู้ใช้ แล้วคลิกสร้าง
6. หากเลือกภายนอก ให้ไปที่กลุ่มเป้าหมาย แล้วเพิ่มอีเมลในส่วนผู้ใช้ทดสอบ
7. ไปที่การเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้เพิ่มขอบเขตต่อไปนี้สำหรับเซิร์ฟเวอร์ที่ต้องการใช้
   • 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.users.readstate.readonly
   • Google ไดรฟ์: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • People API: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. คลิกเพิ่มลงในตาราง แล้วคลิกอัปเดต และสุดท้ายคลิกบันทึก

สร้างรหัสไคลเอ็นต์ OAuth

1. ไปที่ Google Auth Platform > ไคลเอ็นต์ > สร้างไคลเอ็นต์
2. เลือกเว็บแอปพลิเคชัน เป็นประเภทแอปพลิเคชัน
3. ตั้งชื่อเป็น Antigravity
4. ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วป้อน https://antigravity.google/oauth-callback
5. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์ และรหัสลับไคลเอ็นต์ คุณจะต้องใช้ข้อมูลเหล่านี้ในขั้นตอนถัดไป

4. กำหนดค่า Antigravity

ตอนนี้มากำหนดค่า Antigravity ให้ใช้ปลายทางเหล่านี้กัน หากยังไม่ได้ติดตั้ง Antigravity ให้ทำตามวิธีการติดตั้งใน เว็บไซต์ Antigravity

เพิ่มเซิร์ฟเวอร์ MCP ที่กำหนดเอง

1. เปิดเซิร์ฟเวอร์ MCP ผ่านเมนูแบบเลื่อนลง ... ที่ด้านบนของแผง Agent ของ Editor

2. คลิกจัดการเซิร์ฟเวอร์ MCP แล้วคลิกดูการกำหนดค่าแบบดิบ

4. แก้ไขไฟล์ mcp_config.json ที่เพิ่งเปิดด้วยการกำหนดค่าเซิร์ฟเวอร์ MCP ที่กำหนดเองต่อไปนี้ ก่อนดำเนินการ ให้แทนที่ตัวยึดตำแหน่ง <YOUR_CLIENT_ID> และ <YOUR_CLIENT_SECRET> ด้วยรหัสไคลเอ็นต์ OAuth และรหัสลับที่คุณสร้างขึ้นในขั้นตอนก่อนหน้า

{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

5. กลับไปที่จัดการเซิร์ฟเวอร์ MCP แล้วคลิกรีเฟรช

ตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP ที่กำหนดเอง

1. เปิดการตั้งค่าผู้ใช้ Antigravity ผ่านเมนูแบบเลื่อนลงการตั้งค่าเฉพาะ Editor ที่ด้านบนของหน้าต่าง

2. ไปที่การปรับแต่ง

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

2. ทำตามขั้นตอนการตรวจสอบสิทธิ์ในหน้าต่างเบราว์เซอร์ใหม่ที่เปิดขึ้น
3. เมื่อเสร็จแล้ว ให้คลิกคัดลอกไปยังคลิปบอร์ด

4. ปิดหน้าต่างเบราว์เซอร์
5. วางรหัสการให้สิทธิ์ที่คุณเพิ่งคัดลอกลงในช่องข้อความที่แสดงในการตั้งค่าของ Antigravity
6. คลิกส่ง

5. เครื่องมือทดสอบ

ตอนนี้คุณโต้ตอบกับข้อมูล Google Workspace ได้แล้วโดยใช้ภาษาธรรมชาติ ต่อไปนี้คือตัวอย่างพรอมต์สำหรับแต่ละบริการ

หมายเหตุ: แทนที่ตัวยึดตำแหน่งในวงเล็บในพรอมต์ด้านล่าง (เช่น [NAME], [FILE_NAME]) ด้วยค่าจริงจากข้อมูล Google Workspace ของคุณเอง

Google ปฏิทิน

ลองค้นหาตารางเวลาโดยทำดังนี้

• "ฉันมีนัดหมายอะไรบ้างในสัปดาห์นี้"
• "ฉันมีเวลาว่างในบ่ายวันพรุ่งนี้ไหม"

Google Chat

ลองค้นหาข้อความโดยทำดังนี้

• "ค้นหาข้อความที่มี ‘[KEYWORD]' ใน ‘[SPACE_NAME]'"

Google ไดรฟ์

ลองค้นหาหรืออ่านไฟล์โดยทำดังนี้

• "ค้นหาไฟล์ใน Google ไดรฟ์ที่มี ‘[KEYWORD]'"
• "แสดงรายการเอกสารล่าสุดที่ฉันแก้ไข"
• "อ่านเนื้อหาของเอกสาร '[FILE_NAME]' และสรุปเป้าหมายหลัก"

Gmail

ลองค้นหาหรือจัดการอีเมลโดยทำดังนี้

• "สรุปอีเมล 5 ฉบับล่าสุดที่ฉันได้รับ"
• "ร่างอีเมลถึง '[EMAIL_ADDRESS]' เพื่อขอข้อมูลอัปเดตเกี่ยวกับโปรเจ็กต์ '[PROJECT_NAME]'"

People API

ลองค้นหาโปรไฟล์หรือรายชื่อติดต่อโดยทำดังนี้

• "ชื่อของฉันคืออะไรตามโปรไฟล์ Google"
• "ค้นหาข้อมูลติดต่อของ '[NAME]'"

การรวมบริการหลายรายการ

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

• "ค้นหาไฟล์ในไดรฟ์ที่เกี่ยวข้องกับ 'ข้อมูลอัปเดตเหตุการณ์สำคัญของ [PROJECT_NAME]' สรุปเนื้อหา ค้นหาอีเมลของ '[NAME]' และสร้างฉบับร่างอีเมลใน Gmail ถึงบุคคลดังกล่าวพร้อมสรุป"

สำรวจเครื่องมือเพิ่มเติม

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

6. ล้างข้อมูล

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

1. ในคอนโซล Google Cloud ให้ไปที่แดชบอร์ด API และบริการ
2. คลิก API ของ Google Workspace และ MCP แต่ละรายการที่คุณเปิดใช้ (เช่น Calendar MCP, Chat MCP) แล้วคลิกปิดใช้ API

ลบข้อมูลเข้าสู่ระบบไคลเอ็นต์ OAuth ในคอนโซล Google Auth Platform หากคุณไม่ต้องการใช้ข้อมูลดังกล่าวอีกต่อไป

7. ขอแสดงความยินดี

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

เอกสารอ้างอิง

• ข้อมูลเบื้องต้นเกี่ยวกับ Model Context Protocol (MCP)
• กำหนดค่าเซิร์ฟเวอร์ Google Workspace MCP
• กำหนดค่าคำยินยอม OAuth
• Editor ของ Antigravity: การผสานรวม MCP