Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

เซิร์ฟเวอร์ MCP ของ Universal Search สำหรับ 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 สำหรับการค้นหาทั้งระบบ

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

เปิดใช้ API

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

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

เซิร์ฟเวอร์ MCP ของ Universal Search จะค้นหาใน 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) การค้นหาแบบสากลจะแสดงผลลัพธ์จาก Google ไดรฟ์, Google ปฏิทิน และ Google Chat เท่านั้น แต่จะไม่ค้นหาอีเมลหรือแสดงผลการค้นหาจาก Gmail

ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > การเข้าถึงข้อมูล
คลิกเพิ่มหรือนำขอบเขตออก
เพิ่มขอบเขตต่อไปนี้อย่างน้อย 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
คลิกอัปเดต แล้วคลิกบันทึก

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

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

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

Antigravity

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

สร้างรหัสไคลเอ็นต์ OAuth 2.0 และรหัสลับประเภทเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://antigravity.google/oauth-callback ในช่อง URI เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI โปรดดูวิธีการที่หัวข้อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace
เปิดหรือสร้างไฟล์การกำหนดค่า ~/.gemini/config/mcp_config.json
เพิ่มการกำหนดค่า 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: รหัสลับไคลเอ็นต์ที่คุณสร้าง
ประหยัด mcp_config.json
ตรวจสอบสิทธิ์เซิร์ฟเวอร์ 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
ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้
- สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้าง workspace-universal ในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง
- สำหรับ Antigravity CLI: เปิดแผง /mcp เพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงคำว่า Authed ข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์ workspace-universal ในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มีอยู่

Claude

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

สร้างรหัสไคลเอ็นต์ OAuth 2.0 และรหัสลับประเภทเว็บแอปพลิเคชัน แล้วเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI โปรดดูวิธีการที่หัวข้อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google Workspace
เพิ่มเครื่องมือเชื่อมต่อที่กำหนดเองในการตั้งค่า 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 Server ของ Universal Search อย่างถูกต้องแล้ว

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

เซิร์ฟเวอร์ MCP ของ Universal Search มีเครื่องมือต่อไปนี้

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

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

Cloud Shell

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

กำหนดค่าเซิร์ฟเวอร์ MCP สำหรับการค้นหาทั้งระบบ

เปิดใช้ API

CLI

คอนโซล

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

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

Antigravity

Claude

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

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