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

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

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

  • อ่านข้อมูล: ค้นหาอีเมล ดึงข้อมูลไฟล์ และแสดงรายการกิจกรรมในปฏิทิน
  • ดำเนินการ: สร้างอีเมลฉบับร่าง อัปโหลดไฟล์ และกำหนดเวลาการประชุม
  • เคารพความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูลแบบเดียวกับผู้ใช้

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

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

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

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Workspace คุณต้องเปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

  • Gmail API
  • Google Drive API
  • Google Docs API
  • Google Sheets API
  • Google Slides API
  • Google Calendar API
  • Google Chat API
  • People API

  • Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

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

คอนโซล

เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้ API

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

หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับผลิตภัณฑ์ Google Workspace แต่ละรายการ คุณต้องเปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ Google Cloud

  • Gmail MCP API
  • Google Drive MCP API
  • Google Docs MCP API
  • Google Sheets MCP API
  • Google Slides MCP API
  • Google Calendar MCP API
  • Google Chat MCP API
  • People MCP API

  • Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

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

คอนโซล

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

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

กำหนดค่าแอปใน Chat

หากต้องการใช้เซิร์ฟเวอร์ MCP ของ Google Chat คุณต้องกำหนดค่าแอป Chat ในโปรเจ็กต์ Google Cloud

  1. ในคอนโซล Google Cloud ให้ค้นหา Google Chat API แล้วคลิก Google Chat API > จัดการ > การกำหนดค่า

    ไปที่ Google Chat API

  2. ตั้งค่าแอป Chat โดยทำดังนี้

    1. ในช่องชื่อแอป ให้ป้อน Chat MCP
    2. ในช่อง Avatar URL ให้ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. ในคำอธิบาย ให้ป้อน Chat MCP server
    4. ในส่วนฟังก์ชันการทำงาน ให้ปิดฟีเจอร์แบบอินเทอร์แอกทีฟโดยสลับเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟเป็นปิด
    5. ในส่วนบันทึก ให้เลือกบันทึกข้อผิดพลาดไปยัง Logging

  3. คลิกบันทึก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างแอปใน Chat ได้ที่หัวข้อเลือกสถาปัตยกรรมแอป Google Chat

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

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

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

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

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

  3. คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ Google Cloud

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

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google ไดรฟ์:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • Google เอกสาร:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • Google ชีต:
        • 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
      • Google สไลด์:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • Google ปฏิทิน:
        • https://www.googleapis.com/auth/calendar.calendarlist.readonly
        • https://www.googleapis.com/auth/calendar.events.freebusy
        • https://www.googleapis.com/auth/calendar.events.readonly
      • Google Chat:
        • https://www.googleapis.com/auth/chat.spaces.readonly
        • https://www.googleapis.com/auth/chat.memberships.readonly
        • https://www.googleapis.com/auth/chat.messages.readonly
        • https://www.googleapis.com/auth/chat.messages.create
        • https://www.googleapis.com/auth/chat.users.readstate
        • https://www.googleapis.com/auth/chat.users.spacesettings
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly

    2. คลิกเพิ่มลงในตาราง

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

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

กำหนดค่าไคลเอ็นต์ MCP

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ลงในไคลเอ็นต์ MCP ให้ทำตามวิธีการสำหรับไคลเอ็นต์ของคุณ

รหัสไคลเอ็นต์ OAuth 2.0 ที่ผู้ใช้มอบสิทธิ์ซึ่งเรียกใช้เซิร์ฟเวอร์ MCP ของ Google Workspace ต้องเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ในแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > ไคลเอ็นต์ หากต้องการอัปเดตรหัสไคลเอ็นต์ OAuth 2.0 ที่มีอยู่ ให้เลือกการตั้งค่านี้ใน Google Auth Platform > Clients ตามที่อธิบายไว้ในหัวข้อจัดการไคลเอ็นต์ OAuth หากคุณเปลี่ยนการตั้งค่านี้ในไคลเอ็นต์ที่มีอยู่ไม่ได้ หรือหากไคลเอ็นต์รองรับฟีเจอร์ที่ไม่ใช่ Agent ด้วย ให้สร้างรหัสไคลเอ็นต์ OAuth 2.0 ใหม่สำหรับ AI Agent สำหรับคำขอที่ถูกปฏิเสธ บัญชีบริการที่มีการมอบสิทธิ์ทั่วทั้งโดเมน หรือ Google Apps Script โปรดดูหัวข้อการแก้ปัญหา

