ชีตมีเซิร์ฟเวอร์ 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สำหรับการตั้งค่าด้วยตนเองในหน้านี้ ให้ตั้งค่า 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 ด้วยไคลเอ็นต์ OAuth 2.0 ของ AI Agent และกำหนดค่าแอปพลิเคชัน AI ให้เชื่อมต่อกับโปรเจ็กต์ดังกล่าว โดยทำดังนี้
- การใช้งานส่วนตัว: หากคุณกำลังเชื่อมต่อแอปพลิเคชัน AI สำหรับบัญชี Google ของคุณเอง ให้ใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัวเพื่อกำหนดค่าโปรเจ็กต์ เปิดใช้ API และบริการ MCP และสร้างไคลเอ็นต์ OAuth ในหน้าเดียว
- การตั้งค่าสำหรับผู้ใช้หลายคนหนึ่งเครื่องหรือการตั้งค่าที่กำหนดเอง: หากผู้ใช้หลายคนจะลงชื่อเข้าใช้ด้วยไคลเอ็นต์ OAuth ของคุณ หรือหากต้องการเปิดใช้เฉพาะ API, บริการ MCP และขอบเขต 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 ของชีต ให้เปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google Cloud
Google Sheets API
CLI
gcloud services enable sheets.googleapis.com --project=PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud
คอนโซล
เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้
เปิดใช้บริการ MCP
โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว
หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับชีต ให้เปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
Sheets MCP API
CLI
gcloud services enable sheetsmcp.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 ให้พิมพ์
Sheets 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/spreadsheets.readonlyhttps://www.googleapis.com/auth/spreadsheets
คลิกเพิ่มลงในตาราง
คลิกอัปเดต
หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ในหน้าการเข้าถึงข้อมูล ให้คลิกบันทึก
กำหนดค่าแอปพลิเคชัน AI
หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของชีตลงในแอปพลิเคชัน AI ให้ทำตามวิธีการสำหรับแอปพลิเคชันของคุณ
รหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์ซึ่งเรียกใช้เซิร์ฟเวอร์ 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": { "sheets": { "serverUrl": "https://sheetsmcp.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 ที่ติดตั้ง ให้คลิกรีเฟรช
- ค้นหา
sheetsในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง
สำหรับ Antigravity CLI
เริ่ม Antigravity CLI:
agyเปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้
/mcpใช้ปุ่มลูกศรเพื่อเลือก
sheetsจากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด 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 ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
- คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
- ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ชีต ดังนี้
- ชื่อเซิร์ฟเวอร์:
Sheets - URL ของเซิร์ฟเวอร์ MCP ระยะไกล:
https://sheetsmcp.googleapis.com/mcp/v1
- ชื่อเซิร์ฟเวอร์:
- ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
- คลิกเพิ่ม
อื่นๆ
แอปพลิเคชัน AI จำนวนมากมีวิธีเชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล โดยปกติแล้ว คุณจะต้องป้อนรายละเอียดเกี่ยวกับเซิร์ฟเวอร์ เช่น ชื่อ, ปลายทาง, โปรโตคอลการรับส่ง และวิธีการตรวจสอบสิทธิ์ สำหรับเซิร์ฟเวอร์ MCP ระยะไกลของชีต ให้ป้อนข้อมูลต่อไปนี้
ชื่อเซิร์ฟเวอร์:
sheetsURL ของเซิร์ฟเวอร์:
https://sheetsmcp.googleapis.com/mcp/v1การส่ง: HTTP ที่สตรีมได้
การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของชีตใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI สำหรับการตั้งค่าส่วนบุคคลของผู้ใช้รายเดียว คุณสามารถสร้างไคลเอ็นต์เว็บ, เดสก์ท็อป, Android หรือ iOS โดยใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
หากต้องการหลีกเลี่ยงข้อความแจ้งให้ลงชื่อเข้าใช้ทุกชั่วโมงด้วยไคลเอ็นต์ OAuth ของเว็บแอปพลิเคชัน ให้กำหนดค่าไคลเอ็นต์ MCP เพื่อขอสิทธิ์เข้าถึงแบบออฟไลน์โดยใช้
access_type=offlineหรือขอบเขตoffline_accessโปรดดูรายละเอียดที่หัวข้อข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง
ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อแอปพลิเคชัน AI ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI
ทดสอบเซิร์ฟเวอร์ MCP ของชีต
หลังจากกำหนดค่าแอปพลิเคชัน AI แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ
ลองถามคำถามต่อไปนี้กับแอปพลิเคชัน AI ของคุณ
"อ่านชีต Sheet1 จาก Google ชีต
abcd123"ไคลเอ็นต์จะดึงค่าตารางกริดโดยใช้
sheets.get_values"แทรกคอลัมน์ที่ดัชนีคอลัมน์ 2 ในสเปรดชีต Google ชีตชื่อ
abcd123"ไคลเอ็นต์จะดำเนินการ
sheets.insert_dimensionเพื่อเปลี่ยนแปลงคอลัมน์
หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ 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 ทำในนามของคุณอย่างรอบคอบเสมอ เพื่อให้แน่ใจว่าการดำเนินการนั้นถูกต้องและตรงกับความตั้งใจของคุณ