Tool Surface
Halaman ini merangkum kelompok tool yang tersedia di Etalasse MCP server. Tool disusun berbentuk tugas (task-shaped) — bukan cerminan satu-per-satu dari REST endpoint — agar input lebih sederhana, ekspektasi autentikasi jelas, dan nama tool tetap stabil meskipun rute backend berubah.
Untuk melihat daftar lengkap dan terkini pada lingkungan Anda, panggil tools/list dari klien Anda, atau buka MCP Console di Ruang Kerja AI.
Konvensi penamaan
Nama tool memakai pola kelompok.aksi, misalnya catalog.list_products atau orders.update_status. Kelompok baca umumnya menyediakan list dan get; kelompok tulis menambahkan create, update, dan delete.
Kelompok tool
System dan autentikasi
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| System | system.ping | Uji konektivitas dan kesehatan server. |
| Dashboard auth | auth.dashboard_login, auth.dashboard_refresh | Login manual Dashboard dan pembaruan sesi (fallback ketika OAuth tidak dipakai), termasuk penggantian kata sandi. |
Katalog (baca dan tulis)
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Shop dan katalog publik | shop.get_by_username, catalog.list_products | Pencarian toko dan daftar produk publik; dapat diakses tanpa sesi dashboard. |
| Manajemen produk | catalog.create_product, catalog.update_product, catalog.list_variants, catalog.create_product_image | CRUD produk, varian, dan gambar produk. |
| Ulasan produk | reviews.list, reviews.summary, reviews.reported, reviews.hide, reviews.reply, reviews.bulk_moderate | Kotak masuk ulasan (filter status, bintang, foto, dilaporkan, belum dibalas), ringkasan, ulasan yang dilaporkan, serta setujui, tolak, sembunyikan, tampilkan lagi, balas, sematkan, abaikan laporan, dan pengaturan persetujuan. Balasan dan aksi massal baru dikirim setelah merchant mengonfirmasi. Lihat Ulasan Produk. |
| Cross-sell | cross_sell.get_product, cross_sell.suggestions, cross_sell.set_links, cross_sell.settings, cross_sell.performance | Produk kurasi dan usulan otomatis per produk, mengatur atau mengurutkan ulang produk kurasi (dengan konfirmasi sebelum menimpa daftar), pengaturan, dan hasil cross-sell. Lihat Cross-sell. |
| Kategori dan add-on | product_categories.create, addons.list, product_addons.overwrite_for_product | Kategori produk, add-on beserta detailnya, dan pemetaan add-on ke produk. |
| Aset digital | catalog.create_digital_asset, catalog.list_digital_assets | Pengelolaan aset digital yang dijual sebagai produk. |
Pesanan dan pelanggan
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Orders | orders.list, orders.get, orders.update_status | Membaca pesanan dan memperbarui statusnya. |
| Customers | customers.list, customers.create | Data pelanggan toko, termasuk CRUD. |
Laporan dan analitik
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Analytics | analytics.get_sales_overview | Ringkasan performa penjualan. |
| Reports | reports.get_sales_performance, reports.get_product_performance, reports.get_inventory_report | Laporan penjualan, produk, pelanggan, operasional, pembayaran, inventori, promosi, dan pengiriman. |
| Analitik toko online | storefront_analytics.report, storefront_analytics.products, storefront_analytics.sources | Kunjungan, corong belanja, tren, produk teratas, sumber trafik (termasuk UTM dan tautan Marketing Center), perangkat, dan pencarian di toko online. Hanya baca; riwayat mengikuti paket. |
Piutang pelanggan, webhook, dan dapur
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Piutang: baca | credit.list_accounts, credit.get_account, credit.get_statement, credit.list_receivables, credit.get_receivable, credit.list_payments, credit.get_aging, credit.get_outstanding, credit.get_collections, credit.get_summary, credit.get_settings | Akun kredit, rekening koran, tagihan, pembayaran, umur piutang, dan ringkasan. Hanya baca. Lihat Piutang Pelanggan. |
| Piutang: ubah | credit.create_account, credit.update_account, credit.preview_payment, credit.record_payment, credit.write_off, credit.remind_customer | Buka dan ubah akun, catat pembayaran yang sudah diterima (wajib confirmedAmount, aman diulang dengan requestId yang sama), hapus piutang dengan alasan, dan kirim pengingat. Meminta konfirmasi merchant lebih dulu. |
| Webhook: baca | webhooks.get_meta, webhooks.list, webhooks.get, webhooks.list_deliveries, webhooks.get_delivery, webhooks.list_events | Katalog event, endpoint, dan log pengiriman. Rahasia penandatanganan tidak pernah ditampilkan ulang. |
| Webhook: ubah | webhooks.create, webhooks.update, webhooks.delete, webhooks.rotate_secret, webhooks.test, webhooks.redeliver, webhooks.replay_event | Kelola endpoint dengan konfirmasi lebih dulu. Rahasia hanya muncul sekali pada respons buat dan rotasi. Lihat Webhook. |
| Dapur: baca | kitchen.list_stations, kitchen.get_routing, kitchen.get_queue, kitchen.get_ticket, kitchen.prep_time_report | Stasiun, rute, antrean tiket, dan laporan waktu persiapan. Hanya baca. Lihat Stasiun Dapur. |
| Dapur: ubah | kitchen.create_station, kitchen.set_routing, kitchen.bulk_set_status, kitchen.void, kitchen.set_item_status, kitchen.recall, kitchen.set_rush | Pengaturan stasiun, rute, bump massal, dan batalkan item meminta konfirmasi; bump satu item atau tiket, recall, dan rush tidak. Status dapur tidak mengubah status pesanan. |
2FA dan sesi hanya lewat Dashboard
Tool MCP sengaja tidak ada untuk mengaktifkan, menonaktifkan, atau melewati 2FA, maupun untuk membaca atau mengatur ulang sesi dan kode pemulihan. Semuanya hanya bisa dilakukan di Dashboard (Pengaturan > Keamanan). Akun pemilik dengan 2FA tidak bisa masuk lewat auth.dashboard_login dengan email dan kata sandi; gunakan token akses pribadi atau OAuth.
Bundling, referral, komisi staf, dan label
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Bundling: baca | bundles.list, bundles.get, bundles.preview, bundles.sale_lines | Bundle dengan stok hitungan, hemat, margin, dan item pembatas; pratinjau tidak menulis apa pun; isi bundle pada pesanan. Hanya baca. Lihat Paket Bundling. |
| Bundling: ubah | bundles.create, bundles.update | Membuat dan mengubah bundle. Jalankan pratinjau lebih dulu dan minta konfirmasi (confirmed). Merakit, membongkar, menyegarkan harga, dan menghapus ada di Dashboard. |
| Referral: baca | referral.get_settings, referral.list, referral.flagged_queue, referral.get, referral.report_summary, referral.top_referrers, referral.get_program, referral.resolve_code | Pengaturan, referral, antrean tinjauan, laporan corong, pengajak teratas, dan syarat program serta pengecekan kode (publik; pengecekan kode dihitung sebagai satu klik di corong). |
| Referral: ubah | referral.update_settings, referral.approve, referral.reject, referral.reverse | Mengubah janji dan biaya hadiah, menyetujui, menolak, atau menarik hadiah. Meminta konfirmasi merchant lebih dulu. Kode, undangan, dan klaim pelanggan bukan tool MCP. |
| Komisi staf: baca | staff_commission.get_settings, staff_commission.summary, staff_commission.ledger, staff_commission.list_payouts | Aturan, ringkasan, buku komisi, dan riwayat pembayaran. Hanya baca. |
| Komisi staf: ubah | staff_commission.update_settings, staff_commission.update_staff_rules, staff_commission.record_payout | Mengubah aturan (konfirmasi) dan mencatat pembayaran yang sudah dilakukan (wajib confirmedAmount yang sama dengan hitungan server; angka yang berubah dijawab AMOUNT_CHANGED). |
| Label dan harga beli | labels.list_templates, labels.preview, labels.render_data, ingredients.last_purchase | Templat, kesiapan cetak, data label, dan harga beli terakhir. Hanya baca; membuat barcode dan mencetak ada di Dashboard dan POS. |
PIN staf, perangkat POS, dan 2FA hanya lewat Dashboard
Tool MCP sengaja tidak ada untuk mengatur atau mengatur ulang PIN staf, membuat kode pendaftaran perangkat, mendaftarkan atau mencabut perangkat POS, membuka kunci PIN, mengubah pengaturan PIN, maupun 2FA merchant atau operator. Semuanya membuat atau menetralkan kredensial masuk, jadi hanya bisa dilakukan di Dashboard.
Booking
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Booking | booking.list_sessions, booking.create_session, booking.create_blocked_date | Sesi booking dan tanggal yang diblokir. |
| Booking: baca | booking.list_bookings, booking.get_booking, booking.get_calendar, booking.get_availability, booking.list_staff, booking.get_staff, booking.get_settings, booking.get_report | Booking menurut staf dan tanggal, detail dan uang booking, kalender per staf, slot kosong, staf dan jadwalnya, kebijakan, dan laporan tidak datang dan DP. Hanya baca. |
| Booking: ubah | booking.reschedule, booking.mark_no_show, booking.collect_balance, booking.update_service, booking.set_staff_hours, booking.add_staff_time_off | Jadwal ulang, tandai tidak datang, catat pelunasan, durasi dan DP layanan, jadwal dan cuti staf. Meminta konfirmasi merchant lebih dulu (confirmed). |
Promosi dan retensi
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Flash sales | flash_sales.create, flash_sales.overwrite_details | Flash sale beserta detail produknya. |
| Kupon | coupons.list, coupons.create | Kode kupon dan aturannya. |
| Loyalitas | memberships.create, membership_rewards.list, point_rewards.create, challenge_rewards.list | Membership, reward membership, reward poin, dan reward tantangan. |
Keuangan
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Withdrawals | withdrawals.create, withdrawals.get_current_balance, withdrawals.approve, withdrawals.pay | Penarikan dana: pengajuan, saldo berjalan, persetujuan, pembayaran, dan penolakan. |
| Pembayaran dan pengiriman | payment_methods.create, bank_accounts.list, payments.toggle_active, deliveries.update_fee | Metode pembayaran, rekening bank, serta pengaturan aktif/biaya kanal pembayaran dan pengiriman. |
Konten dan storefront
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Konfigurasi toko | shop.get_config, shop.update | Membaca dan memperbarui pengaturan toko. |
| Konten | banner.create, blogs.create, blog_categories.list, faqs.create | Banner, blog, kategori blog, dan FAQ storefront. |
| Link dan katalog toko | shop_links.create, shop_catalogs.list | Tautan toko (Etalasse Link) dan katalog toko. |
| Shipping options | shipping_options.create | Opsi pengiriman toko. |
F&B
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| F&B | fnb_sales.create, fnb_tables.list_operational | Penjualan F&B dan manajemen meja, termasuk status operasional meja. |
Inventori dan stok
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Stok | stocks.list, stock_in.create, stock_out.create, stock_return.create | Stok berjalan serta mutasi stok masuk, keluar, hilang, retur, penggantian, dan penjualan stok. |
| Penyesuaian stok | stock_adjustments.list, stock_adjustments.create, stock_adjustments.bulk_create, stock_adjustments.report | Riwayat penyesuaian stok, mencatat penyesuaian (satu atau massal, dengan alasan), daftar alasan, dan laporan kehilangan stok. Menggantikan stock_lost.*, stock_return.*, dan stock_replacement.* yang kini usang. |
| Stok opname | stock_opnames.list, stock_opnames.get, stock_opnames.lines, stock_opnames.review | Membaca sesi stok opname, baris hitungan, dan pratinjau selisih sebelum diselesaikan. Hanya baca. |
| Inventori dan pemasok | inventory.create, suppliers.list | Master inventori dan data pemasok. |
Multivendor dan staf
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Resellers | resellers.create, resellers.list | Mitra yang menjualkan kembali produk Anda. |
| Sellers | sellers.list, sellers.approve, sellers.balance, sellers.ledger, reports.sellers, seller_withdrawals.list | Vendor toko multivendor: persetujuan dan status seller, saldo, buku saldo, laporan, dan pencairan dana. |
| Staffs | staffs.create, staffs.list | Akun staf toko. |
Notifikasi
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Notifications | notifications.list, notifications.mark_as_read, notifications.mark_all_as_read | Notifikasi dashboard beserta penandaan telah dibaca. |
Alur pelanggan dan tamu (storefront)
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Auth pelanggan | auth.customer_login, auth.customer_login_whatsapp, guest.create_session | Login pelanggan (termasuk via WhatsApp) dan sesi tamu. |
| Keranjang | cart.get_customer_cart, cart.add_guest_item, cart.update_customer_item | Membaca dan mengubah isi keranjang pelanggan maupun tamu. |
| Checkout dan pesanan | orders.create_customer_order, orders.create_guest_order, orders.cancel_customer_order | Membuat, melihat, dan membatalkan pesanan pelanggan/tamu. |
Pemenuhan aset digital
| Kelompok | Contoh tool | Deskripsi |
|---|---|---|
| Digital fulfillment | orders.get_customer_digital_assets, orders.access_guest_digital_asset | Daftar dan akses aset digital dari pesanan pelanggan maupun tamu. |
Aturan autentikasi per kelompok
- Tool publik (misalnya
shop.get_by_username,catalog.list_products) dapat dipanggil tanpa sesi dashboard dan menerima identitas toko secara eksplisit. - Tool dashboard/admin memerlukan sesi terautentikasi (OAuth atau login manual) dan selalu beroperasi pada toko milik pengguna yang terautentikasi.
- Tool pelanggan/tamu memakai sesi pelanggan atau sesi tamu yang dibuat melalui tool auth storefront.