Antigravity

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ลงใน 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. คลิก Create แล้วคัดลอก Client ID และ รหัสลับไคลเอ็นต์

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

  3. เพิ่มการกำหนดค่า mcpServers ลงใน mcp_config.json ดังนี้

    {
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.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. สำหรับเซิร์ฟเวอร์แต่ละรายการที่แสดง (gmail, drive, docs, sheets, slides, calendar, chat, people และ classroom) ให้คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้บัญชี Google คัดลอกรหัสการให้สิทธิ์ วางลงในกล่องโต้ตอบการป้อนข้อมูล แล้วคลิกส่ง

    • สำหรับ Antigravity CLI

      1. เริ่ม Antigravity CLI:

        agy

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

        /mcp

      3. ตรวจสอบสิทธิ์เซิร์ฟเวอร์ MCP แต่ละรายการโดยทำดังนี้

        1. ใช้ปุ่มลูกศรเพื่อเลือกเซิร์ฟเวอร์ ย้ายไปที่การดำเนินการตรวจสอบสิทธิ์ แล้วกด Enter ทำตามขั้นตอนการลงชื่อเข้าใช้ในเบราว์เซอร์ให้เสร็จสมบูรณ์ คัดลอกรหัสการให้สิทธิ์ วางลงในพรอมต์เทอร์มินัล แล้วกด Enter
        2. ทำขั้นตอนเหล่านี้ซ้ำกับเซิร์ฟเวอร์แต่ละรายการที่คุณกำหนดค่า (gmail, drive, docs, sheets, slides, calendar, chat, people และ classroom)

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

    • สำหรับ Antigravity IDE หรือ GUI: ปุ่มออกจากระบบจะแสดงข้างเซิร์ฟเวอร์แต่ละรายการในส่วนการปรับแต่ง > เซิร์ฟเวอร์ MCP ที่ติดตั้ง
    • สำหรับ Antigravity CLI: เปิดแผง /mcp เพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ เซิร์ฟเวอร์ที่ได้รับการยืนยันและตรวจสอบสิทธิ์แล้วจะแสดงตรวจสอบสิทธิ์แล้วข้างชื่อภายในแผง TUI แบบอินเทอร์แอกทีฟ คุณสามารถเลือกเซิร์ฟเวอร์ใดก็ได้ในมุมมองแดชบอร์ดเพื่อตรวจสอบสถานะและแสดงรายการเครื่องมือทั้งหมดที่มีอยู่

เซิร์ฟเวอร์ MCP ระยะไกลพร้อมใช้งานใน Antigravity แล้ว

Claude

หากต้องการใช้เซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace กับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ลงใน 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. คลิก Create แล้วคัดลอก Client ID และ รหัสลับไคลเอ็นต์

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

    1. ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า > เครื่องมือเชื่อมต่อ หรือการตั้งค่าของผู้ดูแลระบบ > เครื่องมือเชื่อมต่อ
    2. คลิกเพิ่มเครื่องมือเชื่อมต่อที่กำหนดเอง

    3. ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ Google Workspace ที่ต้องการเพิ่ม ดังนี้

      • ชื่อเซิร์ฟเวอร์: ชื่อเซิร์ฟเวอร์ เช่น Gmail
      • URL ของเซิร์ฟเวอร์ MCP ระยะไกล: URL ของผลิตภัณฑ์ Google Workspace เช่น รายการใดรายการหนึ่งต่อไปนี้
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google ไดรฟ์: https://drivemcp.googleapis.com/mcp/v1
        • Google เอกสาร: https://docsmcp.googleapis.com/mcp/v1
        • Google ชีต: https://sheetsmcp.googleapis.com/mcp/v1
        • Google สไลด์: https://slidesmcp.googleapis.com/mcp/v1
        • Google ปฏิทิน: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

    4. ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth

    5. คลิกเพิ่ม

    6. ทำขั้นตอนเหล่านี้ซ้ำสำหรับผลิตภัณฑ์ Google Workspace แต่ละรายการที่ต้องการเพิ่ม

อื่นๆ

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

  • ชื่อเซิร์ฟเวอร์: googleworkspace

  • เซิร์ฟเวอร์: ผลิตภัณฑ์ Google Workspace แต่ละรายการมี URL ของเซิร์ฟเวอร์ของตนเอง ดังนี้

    • Gmail: https://gmailmcp.googleapis.com/mcp/v1
    • Google ไดรฟ์: https://drivemcp.googleapis.com/mcp/v1
    • Google เอกสาร: https://docsmcp.googleapis.com/mcp/v1
    • Google ชีต: https://sheetsmcp.googleapis.com/mcp/v1
    • Google สไลด์: https://slidesmcp.googleapis.com/mcp/v1
    • Google ปฏิทิน: https://calendarmcp.googleapis.com/mcp/v1
    • Google Chat: https://chatmcp.googleapis.com/mcp/v1
    • People API: https://people.googleapis.com/mcp/v1
    • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

  • การส่งข้อมูล: HTTP ที่สตรีมได้

  • การตรวจสอบสิทธิ์: เซิร์ฟเวอร์ MCP ระยะไกลของ Google Workspace ใช้ OAuth 2.0 เมื่อสร้างไคลเอ็นต์ OAuth 2.0 ให้เลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ AI ดูรายละเอียดได้ที่หัวข้อดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์

    ไคลเอ็นต์ MCP ต้องใช้โทเค็นการรีเฟรชเพื่อป้องกันไม่ให้ผู้ใช้ต้องลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเฉพาะเมื่อคำขอการให้สิทธิ์มี access_type=offline การขอเฉพาะขอบเขต offline_access ของ OpenID Connect (OIDC) จะไม่แสดงผลลัพธ์ใดๆ หากไคลเอ็นต์ MCP รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง ให้เพิ่ม access_type=offline ลงในคำขอให้สิทธิ์ หากต้องการรับโทเค็นการรีเฟรชใหม่สำหรับผู้ใช้ที่ให้สิทธิ์เข้าถึงแล้ว ให้เพิ่ม prompt=consent ด้วย หากไคลเอ็นต์ MCP ไม่รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง ผู้ใช้จะต้องลงชื่อเข้าใช้อีกครั้งทุกครั้งที่โทเค็นเพื่อการเข้าถึงหมดอายุ โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง

ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเชื่อมต่อไคลเอ็นต์ประเภทต่างๆ ได้ที่หัวข้อกำหนดค่า MCP ในแอปพลิเคชัน AI

เพิ่มเซิร์ฟเวอร์ MCP ของ Developer Knowledge

เซิร์ฟเวอร์ MCP สำหรับความรู้ของนักพัฒนาซอฟต์แวร์เป็นเซิร์ฟเวอร์ระยะไกลที่ค้นหาเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์อย่างเป็นทางการของ Google แบบเรียลไทม์ ซึ่งรวมถึง developers.google.com/workspace เพื่อให้ AI Agent ของคุณสามารถค้นหาวิธีการ API, ขอบเขต OAuth และตัวอย่างโค้ดปัจจุบันได้ แทนที่จะพึ่งพาเฉพาะข้อมูลฝึกฝน เซิร์ฟเวอร์นี้มีเครื่องมือ search_documents, get_documents และ answer_query และเสริมการทำงานของเซิร์ฟเวอร์ MCP ของ Google Workspace ซึ่งช่วยให้ Agent ดำเนินการกับข้อมูล Google Workspace ได้ การเพิ่มเซิร์ฟเวอร์ MCP ของ Developer Knowledge ควบคู่ไปด้วยจะช่วยให้ Agent ตอบคำถามเกี่ยวกับการสร้างด้วย Google Workspace API จากเอกสารประกอบปัจจุบันได้

หากต้องการเพิ่มเซิร์ฟเวอร์นี้ลงในแอปพลิเคชัน AI ให้ทำตามขั้นตอนกำหนดค่า IDE หรือเอเจนต์การเขียนโค้ด แล้วเลือกไคลเอ็นต์ หากต้องการช่วยให้ Agent ตัดสินใจได้ว่าควรค้นหาเอกสารประกอบเมื่อใดและควรใช้เครื่องมือใด ให้ติดตั้งทักษะ Agent ของ retrieving-developer-knowledge ด้วย

ทดสอบเซิร์ฟเวอร์ MCP ของ Google Workspace

หลังจากกำหนดค่าไคลเอ็นต์ MCP แล้ว คุณสามารถยืนยันการเชื่อมต่อได้โดยเรียกใช้พรอมต์ทดสอบบางรายการ

ลองถามคำถามต่อไปนี้กับไคลเอ็นต์ MCP

  • "Ariel พูดว่าอะไรในอีเมลฉบับล่าสุดเกี่ยวกับแผนการตลาดของเรา"

    ไคลเอ็นต์จะกรองอีเมลจาก Ariel โดยใช้ gmail.search_threads ดึงเนื้อหาของชุดข้อความล่าสุดด้วย gmail.get_thread แล้วสรุปให้คุณ

  • "ร่างอีเมลถึง ariel@example.com เพื่อแจ้งว่าฉันอนุมัติแผนการตลาดแล้ว"

    ไคลเอ็นต์จะใช้ gmail.create_draft เพื่อสร้างอีเมลในโฟลเดอร์ฉบับร่าง ซึ่งช่วยให้คุณตรวจสอบและส่งอีเมลจาก Gmail ได้

  • "สรุปไฟล์แผนการตลาด"

    ไคลเอ็นต์จะเรียกใช้ drive.search_files เพื่อค้นหา "แผนการตลาด" จากนั้นใช้ drive.read_file_content เพื่อดึงข้อมูลและสรุปเนื้อหา

  • "แสดงเนื้อหาเชิงโครงสร้างของบันทึกการประชุมใน Google เอกสาร"

    ไคลเอ็นต์จะดึงโครงสร้างและเนื้อหาของเอกสารโดยใช้ docs.read_doc

  • "อ่านแผ่นงาน Sheet1 จาก Google ชีตยอดขายรายไตรมาส"

    ไคลเอ็นต์จะดึงค่าตารางกริดโดยใช้ sheets.get_values

  • "แสดงเลย์เอาต์ที่อธิบายด้วยคำพูดของงานนำเสนอใน Google สไลด์ชื่อภาพรวมผลิตภัณฑ์"

    ไคลเอ็นต์จะดึงโครงสร้างเลย์เอาต์ภาพของงานนำเสนอโดยใช้ slides.read_presentation

  • "ฉันจะประชุมกับ Ariel ครั้งถัดไปเมื่อไร"

    ลูกค้าตรวจสอบกำหนดการของคุณโดยใช้ calendar.list_events และให้รายละเอียดการประชุมครั้งถัดไปกับ Ariel

  • "ฉันชื่ออะไรตามโปรไฟล์ Google"

    ไคลเอ็นต์จะใช้ people.get_user_profile เพื่อดึงข้อมูลโปรไฟล์ Google Workspace ของคุณ

  • "ตอนนี้ฉันสอนชั้นเรียนอะไรอยู่"

    ไคลเอ็นต์จะตรวจสอบกำหนดการของคุณโดยใช้ classroom.list_course_summaries และสรุปหลักสูตรที่ใช้งานอยู่ซึ่งคุณมีบทบาทเป็นครู

  • "ร่างประกาศเกี่ยวกับการทัศนศึกษาที่กำลังจะมาถึงสำหรับชั้นเรียนธรณีวิทยาของฉัน"

    ไคลเอ็นต์จะใช้ classroom.create_announcement เพื่อร่างประกาศ ซึ่งคุณสามารถตรวจสอบและโพสต์ในแอป Google Classroom ได้

  • "ตรวจสอบเอกสาร Google Workspace อย่างเป็นทางการเพื่อดูขอบเขต OAuth ที่เครื่องมือ Gmail create_draft ต้องใช้ จากนั้นร่างอีเมลถึง ariel@example.com เพื่อยืนยันแผนการตลาด"

    หากคุณเพิ่มเซิร์ฟเวอร์ MCP ของ Developer Knowledge ไคลเอ็นต์จะเรียกใช้ search_documents เพื่อค้นหาขอบเขตในเอกสารอ้างอิง MCP ของ Gmail จากนั้นใช้ gmail.create_draft เพื่อสร้างฉบับร่าง

หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ MCP ของ Google Workspace ได้รับการกำหนดค่าอย่างถูกต้อง

การแก้ปัญหา

ใช้ส่วนต่อไปนี้เพื่อแก้ไขปัญหาการตรวจสอบสิทธิ์และการเชื่อมต่อที่พบบ่อยกับเซิร์ฟเวอร์ MCP ของ Google Workspace

ตรวจสอบเหตุการณ์ในบันทึกของ 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 คุณจะไม่สามารถเลือกใช้ไคลเอ็นต์นี้สำหรับ Agent ที่ทำงานด้วยระบบ 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 จะไม่ได้รับผลกระทบ

ข้อความแจ้งให้ลงชื่อเข้าใช้ซ้ำทุกชั่วโมง

หากระบบแจ้งให้คุณลงชื่อเข้าใช้อีกครั้งทุกๆ ชั่วโมง แสดงว่าไคลเอ็นต์ MCP ไม่ได้รับโทเค็นการรีเฟรช เซิร์ฟเวอร์ OAuth 2.0 ของ Google จะออกโทเค็นการรีเฟรชเฉพาะเมื่อคำขอการให้สิทธิ์มี access_type=offline การขอเฉพาะขอบเขต offline_access ของ OIDC จะไม่แสดงผลรหัสผู้ใช้

ตรวจสอบว่าไคลเอ็นต์ MCP ของคุณรองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเองหรือไม่ โดยทำดังนี้

  • ไคลเอ็นต์รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง: เพิ่ม access_type=offline ลงในคำขอการให้สิทธิ์ หากต้องการรับโทเค็นการรีเฟรชใหม่สำหรับผู้ใช้ที่ให้สิทธิ์เข้าถึงแล้ว ให้เพิ่ม prompt=consent ด้วย
  • ไคลเอ็นต์ไม่รองรับพารามิเตอร์การให้สิทธิ์ที่กำหนดเอง: ลงชื่อเข้าใช้อีกครั้งทุกครั้งที่โทเค็นเพื่อการเข้าถึงหมดอายุ

โปรดดูรายละเอียดที่หัวข้อรีเฟรชโทเค็นเพื่อการเข้าถึง

ผลิตภัณฑ์ที่รองรับ

ผลิตภัณฑ์ Google Workspace ต่อไปนี้รองรับเซิร์ฟเวอร์ MCP ของ Google Workspace และมีเครื่องมือต่อไปนี้

ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม

เมื่อคุณแสดงโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ อาจมีความเสี่ยงที่จะเกิดการโจมตีแบบแทรกพรอมต์โดยอ้อม เนื่องจากไคลเอ็นต์ MCP เช่น Google Antigravity มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ MCP ของ Google Workspace ไคลเอ็นต์จึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ของคุณได้

โปรดทำตามแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อลดความเสี่ยงเหล่านี้

  • ใช้เฉพาะเครื่องมือที่เชื่อถือได้ อย่าเชื่อมต่อเซิร์ฟเวอร์ MCP ของ Google Workspace กับแอปพลิเคชันที่ไม่น่าเชื่อถือหรือไม่ได้รับการยืนยัน
  • โปรดระมัดระวังอินพุตที่ไม่น่าเชื่อถือ หลีกเลี่ยงการขอให้ไคลเอ็นต์ MCP ประมวลผลอีเมล เอกสาร หรือแหล่งข้อมูลอื่นๆ จากแหล่งที่มาที่ไม่ได้รับการยืนยัน ข้อมูลเหล่านี้อาจมีคำสั่งที่ซ่อนอยู่ซึ่งสามารถลักลอบใช้เซสชันของคุณ ทำให้ผู้โจมตีสามารถแก้ไข ขโมย หรือลบข้อมูลของคุณได้
  • ตรวจสอบการดำเนินการทั้งหมด โปรดตรวจสอบการดำเนินการที่ไคลเอ็นต์ AI ทำในนามของคุณอย่างละเอียดทุกครั้งเพื่อให้แน่ใจว่าถูกต้องและสอดคล้องกับความตั้งใจของคุณ