教育中心管理系統 MCP 工具

以 EducationCenter 真實 MCP manifest 及 CMS workflow 文件整理,覆蓋學生、課程、班別、報名、出席、補堂、發票、付款證明、收款記錄、教學資源、通告、學生事件及請假審批流程。

education_center.list_students

read

按 search、school、gender、status、record_state 分頁查詢學生。

建議先讀取

治理與審批

只讀,不建立 action request。

安全說明

列表要 bounded pagination,不可一次 dump 全部學生資料。

education_center.get_student

read

讀取學生 profile、overview、events、已派發資源與通告。

建議先讀取

education_center.list_students

治理與審批

只讀,不建立 action request。

安全說明

後續 student-centric assign/event write 應以此狀態為準。

education_center.list_courses

read

列出課程供班別、報名及 invoice flow 使用。

建議先讀取

治理與審批

只讀,不建立 action request。

安全說明

保留 record_state 概念,避免 archived 課程被誤用。

education_center.list_classes

read

列出班別,可按 course_id、active_only、record_state 篩選。

建議先讀取

education_center.list_courses

治理與審批

只讀,不建立 action request。

安全說明

報名、attendance、invoice 前先確認班別仍 active 及容量合理。

education_center.list_enrollments

read

按 student、class、course 查詢報名紀錄。

建議先讀取

education_center.get_student 或 education_center.list_classes

治理與審批

只讀,不建立 action request。

安全說明

invoice 和 default lessons 應以真實 enrollment 狀態為基礎。

education_center.get_attendance_sheet

read

按日期、班別、導師及 unmarked filter 讀取 attendance sheet。

建議先讀取

education_center.list_classes

治理與審批

只讀,不建立 action request。

安全說明

attendance write 必須用讀取到的 lesson identifier。

education_center.list_invoices

read

查詢 cashier / student detail invoice summary rows。

建議先讀取

education_center.get_student 或 filters

治理與審批

只讀,不建立 action request。

安全說明

列表只作 summary;要 lessons/payments 明細需 get_invoice。

education_center.get_invoice

read

讀取單一 invoice、student、lessons、payments、draft payload。

建議先讀取

education_center.list_invoices

治理與審批

只讀,不建立 action request。

安全說明

update_invoice 或 payment write 前必須先讀取當前 invoice。

education_center.preview_invoice_default_lessons

read

由 backend preview invoice default lessons,集中 charge_type 規則。

建議先讀取

education_center.list_enrollments + education_center.list_classes

治理與審批

只讀 preview,不建立 action request。

安全說明

create/update invoice 必須提交 explicit lessons[];不要讓 write 自行重算。

education_center.list_invoice_reminders

read

讀取基於 remaining lessons 的 invoice reminders。

建議先讀取

education_center.list_invoices

治理與審批

只讀,不建立 action request。

安全說明

reminder 建議要核對 invoice 狀態及剩餘堂數。

education_center.list_payment_proofs

read

按 search、status 查詢付款證明。

建議先讀取

education_center.list_invoices

治理與審批

只讀,不建立 action request。

安全說明

review 前要 get_payment_proof 檢查 invoice/student/payment detail。

education_center.get_payment_proof

read

讀取單一付款證明、invoice、student、review 及 applied payment detail。

建議先讀取

education_center.list_payment_proofs

治理與審批

只讀,不建立 action request。

安全說明

apply/reject 前必須確認未重複套用、金額與 invoice 一致。

education_center.list_payment_records

read

查詢收款記錄 summary 及 invoice payment status aggregates。

建議先讀取

education_center.list_invoices

治理與審批

只讀,不建立 action request。

安全說明

payment-records 是獨立 domain,不應只當 invoice 附件。

education_center.list_resources

read

查詢 learning resources。

建議先讀取

治理與審批

只讀,不建立 action request。

安全說明

派發前應 get_resource 查看 assignments。

education_center.get_resource

read

讀取單一 learning resource 及 current assignments。

建議先讀取

education_center.list_resources

治理與審批

只讀,不建立 action request。

安全說明

assign/unassign 必須用此狀態避免重複或錯派。

education_center.list_notices

read

查詢 notices。

建議先讀取

治理與審批

只讀,不建立 action request。

安全說明

通告派發前應讀 get_notice 及目標學生範圍。

education_center.get_notice

read

讀取單一 notice 及 assignments。

建議先讀取

education_center.list_notices

治理與審批

只讀,不建立 action request。

安全說明

更新或派發前確認 audience、attachments、read receipts 影響。

education_center.list_student_events

read

列出指定學生事件。

建議先讀取

education_center.get_student

治理與審批

只讀,不建立 action request。

安全說明

event write 要保持 student-centric,唔好跨學生誤寫。

education_center.list_leave_requests

read

列出請假申請,支援 review workflow。

建議先讀取

education_center.get_attendance_sheet 或 filters

治理與審批

只讀,不建立 action request。

安全說明

請假會影響 attendance / makeup,審批前要讀 detail。

education_center.get_leave_request

read

讀取單一請假申請、linked lesson 及 review context。

建議先讀取

education_center.list_leave_requests

治理與審批

只讀,不建立 action request。

安全說明

approve makeup 前確認補堂日期與時間,避免同 reschedule 衝突。

education_center.update_attendance

write

更新單一 lesson attendance action。

建議先讀取

education_center.get_attendance_sheet

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

