เซิร์ฟเวอร์ MCP ของ Google Workspace ใน Google Antigravity 2.0, IDE และ/หรือ CLI

1. บทนำ

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

google_workspace_mcp_antigravity_arch_2.png

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

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

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

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

qr_code.png

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

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

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

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Workspace คุณต้องเปิดใช้ Google Workspace API มาตรฐาน

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

จากนั้นเปิดใช้บริการ MCP ของ Google Workspace

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

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

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

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

chat_app.png

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

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

คุณต้องกำหนดค่าหน้าจอขอความยินยอมก่อน

  1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์ คลิกเริ่มต้นใช้งานหากยังไม่ได้กำหนดค่า
  2. กำหนดค่าข้อมูลแอป:
    • ชื่อแอป: Google Workspace MCP Servers
    • อีเมลสนับสนุนสำหรับผู้ใช้: เลือกอีเมลของคุณ
  3. กำหนดค่ากลุ่มเป้าหมาย: เลือกภายใน (หรือภายนอก หากไม่มีตัวเลือกภายใน)
  4. กำหนดค่า Contact Information: ป้อนอีเมลของคุณ
  5. อ่านและยอมรับนโยบายข้อมูลผู้ใช้ แล้วคลิกสร้าง
  6. หากเลือกภายนอก ให้ไปที่กลุ่มเป้าหมาย แล้วเพิ่มอีเมลของคุณในส่วนผู้ใช้ทดสอบ
  7. ไปที่การเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้เพิ่มข้อมูลต่อไปนี้สำหรับเซิร์ฟเวอร์ที่ต้องการใช้
    • ฟรีไซส์: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
    • 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.readonly
    • 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_consent_screen_1.pngoauth_consent_screen_2.pngoauth_consent_screen_3.png

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

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

oauth_client.png

4. กำหนดค่า Antigravity

ตอนนี้เรามากำหนดค่า Antigravity เพื่อใช้ปลายทางเหล่านี้กัน หากคุณยังไม่ได้ติดตั้ง Antigravity 2.0, IDE และ/หรือ CLI ให้ทำตามวิธีการในเว็บไซต์ Antigravity

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

