กำหนดค่าเซิร์ฟเวอร์ MCP ของ Google ชีต

ชีตมีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ AI Agent โต้ตอบกับข้อมูลในชีตได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ MCP ของชีตจะช่วยให้คุณเปิดใช้แอปพลิเคชัน AI เช่น Google Antigravity และ Claude เพื่อดำเนินการในชีตได้

เซิร์ฟเวอร์ MCP ของชีตมอบวิธีมาตรฐานสำหรับ AI Agent ในการดำเนินการต่อไปนี้

  • อ่านข้อมูล: ดึงค่าของเซลล์ ชื่อชีต พร็อพเพอร์ตี้ตารางกริด และข้อมูลเมตาอื่นๆ ของสเปรดชีต
  • ดำเนินการ: อัปเดตค่าของเซลล์ ตั้งค่าสูตร แทรกแถวและคอลัมน์ และดำเนินการอัปเดตโครงสร้างสเปรดชีตเป็นกลุ่ม
  • เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้

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

กำหนดค่าเซิร์ฟเวอร์ 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 แยกต่างหาก โดยทำดังนี้

  1. เปิดการเริ่มต้นใช้งานโหมดส่วนตัวในคอนโซล Google Cloud ปุ่มนี้จะเลือกไคลเอ็นต์เว็บแอปพลิเคชันไว้ล่วงหน้า ซึ่ง Google Antigravity และ Claude กำหนดให้ต้องใช้

    ตั้งค่าโหมดส่วนตัว

    หากไคลเอ็นต์ MCP ใช้ขั้นตอน OAuth บนเดสก์ท็อปหรืออุปกรณ์เคลื่อนที่แทน URI การเปลี่ยนเส้นทางเว็บ ให้เปิดการตั้งค่าโหมดส่วนตัวสำหรับไคลเอ็นต์แอปบนเดสก์ท็อป, Android หรือ iOS หรือเปลี่ยนประเภทแอปพลิเคชันในหน้าเว็บ

  2. ในส่วนเลือกโปรเจ็กต์ ให้เลือกโปรเจ็กต์โหมดส่วนตัวที่มีอยู่ หรือคลิกสร้างโปรเจ็กต์ใหม่ หากได้รับข้อความแจ้ง ให้กรอกแบบฟอร์มการสร้างโปรเจ็กต์ให้เสร็จสมบูรณ์

  3. กำหนดค่ารายละเอียดไคลเอ็นต์ OAuth ดังนี้

    • ป้อนชื่อของไคลเอ็นต์
    • หากประเภทแอปพลิเคชันเป็นเว็บแอปพลิเคชัน ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม URI Callback ของไคลเอ็นต์ MCP ดังนี้
      • สำหรับ Antigravity: https://antigravity.google/oauth-callback
      • สำหรับ Claude: https://claude.ai/api/mcp/auth_callback
    • ตรวจสอบว่าได้เลือกใช้ไคลเอ็นต์นี้สำหรับตัวแทนที่ทำงานด้วยระบบ AI
  4. อ่านนโยบายข้อมูลผู้ใช้บริการ Google API เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้ แล้วคลิกต่อไป

    คอนโซลจะเปิดใช้ Google Workspace API หลักและบริการ MCP ในโปรเจ็กต์ของคุณ และสร้างไคลเอ็นต์ OAuth

  5. คัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ แล้วเชื่อมต่อไคลเอ็นต์กับเซิร์ฟเวอร์ 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 โดยทำดังนี้

เปิดใช้ API

เปิดใช้บริการ MCP

โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว

หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับชีต ให้เปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

  • Sheets MCP API

CLI

gcloud services enable sheetsmcp.googleapis.com --project=PROJECT_ID

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud

คอนโซล

เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้บริการ MCP

โปรดข้ามขั้นตอนนี้หากใช้การตั้งค่าด่วนสำหรับการใช้งานส่วนตัว