只用 canonical attendance action;不要直接改 lesson row。

education_center.bulk_update_attendance

write

批量更新多個 lessons 的 attendance action。

建議先讀取

education_center.get_attendance_sheet

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

lesson identifiers 必須來自同一次受控讀取;避免跨 scope 混入。

education_center.reschedule_lesson

write

調堂,只更新 makeup_date、makeup_start_time、makeup_end_time。

建議先讀取

education_center.get_attendance_sheet

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

不可同時改班別、導師、課室或原堂時間。

education_center.create_student_event

write

在 student-centric flow 建立一筆 student event。

建議先讀取

education_center.get_student

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

備註欄位用 event_remark,因 remark 是 MCP governance 欄位。

education_center.update_student_event

write

更新一筆 student event。

建議先讀取

education_center.list_student_events

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

event_id 必須屬於該 student;備註欄位用 event_remark。

education_center.delete_student_event

write

刪除一筆 student event。

建議先讀取

education_center.list_student_events

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

刪除前確認 event_id 與學生一致。

education_center.apply_payment_proof

write

批核並套用一筆付款證明,建立或對應 payment。

建議先讀取

education_center.get_payment_proof

治理與審批

高風險 review write,應保留 approval/audit metadata。

安全說明

確認金額、invoice、student、未重複套用後先執行。

education_center.reject_payment_proof

write

拒絕一筆付款證明,不建立 payment。

建議先讀取

education_center.get_payment_proof

治理與審批

高風險 review write,應保留 approval/audit metadata。

安全說明

拒絕原因應清楚,避免家長 follow-up 無上下文。

education_center.approve_leave_request_no_makeup

write

批准請假但不安排補堂。

建議先讀取

education_center.get_leave_request

治理與審批

高風險 review write,影響 attendance。

安全說明

確認 no-makeup 是業務決策,不應由 agent 默認選擇。

education_center.approve_leave_request_makeup

write

批准請假並安排補堂日期。

建議先讀取

education_center.get_leave_request

治理與審批

高風險 review write,影響 attendance / makeup。

安全說明

補堂欄位要同現有 makeup/reschedule contract 一致。

education_center.reject_leave_request

write

拒絕請假申請。

建議先讀取

education_center.get_leave_request

治理與審批

高風險 review write,應保留 approval/audit metadata。

安全說明

拒絕前確認 linked lesson 及原因,避免錯誤通知家長。

education_center.create_student

write

用 canonical setup student flow 建立學生。

建議先讀取

education_center.list_students

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

建立前先搜尋避免重複學生/家長資料。

education_center.update_student

write

用 canonical setup student flow 更新學生。

建議先讀取

education_center.get_student

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

更新前確認 student_id 及 record_state,避免改 archived record。

education_center.create_enrollment

write

用 setup enrollment flow 建立報名。

建議先讀取

education_center.get_student + education_center.list_classes

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

建立前檢查班別容量、重複報名及收費設定。

education_center.create_invoice

write

用 canonical invoice flow 建立 invoice;is_draft 控制草稿狀態。

建議先讀取

education_center.preview_invoice_default_lessons

治理與審批

受治理寫入;cashier write 應保留 audit metadata。

安全說明

lessons[] 必填且 explicit;不要使用隱式 default。

education_center.update_invoice

write

用 canonical invoice flow 更新 invoice;lessons[] 仍需 explicit。

建議先讀取

education_center.get_invoice + education_center.preview_invoice_default_lessons

治理與審批

受治理寫入;cashier write 應保留 audit metadata。

安全說明

更新前比較現有 payments/draft 狀態,避免覆蓋付款資料。

education_center.add_invoice_payment

write

為 existing invoice append payment,是日常收款 canonical path。

建議先讀取

education_center.get_invoice

治理與審批

受治理寫入;cashier payment write。

安全說明

新增收款前核對 outstanding amount 及 payment method。

education_center.replace_invoice_payments

write

整批覆蓋 invoice payment list,用於行政修正。

建議先讀取

education_center.get_invoice

治理與審批

高風險覆蓋式 cashier write。

安全說明

非日常收款 path;只在明確需要 full overwrite 時使用。

education_center.upsert_resource_item

write

建立或更新 learning_resource / notice,支援 body、source、attachments。

建議先讀取

education_center.get_resource 或 education_center.get_notice

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

type 必須正確;resource_id 存在代表更新,省略代表建立。

education_center.delete_resource_item

write

用 shared resource backend flow archive learning_resource 或 notice。

建議先讀取

education_center.get_resource 或 education_center.get_notice

治理與審批

受治理寫入;delete/archive 類操作應保留 audit。

安全說明

刪除前確認 assignments、attachments、read receipts 影響。

education_center.assign_resource

write

用 shared assignment flow 派發 learning_resource 或 notice;支援 is_all_students。

建議先讀取

education_center.get_resource / get_notice + education_center.list_students

治理與審批

受治理寫入;bulk all-students 屬高影響操作。

安全說明

type、target student 或 is_all_students 必須明確,不可同時含糊。

education_center.unassign_resource

write

用 shared assignment flow 取消學生特定 resource/notice assignment。

建議先讀取

education_center.get_resource 或 education_center.get_notice

治理與審批

受治理寫入;可能 executed 或 pending_approval。

安全說明

assignment 必須來自讀取結果;不要自行猜 assignment id。