Kết nối trực tiếp các AI Agent bên ngoài (Claude Desktop, Cursor IDE, n8n, AI Agent độc lập) với hệ sinh thái Cơm Ngon để tự động tra cứu báo cáo, đặt cơm, và quản lý nhân sự qua giao thức chuẩn hóa.
Cách AI Agent giao tiếp với Cơm Ngon
Claude Desktop, Cursor IDE, hệ thống n8n hoặc AI Agent tự phát triển gửi lệnh hội thoại tự nhiên của người dùng.
Vận hành trực tiếp trên máy chủ đám mây Vercel qua endpoint https://comngon.io.vn/api/mcp, xác thực đa tổ chức (Multi-tenant) qua API Key và gọi hàm SSOT.
Đọc/ghi dữ liệu suất ăn, lịch làm việc, danh sách phòng ban và bảo vệ an toàn bằng Row-Level Security (RLS).
Chọn nền tảng AI bạn đang sử dụng để xem cấu hình mẫu
{
"mcpServers": {
"com-ngon": {
"url": "https://comngon.io.vn/api/mcp",
"headers": {
"x-api-key": "sk_live_YOUR_API_KEY"
}
}
}
}https://comngon.io.vn/api/mcp mà KHÔNG cần tải mã nguồn hay cài đặt Node.js trên máy tính của bạn.sk_live_... gắn vào header x-api-key.Tất cả các công cụ đều có tham số được xác thực nghiêm ngặt bằng Zod schema
get_meal_statisticsTra cứu SSOTTra cứu số liệu thống kê suất ăn tổng hợp chuẩn Single Source of Truth (tổng suất ăn, lượt nghỉ, khách, tỷ lệ hủy, chi phí, tiền tiết kiệm) cho một tháng cụ thể hoặc khoảng ngày bất kỳ.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| start_date | string (optional) | Ngày bắt đầu YYYY-MM-DD (VD: 2026-08-01) |
| end_date | string (optional) | Ngày kết thúc YYYY-MM-DD (VD: 2026-08-31) |
| month | number (optional) | Tháng cần tra cứu (1 - 12) |
| year | number (optional) | Năm cần tra cứu (VD: 2026) |
get_meal_statistics({ month: 8, year: 2026 })BÁO CÁO SUẤT ĂN CƠM NGON (2026-08-01 → 2026-08-31): - Tổng suất ăn: 1.391 suất - Suất khách: 0 suất - Tổng lượt nghỉ ăn: 345 lượt - Số ngày bếp nấu: 23 ngày - Tỷ lệ hủy/nghỉ: 19.9%
get_today_summaryHôm nay RealtimeLấy dữ liệu tổng quan số lượng suất ăn hôm nay theo thời gian thực (số người ăn, nghỉ ăn, suất khách, trạng thái bếp nấu).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|
get_today_summary({})☀️ THỐNG KÊ HÔM NAY (2026-09-03): - Trạng thái bếp: Bếp đang nấu ăn 🍳 - Tổng suất ăn dự kiến: 73 suất - Số người báo nghỉ: 9 người - Suất khách đăng ký: 0 suất
get_employees_listNhân sựLấy danh sách nhân viên trong doanh nghiệp. Hỗ trợ tìm kiếm theo tên, email, mã nhân viên, lọc theo phòng ban và trạng thái.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| search | string (optional) | Từ khóa tìm kiếm theo họ tên, email hoặc mã nhân viên |
| department | string (optional) | Lọc theo phòng ban (VD: Marketing) |
| status | enum (optional) | "active" | "paused" | "resigned" | "all" |
| limit | number (optional) | Số lượng tối đa cần lấy (mặc định 50) |
get_employees_list({ search: "Hải", department: "Ban Giám Đốc" })Tìm thấy 1 nhân sự: 1. Thân Công Hải (haibn@vietvisiontravel.com) - Mã: NV001 - Phòng: Ban Giám Đốc [active]
get_employee_detailHồ sơ nhân sựXem thông tin chi tiết một nhân viên (họ tên, email, mã NV, phòng ban, chức vụ, trạng thái làm việc) và lịch sử đăng ký cơm 7 ngày gần nhất.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| query | string (required) | Họ tên, email hoặc mã nhân viên cần tra cứu chi tiết |
get_employee_detail({ query: "Thân Công Hải" })👤 THÔNG TIN CHI TIẾT NHÂN VIÊN: - Họ và tên: Thân Công Hải - Email: haibn@vietvisiontravel.com - Mã nhân viên: NV001 - Phòng ban: Ban Giám Đốc - Chức vụ: admin - Trạng thái: Đang làm việc 🟢 📅 LỊCH SỬ ĐĂNG KÝ CƠM GẦN ĐÂY: • 2026-09-03: ✅ ĂN CƠM • 2026-09-02: ❌ BÁO NGHỈ (Lý do: Đi gặp đối tác)
get_kitchen_overviewVận hành bếpTra cứu tổng quan vận hành bếp: số suất cần nấu hôm nay hoặc một ngày cụ thể, chi tiết suất ăn chính và suất khách.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (optional) | Ngày cần kiểm tra YYYY-MM-DD (mặc định hôm nay) |
get_kitchen_overview({ date: "2026-09-03" })🍳 TỔNG QUAN BẾP ĂN NGÀY 2026-09-03: - Trạng thái bếp: Đang nấu ăn - Số suất ăn chính thức: 73 suất - Suất khách đặc biệt: 0 suất - TỔNG CẦN NẤU: 73 suất
get_daily_order_detailsChi tiết suất ănXem danh sách chi tiết ai đăng ký ăn cơm và ai báo nghỉ ăn vào một ngày cụ thể, kèm theo lý do báo nghỉ.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (optional) | Ngày cần xem định dạng YYYY-MM-DD |
get_daily_order_details({ date: "2026-09-03" })📋 DANH SÁCH CHI TIẾT SUẤT ĂN NGÀY 2026-09-03: - Ăn cơm: 73 người - Báo nghỉ: 9 người 🔴 DANH SÁCH BÁO NGHỈ: 1. Nguyễn Văn A [Sale] - Lý do: Đi tour Hạ Long 2. Trần Thị B [Kế toán] - Lý do: Làm việc tại nhà
get_guest_meals_listSuất kháchTra cứu danh sách các đoàn khách đăng ký ăn cơm theo ngày hoặc theo tháng (số lượng suất khách, ghi chú đoàn khách).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (optional) | Ngày cụ thể YYYY-MM-DD |
| month | number (optional) | Tháng cần lọc |
| year | number (optional) | Năm cần lọc |
get_guest_meals_list({ month: 9, year: 2026 })🍽️ DANH SÁCH SUẤT ĂN KHÁCH ĐOÀN (1 lượt - Tổng: 5 suất): 1. [ID: abc-123] Ngày 2026-09-05: 5 suất - Ghi chú: "Đoàn đối tác Nhật Bản"
get_cooking_scheduleLịch nấu bếpTra cứu lịch hoạt động của bếp ăn trong tháng (những ngày nào bếp nấu ăn, ngày nào bếp nghỉ, ngày lễ và ngày ngoại lệ nấu thêm).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| month | number (optional) | Tháng cần tra cứu (1 - 12) |
| year | number (optional) | Năm cần tra cứu |
get_cooking_schedule({ month: 9, year: 2026 })📅 LỊCH VẬN HÀNH BẾP THÁNG 9/2026: - Lịch nấu mặc định: Thứ 2 đến Thứ 6 hàng tuần. ⚠️ CÁC NGÀY NGOẠI LỆ: • 2026-09-02: 🏖️ BẾP NGHỈ ĐỘT XUẤT/LỄ - Lý do: Quốc Khánh 2/9
get_departments_listPhòng banTra cứu danh sách tất cả các phòng ban trong công ty và số lượng nhân sự trực thuộc từng phòng ban.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|
get_departments_list({})🏢 DANH SÁCH PHÒNG BAN (6 phòng - Tổng 102 nhân sự): 1. Khối Kinh Doanh: 45 nhân sự 2. Khối Điều Hành Tour: 28 nhân sự 3. Kế Toán & Tài Chính: 12 nhân sự
get_announcementsThông báoXem danh sách các thông báo mới nhất từ Ban quản lý hoặc Bếp gửi tới toàn thể công ty.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| limit | number (optional) | Số lượng thông báo cần lấy (mặc định 5) |
get_announcements({ limit: 3 })📢 THÔNG BÁO MỚI NHẤT: 1. [URGENT] Thông báo thực đơn đặc biệt Thứ 6 tuần này: Bếp phục vụ bún chả Hà Nội.
update_meal_registrationNghiệp vụ ănCập nhật trực tiếp trạng thái suất ăn của một nhân viên vào một ngày nhất định (đăng ký ăn hoặc hủy cơm).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employee_email_or_code | string (required) | Email, mã nhân viên hoặc họ tên |
| date | string (required) | Ngày áp dụng YYYY-MM-DD |
| status | enum (required) | "eating" (ăn cơm) hoặc "not_eating" (hủy cơm) |
| reason | string (optional) | Lý do thay đổi |
update_meal_registration({ employee_email_or_code: "Thân Công Hải", date: "2026-09-04", status: "not_eating", reason: "Đi công tác" })"✅ Đã cập nhật suất ăn ngày 2026-09-04 cho Thân Công Hải: NGHỈ ĂN."
batch_update_meal_registrationNghiệp vụ ănĐăng ký ăn hoặc báo nghỉ cơm cho NHIỀU nhân viên cùng lúc vào một ngày cụ thể.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employee_list | array (required) | Danh sách họ tên, email hoặc mã nhân viên |
| date | string (required) | Ngày áp dụng YYYY-MM-DD |
| status | enum (required) | "eating" hoặc "not_eating" |
| reason | string (optional) | Lý do |
batch_update_meal_registration({ employee_list: ["NV001", "NV002"], date: "2026-09-04", status: "not_eating" })"📋 KẾT QUẢ CẬP NHẬT HÀNG LOẠT NGÀY 2026-09-04: ✅ Thân Công Hải: Nghỉ ăn ✅ Nguyễn Văn B: Nghỉ ăn"
add_guest_mealsNghiệp vụ bếpThêm suất ăn cho khách hoặc đối tác phát sinh vào một ngày cụ thể kèm ghi chú.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (required) | Ngày phục vụ khách YYYY-MM-DD |
| quantity | number (required) | Số lượng suất ăn cần thêm |
| note | string (optional) | Ghi chú đoàn khách |
add_guest_meals({ date: "2026-09-05", quantity: 5, note: "Đoàn đối tác Nhật Bản" })"✅ Đã ghi nhận thêm 5 suất khách cho ngày 2026-09-05 [Mã đơn: d123-456]."
delete_guest_mealsNghiệp vụ bếpHủy/xóa một đơn suất ăn khách đoàn đã đăng ký trước đó theo mã ID đơn.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| guest_meal_id | string (required) | Mã UUID của đơn khách đoàn |
delete_guest_meals({ guest_meal_id: "d123-456" })"✅ Đã hủy/xóa thành công đơn suất ăn khách đoàn [ID: d123-456]."
create_employeeNhân sựThêm mới một nhân viên vào hệ thống công ty.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| full_name | string (required) | Họ và tên đầy đủ |
| string (required) | Email đăng nhập | |
| employee_code | string (optional) | Mã nhân viên |
| department | string (optional) | Phòng ban |
create_employee({ full_name: "Lê Văn C", email: "c@company.com", department: "Kinh Doanh" })"✅ Đã thêm mới nhân viên thành công: Lê Văn C (c@company.com)."
update_employee_statusNhân sựThay đổi trạng thái hoạt động nhân viên (active = đang làm việc, paused = tạm dừng cơm, resigned = đã nghỉ việc).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employee_query | string (required) | Họ tên, email hoặc mã nhân viên |
| status | enum (required) | "active" | "paused" | "resigned" |
update_employee_status({ employee_query: "Lê Văn C", status: "paused" })"✅ Đã cập nhật trạng thái nhân viên Lê Văn C thành: [paused]."
set_cooking_exceptionLịch bếpCài đặt ngày ngoại lệ nấu ăn cho bếp (no_cook = bếp nghỉ đột xuất/nghỉ lễ, extra_cook = nấu thêm vào ngày nghỉ cuối tuần).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (required) | Ngày áp dụng YYYY-MM-DD |
| exception_type | enum (required) | "no_cook" | "extra_cook" |
| reason | string (optional) | Lý do ngoại lệ |
set_cooking_exception({ date: "2026-09-02", exception_type: "no_cook", reason: "Nghỉ lễ Quốc Khánh 2/9" })"✅ Đã cập nhật ngoại lệ nấu ăn ngày 2026-09-02: BẾP NGHỈ."
delete_cooking_exceptionLịch bếpXóa một ngày ngoại lệ nấu ăn của bếp để khôi phục lại lịch nấu ăn mặc định.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| date | string (required) | Ngày ngoại lệ cần xóa YYYY-MM-DD |
delete_cooking_exception({ date: "2026-09-02" })"✅ Đã xóa ngày ngoại lệ 2026-09-02. Lịch nấu của bếp trở lại bình thường."
send_announcementThông báoĐăng thông báo mới từ Quản trị viên hoặc Bếp gửi đến toàn thể nhân viên trong công ty.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| title | string (required) | Tiêu đề thông báo |
| content | string (required) | Nội dung chi tiết thông báo |
| priority | enum (optional) | "normal" | "urgent" | "info" |
send_announcement({ title: "Đổi giờ ăn trưa", content: "Hôm nay giờ ăn bắt đầu lúc 11h45", priority: "urgent" })"📢 Đã gửi thông báo mới thành công! - Tiêu đề: Đổi giờ ăn trưa"
update_employee_profileNhân sựChỉnh sửa toàn diện hồ sơ nhân sự: họ tên, phòng ban, mã NV, chức vụ (role), chế độ ăn mặc định (eating/not_eating), ghi chú.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employee_query | string (required) | Email, mã NV hoặc họ tên |
| full_name | string (optional) | Họ và tên mới |
| department | string (optional) | Phòng ban mới |
| employee_code | string (optional) | Mã nhân viên |
| default_meal_status | enum (optional) | "eating" | "not_eating" |
| role | enum (optional) | "employee" | "kitchen_admin" | "manager" |
update_employee_profile({ employee_query: "c@company.com", department: "Phòng Marketing", role: "manager" })"✅ Đã cập nhật hồ sơ nhân sự thành công: Lê Văn C - Phòng Marketing - Quyền: manager"
delete_employeeNhân sựXóa nhân viên khỏi hệ thống hoặc đánh dấu nghỉ việc (resigned).
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employee_query | string (required) | Email, mã NV hoặc họ tên |
| permanent | boolean (optional) | true: Xóa hẳn, false: Đánh dấu nghỉ việc (mặc định false) |
delete_employee({ employee_query: "c@company.com", permanent: false })"👋 Đã đánh dấu nhân viên Lê Văn C là ĐÃ NGHỈ VIỆC [resigned]."
batch_create_employeesNhân sựThêm danh sách nhiều nhân viên mới vào hệ thống công ty cùng lúc.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| employees | array (required) | Mảng các đối tượng [{ full_name, email, department, employee_code }] |
batch_create_employees({ employees: [{ full_name: "Nguyễn A", email: "a@co.com" }, { full_name: "Trần B", email: "b@co.com" }] })"👥 KẾT QUẢ THÊM NHÂN SỰ HÀNG LOẠT (2/2 thành công)..."
delete_announcementThông báoGỡ bỏ hoặc hủy một thông báo đã đăng trước đó theo mã ID.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| announcement_id | string (required) | Mã UUID của thông báo |
delete_announcement({ announcement_id: "8c35b5a2-..." })"🗑️ Đã xóa thành công thông báo [ID: 8c35b5a2-...]."
update_company_settingsHệ thốngCập nhật cấu hình công ty: giờ chốt đăng ký cơm (HH:MM), giờ tự động reset và ngày nấu trong tuần.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| registration_deadline | string (optional) | Giờ chốt cơm (HH:MM) |
| auto_reset_time | string (optional) | Giờ tự động reset cơm ngày mai (HH:MM) |
| start_cooking_day | number (optional) | Thứ bắt đầu nấu (1=Thứ 2, ..., 6=Thứ 7) |
| end_cooking_day | number (optional) | Thứ kết thúc nấu (5=Thứ 6, 6=Thứ 7) |
update_company_settings({ registration_deadline: "09:00", auto_reset_time: "13:30" })"⚙️ ĐÃ CẬP NHẬT CẤU HÌNH VẬN HÀNH THÀNH CÔNG..."
trigger_daily_meal_resetHệ thốngKích hoạt lệnh tự động khởi tạo / reset đơn cơm cho ngày mai theo chế độ mặc định của nhân sự.
| Tên tham số | Kiểu dữ liệu | Mô tả & Chú thích |
|---|---|---|
| target_date | string (optional) | Ngày cần reset YYYY-MM-DD (mặc định ngày mai) |
trigger_daily_meal_reset({ target_date: "2026-09-05" })"🔄 ĐÃ ĐỒNG BỘ ĐƠN CƠM CHO NGÀY 2026-09-05: 102 người, 95 đơn..."