เซิร์ฟเวอร์ MCP ของชีตใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้

  1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > การสร้างแบรนด์

    ไปที่การสร้างแบรนด์

  2. หากกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถกำหนดการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ให้คลิกเริ่มต้นใช้งาน

    1. ในส่วน App Information ให้พิมพ์ Sheets MCP Server ใน App name
    2. ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลของคุณหรือ Google Group ที่เหมาะสม
    3. คลิกถัดไป
    4. ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือกภายในไม่ได้ ให้เลือกภายนอก
    5. คลิกถัดไป
    6. ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
    7. คลิกถัดไป
    8. ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้บริการ Google API และหากคุณยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
    9. คลิกต่อไป
    10. คลิกสร้าง
    11. หากเลือกภายนอกเป็นประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
      1. คลิกกลุ่มเป้าหมาย
      2. ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
      3. ป้อนอีเมลของคุณและผู้ใช้ทดสอบที่ได้รับอนุญาตคนอื่นๆ แล้วคลิกบันทึก
  3. คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

    1. ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับเซิร์ฟเวอร์ MCP ของชีต ดังนี้

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/spreadsheets.readonly
      • https://www.googleapis.com/auth/spreadsheets
    2. คลิกเพิ่มลงในตาราง

    3. คลิกอัปเดต

    4. หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ในหน้าการเข้าถึงข้อมูล ให้คลิกบันทึก

กำหนดค่าแอปพลิเคชัน 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

  1. สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 หรือข้ามไปยังขั้นตอนถัดไปหากคุณสร้างไว้แล้วในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว

    1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

    2. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน

    3. ป้อนชื่อ

    4. ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://antigravity.google/oauth-callback ในช่อง URI

    5. เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI

    6. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

  2. เปิดหรือสร้างไฟล์การกำหนดค่า ~/.gemini/config/mcp_config.json

  3. เพิ่มการกำหนดค่า 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: รหัสลับไคลเอ็นต์ที่คุณสร้าง
  4. ประหยัด mcp_config.json

  5. ตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP คุณสามารถตรวจสอบสิทธิ์โดยใช้การตั้งค่า GUI หรือ CLI ก็ได้ ดังนี้

    • สำหรับ Antigravity IDE หรือ GUI (Antigravity 2.0)

      1. เปิดหน้าจอการตั้งค่า (เช่น คลิกการตั้งค่าที่ด้านซ้ายล่าง หรือเปิดการตั้งค่าผู้ใช้ Antigravity)
      2. ไปที่การปรับแต่ง
      3. ในส่วนเซิร์ฟเวอร์ MCP ที่ติดตั้ง ให้คลิกรีเฟรช
      4. ค้นหา sheets ในรายการ คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง
    • สำหรับ Antigravity CLI

      1. เริ่ม Antigravity CLI:

        agy
        
      2. เปิดแผงการจัดการ MCP แบบอินเทอร์แอกทีฟโดยเรียกใช้คำสั่งต่อไปนี้

        /mcp
        
      3. ใช้ปุ่มลูกศรเพื่อเลือก sheets จากนั้นไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter

  6. ตรวจสอบว่าเซิร์ฟเวอร์ได้รับการกำหนดค่าอย่างถูกต้องและทำงานอยู่ โดยทำดังนี้

    • สำหรับ 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 และรหัสลับ

  1. สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 หรือข้ามไปยังขั้นตอนถัดไปหากคุณสร้างไว้แล้วในการตั้งค่าด่วนสำหรับการใช้งานส่วนตัว

    1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

    2. เลือกเว็บแอปพลิเคชันเป็นประเภทแอปพลิเคชัน

    3. ป้อนชื่อ

    4. ในส่วน URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต ให้คลิก + เพิ่ม URI แล้วเพิ่ม https://claude.ai/api/mcp/auth_callback ในช่อง URI

    5. เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI

    6. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

  2. กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้

    1. ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
    2. คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง
    3. ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ชีต ดังนี้
      • ชื่อเซิร์ฟเวอร์: Sheets
      • URL ของเซิร์ฟเวอร์ MCP ระยะไกล: https://sheetsmcp.googleapis.com/mcp/v1
    4. ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
    5. คลิกเพิ่ม

อื่นๆ

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

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อแอปพลิเคชัน 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 ให้ทำดังนี้

  1. ในคอนโซล Google Cloud ให้ไปที่แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ สร้างไคลเอ็นต์ OAuth แล้วเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI
  2. ในสคริปต์ ให้ใช้ไลบรารี OAuth2 สำหรับ Apps Script เพื่อให้สิทธิ์ผู้ใช้ด้วยไคลเอ็นต์ OAuth นั้น
  3. เมื่อเรียกใช้เซิร์ฟเวอร์ 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 ทำในนามของคุณอย่างรอบคอบเสมอ เพื่อให้แน่ใจว่าการดำเนินการนั้นถูกต้องและตรงกับความตั้งใจของคุณ