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

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

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

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

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

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

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

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

  Cloud Shell

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

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

  Local Shell

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

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

กำหนดค่า Universal Search MCP Server

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

เปิดใช้ API

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

• Gmail API
• Google Drive API
• Google ปฏิทิน API
• Google Chat API

• Google Workspace MCP API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

คอนโซล

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

เปิดใช้ API

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

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

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

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

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

• 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

Universal Search MCP Server จะค้นหาใน Gmail, Google ไดรฟ์, Google ปฏิทิน และ Google Chat

อย่างไรก็ตาม หากคุณให้สิทธิ์เข้าถึงเฉพาะ 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/gmail.readonly) Universal Search จะแสดงผลลัพธ์จาก 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

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

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

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

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

Antigravity

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

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

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

หากต้องการเพิ่ม Universal Search MCP Server ลงใน Claude ให้กำหนดค่าตัวเชื่อมต่อที่กำหนดเองโดยทำดังนี้

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

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

ทดสอบ Universal Search MCP Server

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

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

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

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

Universal Search MCP Server มีเครื่องมือต่อไปนี้

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