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

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

เซิร์ฟเวอร์ MCP ของการค้นหาสากลมีวิธีที่ได้มาตรฐานสำหรับ AI Agent ในการ ค้นหาข้อมูลในบัญชี 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 ของการค้นหาทั้งระบบ

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

เปิดใช้ API

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

  • Gmail API
  • Google Drive API
  • Google Calendar 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

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

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

เมื่อตรวจสอบสิทธิ์ด้วยเซิร์ฟเวอร์ 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

เซิร์ฟเวอร์ MCP ของการค้นหาสากลจะค้นหาใน 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. คลิกอัปเดต แล้วคลิกบันทึก

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

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

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

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 โปรดดูวิธีการในกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace

  2. เปิดหรือสร้างไฟล์การกำหนดค่า ~/.gemini/antigravity/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 ประเภทเว็บแอปพลิเคชัน โปรดดูวิธีการในกำหนดค่าเซิร์ฟเวอร์ 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

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

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

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

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

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

เซิร์ฟเวอร์ MCP ของการค้นหาสากลมีเครื่องมือต่อไปนี้

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