เอกสารมีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ AI Agent โต้ตอบกับข้อมูลเอกสารได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ MCP ของเอกสารจะช่วยให้แอปพลิเคชัน AI เช่น Google Antigravity และ Claude ดำเนินการในเอกสารได้
เซิร์ฟเวอร์ MCP ของเอกสารมีวิธีมาตรฐานสำหรับ AI Agent ในการทำสิ่งต่อไปนี้
- อ่านข้อมูล: อ่านข้อมูลโครงสร้างเอกสารและเนื้อหาข้อความ
- ดำเนินการ: อัปเดตการจัดรูปแบบและโครงสร้างเอกสารโดยใช้การอัปเดตเป็นกลุ่ม
- เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้
ข้อกำหนดเบื้องต้น
การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace
โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์
โฮสต์ MCP ซึ่งเป็นแอปพลิเคชัน AI เช่น Google Antigravity หรือ Claude แอปพลิเคชัน AI จะสร้างการเชื่อมต่อไคลเอ็นต์ MCP สำหรับเซิร์ฟเวอร์ MCP แต่ละรายการ
หากต้องการเรียกใช้คำสั่งในหน้านี้ ให้ตั้งค่า 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 ของเอกสาร
หากต้องการใช้เซิร์ฟเวอร์ MCP ของเอกสาร ให้เปิดใช้ในโปรเจ็กต์ Google Cloud และกำหนดค่าแอปพลิเคชัน AI ให้เชื่อมต่อกับเซิร์ฟเวอร์ดังกล่าว
เปิดใช้ API
หากต้องการใช้เซิร์ฟเวอร์ MCP ของเอกสาร ให้เปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud
Google Docs API
CLI
gcloud services enable docs.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้
เปิดใช้บริการ MCP
หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับเอกสาร ให้เปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
Docs MCP API
CLI
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้
ตั้งค่าหน้าจอขอความยินยอม OAuth
เซิร์ฟเวอร์ MCP ของเอกสารใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้
ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์
หากกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถกำหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ให้คลิกเริ่มต้นใช้งาน
- ในส่วน App Information ให้พิมพ์
Docs MCP Serverใน App name - ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลของคุณหรือ Google Group ที่เหมาะสม
- คลิกถัดไป
- ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือกภายในไม่ได้ ให้เลือกภายนอก
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณสามารถรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์ได้
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้บริการ Google API และหากคุณยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- หากเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
- คลิกกลุ่มเป้าหมาย
- ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
- ป้อนอีเมลของคุณและผู้ใช้ทดสอบที่ได้รับอนุญาตคนอื่นๆ แล้วคลิกบันทึก
- ในส่วน App Information ให้พิมพ์
คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับเซิร์ฟเวอร์ MCP ของเอกสารดังนี้
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
คลิกเพิ่มลงในตาราง
คลิกอัปเดต
หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ในหน้าการเข้าถึงข้อมูล ให้คลิกบันทึก
กำหนดค่าแอปพลิเคชัน AI
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของเอกสารลงในแอปพลิเคชัน AI ให้ทำตามวิธีการสำหรับแอปพลิเคชันของคุณ
รหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์ซึ่งเรียกใช้เซิร์ฟเวอร์ Docs MCP ต้องเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ หากต้องการอัปเดตรหัสไคลเอ็นต์ OAuth 2.0 ที่มีอยู่ ให้เลือกการตั้งค่านี้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ ตามที่อธิบายไว้ในหัวข้อจัดการไคลเอ็นต์ OAuth หากคุณเปลี่ยนการตั้งค่านี้ในไคลเอ็นต์ที่มีอยู่ไม่ได้ หรือหากไคลเอ็นต์รองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย ให้สร้างรหัสไคลเอ็นต์ OAuth 2.0 ใหม่สำหรับ AI Agent สำหรับคำขอที่ถูกปฏิเสธ บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน หรือ Google Apps Script โปรดดูหัวข้อการแก้ปัญหา
Antigravity
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของเอกสารลงใน 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
คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์
เปิดหรือสร้างไฟล์การกำหนดค่า
~/.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 ระยะไกลของเอกสารกับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของเอกสารลงใน 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
คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์
กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้
- ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
- คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
- ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์เอกสาร ดังนี้
- ชื่อเซิร์ฟเวอร์:
Docs - URL ของเซิร์ฟเวอร์ MCP ระยะไกล:
https://docsmcp.googleapis.com/mcp/v1
- ชื่อเซิร์ฟเวอร์:
- ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
- คลิกเพิ่ม
อื่นๆ
แอปพลิเคชัน AI จำนวนมากมีวิธีเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล โดยปกติแล้ว คุณจะต้องป้อนรายละเอียดเกี่ยวกับเซิร์ฟเวอร์ เช่น ชื่อ, ปลายทาง, โปรโตคอลการรับส่ง และวิธีการตรวจสอบสิทธิ์ สำหรับเซิร์ฟเวอร์ MCP ระยะไกลของเอกสาร ให้ป้อนข้อมูลต่อไปนี้
ชื่อเซิร์ฟเวอร์:
docsURL ของเซิร์ฟเวอร์:
https://docsmcp.googleapis.com/mcp/v1การส่ง: HTTP ที่สตรีมได้
การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของเอกสารใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
หากต้องการหลีกเลี่ยงข้อความแจ้งให้ลงชื่อเข้าใช้ทุกชั่วโมงด้วยไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชัน ให้กำหนดค่าไคลเอ็นต์ MCP เพื่อขอสิทธิ์เข้าถึงแบบออฟไลน์โดยใช้
access_type=offlineหรือขอบเขตoffline_accessโปรดดูรายละเอียดที่หัวข้อข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อแอปพลิเคชัน AI ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI
ทดสอบเซิร์ฟเวอร์ MCP ของเอกสาร
หลังจากกำหนดค่าแอปพลิเคชัน AI แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ
ลองถามคำถามต่อไปนี้กับแอปพลิเคชัน AI ของคุณ
"แสดงเนื้อหาเชิงโครงสร้างของเอกสารใน Google เอกสารชื่อ
abcd123"ไคลเอ็นต์จะดึงโครงสร้างและเนื้อหาของเอกสารโดยใช้
docs.read_doc"แทรกชื่อ 'แผนการตลาดของฉัน' ลงใน Google เอกสาร
abcd123"ไคลเอ็นต์จะดำเนินการ
docs.update_docเพื่ออัปเดตองค์ประกอบโครงสร้างและแทรกข้อความ
หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ MCP ของเอกสารได้รับการกำหนดค่าอย่างถูกต้อง
การแก้ปัญหา
ใช้ส่วนต่อไปนี้เพื่อแก้ไขปัญหาการตรวจสอบสิทธิ์และการเชื่อมต่อที่พบบ่อยกับเซิร์ฟเวอร์ MCP ของเอกสาร
ตรวจสอบเหตุการณ์ในบันทึกของ OAuth
หากพบปัญหาในการเชื่อมต่อกับเซิร์ฟเวอร์ MCP ให้ตรวจสอบข้อผิดพลาดในบันทึก OAuth ขอให้ผู้ดูแลระบบ Google Workspace ตรวจสอบเหตุการณ์ในบันทึกของ OAuth ในเครื่องมือตรวจสอบความปลอดภัย
คำขอที่ถูกปฏิเสธจากไคลเอ็นต์ OAuth ที่ผู้ใช้มอบสิทธิ์
หากคำขอไปยังเซิร์ฟเวอร์ MCP ถูกปฏิเสธ ให้ตรวจสอบว่ารหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์สำหรับขั้นตอน OAuth แบบ 3 ทางได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ไว้ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์
- ไคลเอ็นต์ที่มีอยู่รองรับการตั้งค่า: เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI ในไคลเอ็นต์ OAuth ที่มีอยู่
- อัปเดตไคลเอ็นต์ที่มีอยู่ไม่ได้: สร้างไคลเอ็นต์ OAuth ใหม่โดยเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI แล้วอัปเดตแอปเพื่อใช้ไคลเอ็นต์ดังกล่าว
- ไคลเอ็นต์ที่มีอยู่ยังรองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย: สร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับ AI Agent และเก็บไคลเอ็นต์ที่มีอยู่ไว้สำหรับฟีเจอร์ที่ไม่ใช่ Agent
โปรดดูวิธีการที่หัวข้อกำหนดค่าแอปพลิเคชัน AI และจัดการไคลเอ็นต์ 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 ของเว็บแอปพลิเคชัน: ไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชันจะใช้การเข้าถึงแบบออนไลน์โดยค่าเริ่มต้น ซึ่งต่างจากไคลเอ็นต์ OAuth ของแอปบนเดสก์ท็อป หากต้องการขอโทเค็นการรีเฟรช ให้ใส่
access_type=offlineหรือใส่ขอบเขต OpenID Connect (OIDC)offline_accessควบคู่ไปกับขอบเขต API อย่างน้อย 1 รายการ และอย่าตั้งค่าaccess_type=online - การให้สิทธิ์อีกครั้งแก่แอปที่ได้รับความยินยอมแล้ว: เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเมื่อผู้ใช้ให้สิทธิ์เข้าถึงแบบออฟไลน์เป็นครั้งแรก หากผู้ใช้ให้สิทธิ์ไคลเอ็นต์ OAuth ของคุณแล้วโดยไม่มีการเข้าถึงแบบออฟไลน์ หรือหากไคลเอ็นต์ MCP ของคุณสูญเสียโทเค็นการรีเฟรชที่จัดเก็บไว้ การลงชื่อเข้าใช้ครั้งต่อๆ ไปอาจไม่แสดงโทเค็นการรีเฟรชใหม่ รวม
prompt=consentไว้ในคำขอการให้สิทธิ์ หรือนำสิทธิ์เข้าถึงของแอปออกในการเชื่อมต่อบัญชี Google แล้วลงชื่อเข้าใช้อีกครั้ง - โทเค็นสำหรับผู้ถือแบบคงที่: หากคุณส่งโทเค็นเพื่อการเข้าถึงแบบข้อมูลดิบในส่วนหัว
Authorizationเช่น เอาต์พุตจากgcloud auth print-access-tokenโทเค็นจะหมดอายุหลังจากผ่านไป 1 ชั่วโมง เว้นแต่ไคลเอ็นต์จะรีเฟรช
โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง
ข้อมูลอ้างอิงเกี่ยวกับเครื่องมือ
เครื่องมือต่อไปนี้พร้อมใช้งานสำหรับเซิร์ฟเวอร์ MCP ของเอกสาร ดูสคีมาอินพุตและเอาต์พุตได้ที่เอกสารอ้างอิง MCP ของเอกสาร
ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม
เมื่อคุณแสดงโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ จะมีความเสี่ยงต่อการโจมตีแบบแทรกพรอมต์โดยอ้อม เนื่องจากแอปพลิเคชัน AI เช่น Google Antigravity มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ MCP ของเอกสาร จึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ของคุณได้
เพื่อลดความเสี่ยงเหล่านี้ คุณต้องคัดกรองพรอมต์และคำตอบเพื่อหาเนื้อหาที่เป็นอันตรายหรือการโจมตีแบบแทรกพรอมต์ คุณสามารถใช้ Model Armor ที่ Google มีให้ หรือจะใช้โซลูชันของคุณเองก็ได้หากคุณจัดทำเอกสารเพื่อให้ผู้ใช้ยอมรับความเสี่ยงนั้นได้ โปรดดูวิธีการที่หัวข้อกำหนดค่าความปลอดภัยสำหรับเซิร์ฟเวอร์ MCP ของ Google Workspace
ทำตามแนวทางปฏิบัติแนะนำต่อไปนี้
- ใช้เฉพาะเครื่องมือที่เชื่อถือได้ อย่าเชื่อมต่อเซิร์ฟเวอร์ MCP ของเอกสารกับแอปพลิเคชันที่ไม่น่าเชื่อถือหรือไม่ได้รับการยืนยัน
- โปรดระมัดระวังอินพุตที่ไม่น่าเชื่อถือ หลีกเลี่ยงการขอให้แอปพลิเคชัน AI ประมวลผลเอกสารหรือแหล่งข้อมูลอื่นๆ จากแหล่งที่มาที่ไม่ได้รับการยืนยัน ข้อมูลที่ป้อนเหล่านี้อาจมีคำสั่งที่ซ่อนอยู่ซึ่งสามารถลักลอบใช้เซสชันของคุณและอนุญาตให้ผู้โจมตีแก้ไข ขโมย หรือลบข้อมูลของคุณได้
- ตรวจสอบการดำเนินการทั้งหมด โปรดตรวจสอบการดำเนินการที่แอปพลิเคชัน AI ทำในนามของคุณอย่างรอบคอบเสมอ เพื่อให้แน่ใจว่าการดำเนินการนั้นถูกต้องและตรงกับความตั้งใจของคุณ