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

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

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

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

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

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

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

การตั้งค่าอย่างรวดเร็วสำหรับการใช้งานส่วนตัว

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

  1. เปิดการเริ่มต้นใช้งานโหมดส่วนตัวในคอนโซล Google Cloud ปุ่มนี้จะเลือกไคลเอ็นต์เว็บแอปพลิเคชันไว้ล่วงหน้า ซึ่ง Google Antigravity และ Claude กำหนดให้ต้องใช้

    ตั้งค่าโหมดส่วนตัว

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

  2. ในส่วนเลือกโปรเจ็กต์ ให้เลือกโปรเจ็กต์โหมดส่วนตัวที่มีอยู่ หรือคลิกสร้างโปรเจ็กต์ใหม่ หากได้รับข้อความแจ้ง ให้กรอกแบบฟอร์มการสร้างโปรเจ็กต์ให้เสร็จสมบูรณ์

  3. กำหนดค่ารายละเอียดไคลเอ็นต์ OAuth ดังนี้

    • ป้อนชื่อของไคลเอ็นต์
    • หากประเภทแอปพลิเคชันเป็นเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม URI Callback ของไคลเอ็นต์ MCP ดังนี้
      • สำหรับ Antigravity: https://antigravity.google/oauth-callback
      • สำหรับ Claude: https://claude.ai/api/mcp/auth_callback
    • ตรวจสอบว่าได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI
  4. อ่านนโยบายข้อมูลผู้ใช้บริการ Google API เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้ แล้วคลิกต่อไป

    คอนโซลจะเปิดใช้ Google Workspace API หลักและบริการ MCP ในโปรเจ็กต์ของคุณ และสร้างไคลเอ็นต์ OAuth

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

เปิดใช้ 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

โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว

เซิร์ฟเวอร์ 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 ในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ให้สร้างรหัสไคลเอ็นต์ 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 ในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ให้สร้างรหัสไคลเอ็นต์ 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 Server ของ Universal Search อย่างถูกต้องแล้ว

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

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

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