Google เอกสารมีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ Agent AI โต้ตอบกับข้อมูลใน Google เอกสารได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google เอกสารจะช่วยให้คุณเปิดใช้แอปพลิเคชัน AI เช่น Google Antigravity และ Claude เพื่อดำเนินการใน Google เอกสารได้
เซิร์ฟเวอร์ MCP ของ Google เอกสารมีวิธีมาตรฐานสำหรับ AI Agent ในการดำเนินการต่อไปนี้
- อ่านข้อมูล: อ่านข้อมูลโครงสร้างและเนื้อหาข้อความของเอกสาร
- ดำเนินการ: อัปเดตการจัดรูปแบบและโครงสร้างเอกสารโดยใช้การอัปเดตเป็นกลุ่ม
- เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้
ข้อกำหนดเบื้องต้น
การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace
โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์
โฮสต์ MCP เช่น Google Antigravity
หากต้องการเรียกใช้คำสั่งในหน้านี้ ให้ตั้งค่า 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 ของ Google เอกสาร
หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google เอกสาร คุณต้องเปิดใช้เซิร์ฟเวอร์ดังกล่าวในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google แล้วกำหนดค่าไคลเอ็นต์ MCP ให้เชื่อมต่อกับเซิร์ฟเวอร์นั้น
เปิดใช้ API
หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google เอกสาร คุณต้องเปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
Google Docs API
CLI
gcloud services enable docs.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้
เปิดใช้บริการ MCP
หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับ Google เอกสาร คุณต้องเปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ Google Cloud
Google Docs MCP API
CLI
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้
ตั้งค่าหน้าจอขอความยินยอม OAuth
เซิร์ฟเวอร์ MCP ของ Google เอกสารใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์
หากกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถกำหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่า Google Auth Platform not configured yet (ยังไม่ได้กำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google) ให้คลิก Get Started (เริ่มต้นใช้งาน)
- ในส่วน App Information ให้พิมพ์
Docs MCP Serverใน App name - ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลของคุณหรือกลุ่ม Google ที่เหมาะสม
- คลิกถัดไป
- ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือกภายในไม่ได้ ให้เลือกภายนอก
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณสามารถรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์ได้
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้สำหรับบริการ Google API และหากคุณยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- หากเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
- คลิกกลุ่มเป้าหมาย
- ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
- ป้อนอีเมลของคุณและผู้ใช้ทดสอบที่ได้รับอนุญาตคนอื่นๆ แล้วคลิกบันทึก
- ในส่วน App Information ให้พิมพ์
คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ Google Cloud
ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับเซิร์ฟเวอร์ MCP ของ Google เอกสารดังนี้
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
คลิกเพิ่มลงในตาราง
คลิกอัปเดต
หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ในหน้าการเข้าถึงข้อมูล ให้คลิกบันทึก
กำหนดค่าไคลเอ็นต์ MCP
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสารลงในไคลเอ็นต์ MCP ให้ทำตามวิธีการสำหรับไคลเอ็นต์ของคุณ
รหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์ซึ่งเรียกใช้เซิร์ฟเวอร์ MCP ของเอกสารต้องเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ หากต้องการอัปเดตรหัสไคลเอ็นต์ OAuth 2.0 ที่มีอยู่ ให้เลือกการตั้งค่านี้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ ตามที่อธิบายไว้ในหัวข้อจัดการไคลเอ็นต์ OAuth หากคุณเปลี่ยนการตั้งค่านี้ในไคลเอ็นต์ที่มีอยู่ไม่ได้ หรือหากไคลเอ็นต์รองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย ให้สร้างรหัสไคลเอ็นต์ OAuth 2.0 ใหม่สำหรับ AI Agent สำหรับคำขอที่ถูกปฏิเสธ บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน หรือ Google Apps Script โปรดดูหัวข้อการแก้ปัญหา
Antigravity
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสารลงใน Antigravity
ให้เพิ่มการกำหนดค่าเซิร์ฟเวอร์ลงในไฟล์ mcp_config.json วิธีการเหล่านี้รองรับ Antigravity 2.0, Antigravity IDE และ Antigravity CLI
สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 โดยทำดังนี้
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client
เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน
ป้อนชื่อ
ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม
https://antigravity.google/oauth-callbackในช่อง URIเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
คลิก Create แล้วคัดลอก Client ID และ รหัสลับไคลเอ็นต์
เปิดหรือสร้างไฟล์การกำหนดค่า
~/.gemini/config/mcp_config.jsonเพิ่มการกำหนดค่า
mcpServersลงในmcp_config.jsonดังนี้{ "mcpServers": { "docs": { "serverUrl": "https://docsmcp.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 ที่ติดตั้ง ให้คลิกรีเฟรช
- ค้นหา
docsในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง
สำหรับ Antigravity CLI
เริ่ม Antigravity CLI:
agyเปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้
/mcpใช้ปุ่มลูกศรเพื่อเลือก
docsจากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter
ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้
- สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้างเซิร์ฟเวอร์ในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง
- สำหรับ Antigravity CLI: เปิดแผง
/mcpเพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงตรวจสอบสิทธิ์แล้วข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์ใดก็ได้ในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มีอยู่
เซิร์ฟเวอร์ MCP ระยะไกลพร้อมใช้งานใน Antigravity แล้ว
Claude
หากต้องการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสารกับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสารลงใน Claude ให้กำหนดค่าเครื่องมือเชื่อมต่อที่กำหนดเองด้วยรหัสไคลเอ็นต์และรหัสลับ OAuth
สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 โดยทำดังนี้
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client
เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน
ป้อนชื่อ
ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม
https://claude.ai/api/mcp/auth_callbackในช่อง URIเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
คลิก Create แล้วคัดลอก Client ID และ รหัสลับไคลเอ็นต์
กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้
- ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าของผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
- คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
- ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ Google เอกสาร ดังนี้
- ชื่อเซิร์ฟเวอร์:
Google Docs - URL ของเซิร์ฟเวอร์ MCP ระยะไกล:
https://docsmcp.googleapis.com/mcp/v1
- ชื่อเซิร์ฟเวอร์:
- ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
- คลิกเพิ่ม
อื่นๆ
แอปพลิเคชัน AI จำนวนมากมีวิธีเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล โดยปกติแล้ว คุณจะต้องป้อนรายละเอียดเกี่ยวกับเซิร์ฟเวอร์ เช่น ชื่อ, ปลายทาง, โปรโตคอลการรับส่ง และวิธีการตรวจสอบสิทธิ์ สำหรับเซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสาร ให้ป้อนข้อมูลต่อไปนี้
ชื่อเซิร์ฟเวอร์:
docsURL ของเซิร์ฟเวอร์:
https://docsmcp.googleapis.com/mcp/v1การส่งข้อมูล: HTTP ที่สตรีมได้
การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของ Google เอกสารใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อไคลเอ็นต์ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI
ทดสอบเซิร์ฟเวอร์ MCP ของ Google เอกสาร
หลังจากกำหนดค่าไคลเอ็นต์ MCP แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ
ลองถามคำถามต่อไปนี้กับไคลเอ็นต์ MCP
"แสดงเนื้อหาเชิงโครงสร้างของเอกสารใน Google เอกสาร
abcd123"ไคลเอ็นต์จะดึงโครงสร้างและเนื้อหาของเอกสารโดยใช้
docs.read_doc"แทรกชื่อ 'แผนการตลาดของฉัน' ลงใน Google เอกสาร
abcd123"ไคลเอ็นต์จะดำเนินการ
docs.update_docเพื่ออัปเดตองค์ประกอบโครงสร้างและแทรกข้อความ
หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ MCP ของ Google เอกสารได้รับการกำหนดค่าอย่างถูกต้อง
การแก้ปัญหา
ใช้ส่วนต่อไปนี้เพื่อแก้ไขปัญหาการตรวจสอบสิทธิ์และการเชื่อมต่อที่พบบ่อยกับเซิร์ฟเวอร์ MCP ของเอกสาร
ตรวจสอบเหตุการณ์ในบันทึกของ OAuth
หากพบปัญหาในการเชื่อมต่อกับเซิร์ฟเวอร์ MCP ให้ตรวจสอบข้อผิดพลาดในบันทึก OAuth ขอให้ผู้ดูแลระบบ Google Workspace ตรวจสอบเหตุการณ์ในบันทึกของ OAuth ในเครื่องมือตรวจสอบความปลอดภัย
คำขอที่ถูกปฏิเสธจากไคลเอ็นต์ OAuth ที่ได้รับมอบสิทธิ์จากผู้ใช้
หากคำขอไปยังเซิร์ฟเวอร์ MCP ถูกปฏิเสธ ให้ตรวจสอบว่ารหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์สำหรับขั้นตอน OAuth แบบ 3 ทางได้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ไว้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์
- ไคลเอ็นต์ที่มีอยู่รองรับการตั้งค่า: เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ในไคลเอ็นต์ OAuth ที่มีอยู่
- อัปเดตไคลเอ็นต์ที่มีอยู่ไม่ได้: สร้างไคลเอ็นต์ OAuth ใหม่โดยเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI แล้วอัปเดตแอปเพื่อใช้ไคลเอ็นต์ดังกล่าว
- ไคลเอ็นต์ที่มีอยู่ยังรองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย: สร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับ AI Agent และเก็บไคลเอ็นต์ที่มีอยู่ไว้สำหรับฟีเจอร์ที่ไม่ใช่ Agent
โปรดดูวิธีการที่หัวข้อกำหนดค่าไคลเอ็นต์ MCP และจัดการไคลเอ็นต์ OAuth
บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน
หากแอปใช้บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมนสำหรับ OAuth แบบ 2-legged คุณจะเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ไม่ได้ เนื่องจากระบบไม่ได้จัดการบัญชีบริการในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์
- การควบคุมการเข้าถึง: คำขอไปยังเซิร์ฟเวอร์ MCP จากบัญชีบริการเหล่านี้จะไม่ถูกปฏิเสธเนื่องจากไม่มีการตั้งค่าตัวแทน แต่จะควบคุมการเข้าถึงด้วยการตั้งค่าการมอบสิทธิ์ทั่วทั้งโดเมนที่ผู้ดูแลระบบ Google Workspace เป็นผู้จัดการ ดูรายละเอียดเกี่ยวกับการตั้งค่าของผู้ดูแลระบบได้ที่หัวข้อควบคุมการเข้าถึง API ด้วยการมอบสิทธิ์ทั่วทั้งโดเมน
- การดำเนินการที่มีความละเอียดอ่อน: เซิร์ฟเวอร์ MCP ของ Google Workspace จะยังคงแสดงพรอมต์การดึงข้อมูลแบบฟอร์มสำหรับการยืนยันแบบมีมนุษย์ร่วมในการเรียกใช้เครื่องมือที่มีความละเอียดอ่อนซึ่งดำเนินการผ่านการสวมบทบาทเป็นผู้ใช้ที่มีการมอบสิทธิ์ทั่วทั้งโดเมน
คำขอจาก Apps Script
หากเรียกเซิร์ฟเวอร์ MCP จาก Apps Script คุณจะไม่สามารถเลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ในไคลเอ็นต์ OAuth เริ่มต้นที่ Apps Script สร้างและจัดการสำหรับสคริปต์ของคุณ ซึ่งจะมีผลแม้ว่าสคริปต์จะใช้โปรเจ็กต์ Google Cloud มาตรฐานก็ตาม
หากต้องการเรียกใช้เซิร์ฟเวอร์ MCP จาก Apps Script ให้ทำดังนี้
- ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ สร้างไคลเอ็นต์ OAuth และเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
- ในสคริปต์ ให้ใช้ไลบรารี OAuth2 สำหรับ Apps Script เพื่อให้สิทธิ์ผู้ใช้ด้วยไคลเอ็นต์ OAuth นั้น
- เมื่อเรียกใช้เซิร์ฟเวอร์ MCP ให้ส่งโทเค็นเพื่อการเข้าถึงที่ไลบรารีแสดงผลแทนโทเค็นจาก
ScriptApp.getOAuthToken
โปรเจ็กต์ Apps Script ที่ไม่ได้เรียกใช้เซิร์ฟเวอร์ MCP ของ Google Workspace จะไม่ได้รับผลกระทบ
ข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง
หากระบบแจ้งให้คุณลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง แสดงว่าไคลเอ็นต์ MCP ไม่ได้รับโทเค็นการรีเฟรช เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเฉพาะเมื่อคำขอการให้สิทธิ์มี access_type=offline การขอเฉพาะขอบเขต offline_access ของ OpenID Connect (OIDC) จะไม่แสดงผลลัพธ์ใดๆ
ตรวจสอบว่าไคลเอ็นต์ MCP ของคุณรองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเองหรือไม่ โดยทำดังนี้
- ไคลเอ็นต์รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง: เพิ่ม
access_type=offlineลงในคำขอการให้สิทธิ์ หากต้องการรับโทเค็นการรีเฟรชใหม่สำหรับผู้ใช้ที่ให้สิทธิ์เข้าถึงแล้ว ให้เพิ่มprompt=consentด้วย - ไคลเอ็นต์ไม่รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง: ลงชื่อเข้าใช้อีกครั้งทุกครั้งที่โทเค็นเพื่อการเข้าถึงหมดอายุ
โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง
ข้อมูลอ้างอิงของเครื่องมือ
เครื่องมือต่อไปนี้พร้อมใช้งานสำหรับเซิร์ฟเวอร์ MCP ของ Google เอกสาร
read_docupdate_doc
ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม
เมื่อคุณแสดงโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ อาจมีความเสี่ยงที่จะเกิดการโจมตีแบบแทรกพรอมต์โดยอ้อม เนื่องจากโฮสต์ MCP เช่น Google Antigravity มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ MCP ของ Google เอกสาร โฮสต์ดังกล่าวจึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ของคุณได้
เพื่อลดความเสี่ยงเหล่านี้ คุณต้องคัดกรองพรอมต์และคำตอบเพื่อหาเนื้อหาที่เป็นอันตรายหรือการโจมตีแบบแทรกพรอมต์ คุณสามารถใช้ Model Armor ที่ Google มีให้ หรือจะใช้โซลูชันของคุณเองก็ได้ หากคุณจัดทำเอกสารเพื่อให้ผู้ใช้ยอมรับความเสี่ยงนั้น โปรดดูข้อมูลเพิ่มเติมที่หัวข้อกำหนดค่าความปลอดภัยสำหรับเซิร์ฟเวอร์ MCP ของ Google Workspace
ทำตามแนวทางปฏิบัติแนะนำต่อไปนี้
- ใช้เฉพาะเครื่องมือที่เชื่อถือได้ อย่าเชื่อมต่อเซิร์ฟเวอร์ MCP ของ Google เอกสารกับแอปพลิเคชันที่ไม่น่าเชื่อถือหรือไม่ได้รับการยืนยัน
- โปรดระมัดระวังอินพุตที่ไม่น่าเชื่อถือ หลีกเลี่ยงการขอให้ไคลเอ็นต์ MCP ประมวลผลเอกสารหรือทรัพยากรอื่นๆ จากแหล่งที่มาที่ไม่ได้รับการยืนยัน ข้อมูลเหล่านี้อาจมีคำสั่งที่ซ่อนอยู่ซึ่งสามารถลักลอบใช้เซสชันของคุณ ซึ่งจะช่วยให้ผู้โจมตีแก้ไข ขโมย หรือลบข้อมูลของคุณได้
- ตรวจสอบการดำเนินการทั้งหมด โปรดตรวจสอบการดำเนินการที่ไคลเอ็นต์ AI ทำในนามของคุณอย่างละเอียดทุกครั้งเพื่อให้แน่ใจว่าถูกต้องและสอดคล้องกับความตั้งใจของคุณ