อนุญาตให้ Agent AI ค้นหาใน Workspace ด้วยเซิร์ฟเวอร์ MCP การค้นหาสากลสำหรับ Workspace

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

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

เซิร์ฟเวอร์ MCP ของ Universal Search มีวิธีมาตรฐานสำหรับ AI Agent ในการค้นหาข้อมูลในบัญชี Google Workspace ทั้งหมดของคุณโดยไม่ต้องเรียกใช้เครื่องมือเฉพาะผลิตภัณฑ์แต่ละรายการ

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

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

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

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

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

  Cloud Shell

  หากต้องการใช้เทอร์มินัลออนไลน์ที่มีการตั้งค่า gcloud CLI ไว้แล้ว ให้เปิดใช้งาน Cloud Shell โดยทำดังนี้

  เปิดใช้งาน Cloud Shell

  เชลล์ในเครื่อง

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

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

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

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

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Universal Search ให้เปิดใช้ Google Workspace MCP API ในโปรเจ็กต์ Google Cloud โดยทำดังนี้

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

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

คอนโซล

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

เปิดใช้ API

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

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

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

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

ตัวอย่างเช่น หากคุณตรวจสอบสิทธิ์ด้วยขอบเขตต่อไปนี้ทั้งหมด

• 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
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly

เซิร์ฟเวอร์ MCP ของ Universal Search จะค้นหาใน Gmail, Google ไดรฟ์, Google ปฏิทิน และ Google Chat

อย่างไรก็ตาม หากคุณละเว้น 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, https://www.googleapis.com/auth/chat.spaces.readonly และ https://www.googleapis.com/auth/chat.memberships.readonly การค้นหาแบบสากลจะแสดงผลการค้นหาจาก Google ไดรฟ์, Google ปฏิทิน และ Google Chat เท่านั้น แต่จะไม่ค้นหาอีเมลหรือแสดงผลลัพธ์จาก Gmail

1. ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > การเข้าถึงข้อมูล
2. คลิกเพิ่มหรือนำขอบเขตออก

3. เพิ่มขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

   • 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
   • https://www.googleapis.com/auth/chat.spaces.readonly
   • https://www.googleapis.com/auth/chat.memberships.readonly

   ใส่ https://www.googleapis.com/auth/chat.spaces.readonly และ https://www.googleapis.com/auth/chat.memberships.readonly เพื่อให้เซิร์ฟเวอร์บอกได้ว่าใครอยู่ในการสนทนา Google Chat แต่ละรายการ หากไม่มี ผลลัพธ์ของ Google Chat จะถือว่าเป็นการแชร์ภายนอกและอาจต้องมีการยืนยันจากผู้ใช้หรือถูกกรองออก

4. คลิกอัปเดต แล้วคลิกบันทึก

โปรดดูวิธีการโดยละเอียดเกี่ยวกับการตั้งค่าหน้าจอขอความยินยอมที่หัวข้อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace

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

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

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

Antigravity

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

1. สร้างรหัสไคลเอ็นต์ OAuth 2.0 และรหัสลับประเภทเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://antigravity.google/oauth-callback ในช่อง URI เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI โปรดดูวิธีการที่หัวข้อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace

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

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

   {
     "mcpServers": {
       "workspace-universal": {
         "serverUrl": "https://workspacemcp.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. ค้นหา workspace-universal ในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง

   • สำหรับ Antigravity CLI

     1. เริ่ม Antigravity CLI:

        agy
        

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

        /mcp
        

     3. ใช้ปุ่มลูกศรเพื่อเลือก workspace-universal จากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter

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

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

Claude

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ของ Universal Search ลงใน Claude ให้กำหนดค่าเครื่องมือเชื่อมต่อที่กำหนดเอง

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

2. เพิ่มเครื่องมือเชื่อมต่อที่กำหนดเองในการตั้งค่า Claude โดยทำดังนี้

   • ชื่อเซิร์ฟเวอร์: Universal Search MCP Server
   • URL ของเซิร์ฟเวอร์ MCP ระยะไกล: https://workspacemcp.googleapis.com/mcp/v1
   • รหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth: ป้อนข้อมูลเข้าสู่ระบบ
   • ขอบเขต: รวม 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, https://www.googleapis.com/auth/chat.spaces.readonly และ https://www.googleapis.com/auth/chat.memberships.readonly

ทดสอบเซิร์ฟเวอร์ MCP ของ Universal Search

ลองถามคำถามกับไคลเอ็นต์ MCP ที่ต้องค้นหาในผลิตภัณฑ์ต่างๆ ดังนี้

• "ค้นหาทุกอย่างที่เกี่ยวข้องกับโปรเจ็กต์ X ในอีเมล เอกสาร และข้อความแชท"
• "การประชุมครั้งถัดไปเกี่ยวกับแผนการตลาดคือเมื่อใด และมีโน้ตและข้อความแชทล่าสุดเกี่ยวกับเรื่องนี้อย่างไรบ้าง"

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

เครื่องมือที่รองรับ

เซิร์ฟเวอร์ MCP ของ Universal Search มีเครื่องมือต่อไปนี้ ดูสคีมาอินพุตและเอาต์พุตได้ที่ข้อมูลอ้างอิง MCP ของ Universal Search

• search_corpus: ค้นหาในผลิตภัณฑ์ Google Workspace หลายรายการ ซึ่งรวมถึงไดรฟ์, Gmail, ปฏิทิน และ Chat โดยอิงตามคำค้นหาที่ระบุ