Antigravity 2.0, IDE และ CLI ใช้การกำหนดค่า MCP ส่วนกลางร่วมกันในไฟล์ ~/.gemini/config/mcp_config.json

  1. เปิดไฟล์ในเครื่องมือแก้ไขข้อความที่ต้องการ
  2. แก้ไขการกำหนดค่าเซิร์ฟเวอร์ MCP ที่กำหนดเองต่อไปนี้ ก่อนดำเนินการดังกล่าว ให้แทนที่ตัวยึดตำแหน่ง <YOUR_CLIENT_ID> และ <YOUR_CLIENT_SECRET> ด้วยรหัสไคลเอ็นต์ OAuth และรหัสลับที่คุณสร้างไว้ในขั้นตอนก่อนหน้า
  3. บันทึก
{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.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-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

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

คุณควรเห็นเซิร์ฟเวอร์ MCP ทั้งหมดที่กำหนดค่าไว้ว่าติดตั้งใน Antigravity: gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat และ gws-people คุณต้องตรวจสอบสิทธิ์ของแต่ละช่องสำหรับแพลตฟอร์ม Antigravity แต่ละแพลตฟอร์มเนื่องจากโทเค็น OAuth ไม่ได้รวมศูนย์

Antigravity 2.0

  1. คลิกการตั้งค่าที่ด้านซ้ายล่าง
  2. ไปที่การปรับแต่ง
  3. ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช

unauthed_mcp_servers_20.png

  1. สำหรับเซิร์ฟเวอร์ MCP ที่ติดตั้งแต่ละรายการที่แสดง ให้ทำดังนี้
    1. คลิกตรวจสอบสิทธิ์
    gui_auth.png
    1. ทำตามขั้นตอนการตรวจสอบสิทธิ์ในหน้าต่างเบราว์เซอร์ใหม่ที่เปิดขึ้น
    2. เมื่อเสร็จแล้ว ให้คลิกคัดลอกไปยังคลิปบอร์ด
    copy_auth_code.png
    1. วางรหัสการให้สิทธิ์ที่เพิ่งคัดลอกลงในช่องข้อความที่แสดงในการตั้งค่าของ Antigravity 2.0 แล้วคลิกส่ง
    gui_paste_auth_code.png
    1. ตอนนี้ปุ่มออกจากระบบจะแสดงแทนตรวจสอบสิทธิ์
    gui_sign_out.png

Antigravity IDE

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

open_user_settings_ide.png

  1. ไปที่การปรับแต่ง
  2. ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช

unauthed_mcp_servers_ide.png

  1. สำหรับเซิร์ฟเวอร์ MCP ที่ติดตั้งแต่ละรายการที่แสดง ให้ทำดังนี้
    1. คลิกตรวจสอบสิทธิ์
    gui_auth.png
    1. ทำตามขั้นตอนการตรวจสอบสิทธิ์ในหน้าต่างเบราว์เซอร์ใหม่ที่เปิดขึ้น
    2. เมื่อเสร็จแล้ว ให้คลิกคัดลอกไปยังคลิปบอร์ด
    copy_auth_code.png
    1. วางรหัสการให้สิทธิ์ที่คุณเพิ่งคัดลอกลงในช่องข้อความที่แสดงในการตั้งค่าของ Antigravity IDE แล้วคลิกส่ง
    gui_paste_auth_code.png
    1. ตอนนี้ปุ่มออกจากระบบจะแสดงแทนตรวจสอบสิทธิ์
    gui_sign_out.png

Antigravity CLI

  1. พิมพ์ /mcp แล้วกด enter

unauthed_mcp_servers_cli.png

  1. สำหรับเซิร์ฟเวอร์ MCP แต่ละรายการที่แสดง ให้ทำดังนี้
    1. เลือกโดยใช้ปุ่มลูกศรขึ้นและลง แล้วกด Enter
    2. เลือกตรวจสอบสิทธิ์โดยใช้ปุ่มลูกศรซ้ายและขวา แล้วกด enter
    cli_auth.png
    1. เปิด URL ที่แสดงในหน้าต่างเบราว์เซอร์ใหม่ แล้วทำตามขั้นตอนการตรวจสอบสิทธิ์
    cli_auth_url.png
    1. เมื่อเสร็จแล้ว ให้คลิกคัดลอกไปยังคลิปบอร์ด
    copy_auth_code.png
    1. วางรหัสการให้สิทธิ์ที่คุณเพิ่งคัดลอกลงในช่องข้อความที่แสดงในเทอร์มินัลที่ Antigravity CLI ทำงานอยู่ แล้วกด enter
    cli_paste_auth_code.png
    1. ตอนนี้สถานะตรวจสอบสิทธิ์แล้วจะแสดงแทนต้องตรวจสอบสิทธิ์
    cli_sign_out.png

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

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

ฟรีไซส์

ลองค้นหาในผลิตภัณฑ์ต่างๆ ดังนี้

  • "สรุปสิ่งที่เกิดขึ้นล่าสุดในบัญชี Google Workspace ของฉันเป็นประโยคสั้นๆ"
  • "ค้นหาทุกอย่างที่เกี่ยวข้องกับ [PROJECT_NAME] ในอีเมล เอกสาร และข้อความแชทของฉัน"
  • "การประชุมครั้งถัดไปเกี่ยวกับแผนการตลาดคือเมื่อใด และมีโน้ตและข้อความแชทล่าสุดเกี่ยวกับเรื่องนี้อย่างไรบ้าง"

ide_uni_test.png

Gmail

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

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

Google ไดรฟ์

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

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

Google เอกสาร ชีต และสไลด์

ลองค้นหาแหล่งข้อมูลในไดรฟ์ของคุณ

  • "แสดงเนื้อหาเชิงโครงสร้างของเอกสารใน Google เอกสารชื่อ [DOCS_TITLE] ให้ฉันดูหน่อย"
  • "อ่านชีต Sheet1 จาก Google ชีต [SHEETS_TITLE]"
  • "แสดงเลย์เอาต์ที่อธิบายด้วยคำพูดของงานนำเสนอใน Google สไลด์ [SLIDES_TITLE]"

Google ปฏิทิน

ลองค้นหากำหนดการของคุณโดยใช้คำสั่งต่อไปนี้

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

Google Chat

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

  • "ค้นหาข้อความที่มี '[คีย์เวิร์ด]' ใน '[ชื่อพื้นที่ทำงาน]'"

People API

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

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

การรวมบริการหลายรายการเข้าด้วยกัน

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

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

สำรวจเพิ่มเติม

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

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

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

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

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

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

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

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