เซิร์ฟเวอร์ 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 ทั้งหมดของคุณโดยไม่ต้องเรียกใช้เครื่องมือเฉพาะผลิตภัณฑ์แต่ละรายการ
ข้อกำหนดเบื้องต้น
การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace
โปรเจ็กต์ Google Cloud คุณสามารถสร้างหรือเลือกโปรเจ็กต์ได้ในระหว่างการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว หรือดูหัวข้อสร้างโปรเจ็กต์
ไคลเอ็นต์ MCP เช่น Google Antigravity
หากต้องการเรียกใช้คำสั่ง
gcloudสำหรับการตั้งค่าด้วยตนเองในหน้านี้ ให้ตั้งค่า gcloud CLI ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์อย่างใดอย่างหนึ่งต่อไปนี้Cloud Shell
หากต้องการใช้เทอร์มินัลออนไลน์ที่มีการตั้งค่า gcloud CLI ไว้แล้ว ให้เปิดใช้งาน Cloud Shell โดยทำดังนี้
เชลล์ในเครื่อง
หากต้องการใช้สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง ให้ทำตามขั้นตอนต่อไปนี้
- ติดตั้ง Google Cloud CLI
หากติดตั้ง gcloud CLI ไว้ก่อนหน้านี้ ให้ตรวจสอบว่าคุณมีเวอร์ชันล่าสุดโดยเรียกใช้
gcloud components update - หากคุณใช้ผู้ให้บริการข้อมูลประจำตัว (IdP) ภายนอก ให้ลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวภายนอก ดูข้อมูลเพิ่มเติมได้ที่หัวข้อลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวแบบรวม
- เริ่มต้น gcloud CLI
- ติดตั้ง Google Cloud CLI
หากติดตั้ง gcloud CLI ไว้ก่อนหน้านี้ ให้ตรวจสอบว่าคุณมีเวอร์ชันล่าสุดโดยเรียกใช้
กำหนดค่าเซิร์ฟเวอร์ 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 แยกต่างหาก โดยทำดังนี้
เปิดการเริ่มต้นใช้งานโหมดส่วนตัวในคอนโซล Google Cloud ปุ่มนี้จะเลือกไคลเอ็นต์เว็บแอปพลิเคชันไว้ล่วงหน้า ซึ่ง Google Antigravity และ Claude กำหนดให้ต้องใช้
หากไคลเอ็นต์ MCP ใช้ขั้นตอน OAuth บนเดสก์ท็อปหรืออุปกรณ์เคลื่อนที่แทน URI การเปลี่ยนเส้นทางเว็บ ให้เปิดการตั้งค่าโหมดส่วนตัวสำหรับไคลเอ็นต์แอปบนเดสก์ท็อป, Android หรือ iOS หรือเปลี่ยนประเภทแอปพลิเคชันในหน้าเว็บ
ในส่วนเลือกโปรเจ็กต์ ให้เลือกโปรเจ็กต์โหมดส่วนตัวที่มีอยู่ หรือคลิกสร้างโปรเจ็กต์ใหม่ หากได้รับข้อความแจ้ง ให้กรอกแบบฟอร์มการสร้างโปรเจ็กต์ให้เสร็จสมบูรณ์
กำหนดค่ารายละเอียดไคลเอ็นต์ OAuth ดังนี้
- ป้อนชื่อของไคลเอ็นต์
- หากประเภทแอปพลิเคชันเป็นเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม URI Callback ของไคลเอ็นต์ MCP ดังนี้
- สำหรับ Antigravity:
https://antigravity.google/oauth-callback - สำหรับ Claude:
https://claude.ai/api/mcp/auth_callback
- สำหรับ Antigravity:
- ตรวจสอบว่าได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI
อ่านนโยบายข้อมูลผู้ใช้บริการ Google API เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้ แล้วคลิกต่อไป
คอนโซลจะเปิดใช้ Google Workspace API หลักและบริการ MCP ในโปรเจ็กต์ของคุณ และสร้างไคลเอ็นต์ OAuth
คัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ แล้วเชื่อมต่อไคลเอ็นต์กับเซิร์ฟเวอร์ 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 โดยทำดังนี้
ตั้งค่าหน้าจอขอความยินยอม OAuth
โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
เซิร์ฟเวอร์ MCP ของ Universal Search ใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้
หากคุณกำหนดค่าหน้าจอขอความยินยอม OAuth สำหรับเซิร์ฟเวอร์ MCP อื่นๆ แล้ว ให้ตรวจสอบว่าคุณได้เพิ่มขอบเขตที่จำเป็นสำหรับเซิร์ฟเวอร์ MCP ของ Universal Search แล้ว
เมื่อตรวจสอบสิทธิ์ด้วยเซิร์ฟเวอร์ MCP ของ Universal Search คุณสามารถเลือกตรวจสอบสิทธิ์ขอบเขตที่ขอทั้งหมดหรือเฉพาะบางส่วนก็ได้ เซิร์ฟเวอร์จะปฏิบัติตามตัวเลือกเหล่านี้และค้นหาเฉพาะในผลิตภัณฑ์ที่ได้รับสิทธิ์เข้าถึงเท่านั้น
ตัวอย่างเช่น หากคุณตรวจสอบสิทธิ์ด้วยขอบเขตต่อไปนี้ทั้งหมด
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://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
- ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > การเข้าถึงข้อมูล
- คลิกเพิ่มหรือนำขอบเขตออก
เพิ่มขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://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 เป็นการแชร์ภายนอก และอาจต้องมีการยืนยันจากผู้ใช้หรือถูกกรองออกคลิกอัปเดต แล้วคลิกบันทึก
โปรดดูวิธีการโดยละเอียดเกี่ยวกับการตั้งค่าหน้าจอขอความยินยอมที่หัวข้อกำหนดค่าเซิร์ฟเวอร์ 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
หากยังไม่ได้สร้างไคลเอ็นต์ OAuth ในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ให้สร้างรหัสไคลเอ็นต์ 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)
- เปิดหน้าจอการตั้งค่า (เช่น คลิกการตั้งค่าที่ด้านซ้ายล่าง หรือเปิดการตั้งค่าผู้ใช้ Antigravity)
- ไปที่การปรับแต่ง
- ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช
- ค้นหา
workspace-universalในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง
สำหรับ Antigravity CLI
เริ่ม Antigravity CLI:
agyเปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้
/mcpใช้ปุ่มลูกศรเพื่อเลือก
workspace-universalจากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter
ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้
- สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้าง
workspace-universalในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง - สำหรับ Antigravity CLI: เปิดแผง
/mcpเพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงคำว่า Authed ข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์workspace-universalในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มีอยู่
- สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้าง
Claude
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ของ Universal Search ลงใน Claude ให้กำหนดค่าเครื่องมือเชื่อมต่อที่กำหนดเอง
หากยังไม่ได้สร้างไคลเอ็นต์ OAuth ในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ให้สร้างรหัสไคลเอ็นต์ 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,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 โดยอิงตามคำค้นหาที่ระบุ