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

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

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

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

หากต้องการดูข้อมูลเกี่ยวกับแนวคิดหลักและประโยชน์ของเซิร์ฟเวอร์ MCP ระยะไกลของ Google โปรดดูภาพรวมเซิร์ฟเวอร์ MCP ของ Google Cloud

ข้อมูลอ้างอิงของเครื่องมือ

เครื่องมือต่อไปนี้พร้อมใช้งานสำหรับเซิร์ฟเวอร์ MCP ของ Google Classroom

• list_courses
• list_course_work_submissions
• get_course_work
• create_course_work
• update_course_work
• list_course_work_submissions
• list_topics
• create_topic
• list_announcement_summaries
• get_announcements
• create_announcement
• get_course_work_rubric
• create_course_work_rubric
• get_course_roster
• get_guardian_info
• search_course_standards

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

• การเป็นสมาชิกในโปรแกรมเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Google Workspace

• โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์

• โฮสต์ MCP เช่น Google Antigravity

• ชั้นเรียน Google Classroom สำหรับทดสอบที่มีบัญชีนักเรียนทดสอบอย่างน้อย 1 บัญชี หากไม่มีชั้นเรียน Google Classroom ที่ใช้ทดสอบได้ ให้สร้างชั้นเรียนใน UI และเพิ่มนักเรียนทดสอบ

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

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

เปิดใช้บริการ MCP และ API ของ Google Classroom

1. เปิดใช้ Google Classroom API ในโปรเจ็กต์ Google Cloud โดยทำดังนี้

   เปิดใช้ API

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

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

ตั้งค่าหน้าจอขอความยินยอม OAuth

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

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

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

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

   1. ในส่วน App Information ให้พิมพ์ Classroom 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 Cloud

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

      • https://www.googleapis.com/auth/classroom.announcements
      • https://www.googleapis.com/auth/classroom.courses.readonly

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขยายฟังก์ชันการทำงานด้วยเซิร์ฟเวอร์เพิ่มเติม

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

สำหรับ Google Classroom โดยเฉพาะ การกำหนดค่าเซิร์ฟเวอร์ MCP ของ Google ไดรฟ์จะมีประโยชน์อย่างยิ่งสำหรับการทำงานกับไฟล์แนบ

การแก้ปัญหา

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

ตรวจสอบเหตุการณ์ในบันทึกของ 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 ให้ทำดังนี้

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

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

ทำตามแนวทางปฏิบัติแนะนำต่อไปนี้

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

ความคิดเห็น

แชร์ความคิดเห็นเกี่ยวกับเซิร์ฟเวอร์ MCP ของ Google Classroom ในเครื่องมือติดตามปัญหาแบบสาธารณะ

หัวข้อที่เกี่ยวข้อง

• กำหนดค่าความปลอดภัยสำหรับเซิร์ฟเวอร์ MCP ของ Google Workspace
• เซิร์ฟเวอร์ MCP ของ Google Workspace ใน Antigravity (Codelab)
• รายชื่อเซิร์ฟเวอร์ MCP ของ Google Workspace