Hubungkan asisten AI ke Cucimoo
MCP (Model Context Protocol) adalah standar terbuka yang membuat asisten AI — seperti Claude, Cursor, atau GitHub Copilot — bisa tersambung dengan aplikasi lain secara aman. Setelah terhubung, Anda cukup bertanya dengan bahasa sehari-hari, dan AI akan mengambil sendiri data yang dibutuhkan dari Cucimoo untuk menjawabnya.
Bayangkan seperti memberi AI akses baca ke buku kas usaha Anda: ia bisa merangkum pendapatan, mencari pelanggan, membandingkan cabang, bahkan mencatat transaksi atas perintah Anda — dengan aturan harga, diskon, dan loyalti yang sama persis dengan aplikasi Cucimoo.
Contoh pemakaian
Beberapa hal yang bisa langsung Anda tanyakan atau perintahkan:
- “Berapa pendapatan cabang Margonda minggu ini dibanding minggu lalu?”
- “Layanan apa yang paling laris bulan ini, dan siapa staf yang paling banyak mengerjakannya?”
- “Siapa saja pelanggan yang membership-nya habis dalam 7 hari ke depan?”
- “Catat cuci mobil biasa untuk pelat B 1234 XYZ, dikerjakan Agus, bayar tunai.”
- “Catat pengeluaran beli sabun Rp85.000 dari laci kasir cabang utama.”
Cara menghubungkan
- 1
Buat API Key
Masuk ke aplikasi Cucimoo sebagai pemilik, buka Pengaturan → API Key, lalu buat key baru. Pilih Baca data bila AI hanya untuk bertanya, atau tambahkan Ubah data bila AI juga boleh mencatat. Salin key-nya — key hanya ditampilkan satu kali.
- 2
Tambahkan Cucimoo di aplikasi AI Anda
Alamat server MCP Cucimoo:
https://cucimoo.id/mcpGanti
ck_live_xxxxxxxxxxxxxxxxdi bawah dengan key Anda.Claude Code
Jalankan di terminal.
Claude Codeclaude mcp add --transport http cucimoo https://cucimoo.id/mcp \ --header "X-Api-Key: ck_live_xxxxxxxxxxxxxxxx"
Cursor
Tambahkan ke ~/.cursor/mcp.json (atau .cursor/mcp.json di proyek).
Cursor{ "mcpServers": { "cucimoo": { "url": "https://cucimoo.id/mcp", "headers": { "X-Api-Key": "ck_live_xxxxxxxxxxxxxxxx" } } } }VS Code (GitHub Copilot)
Tambahkan ke .vscode/mcp.json. VS Code akan meminta key saat pertama dipakai dan menyimpannya dengan aman.
VS Code (GitHub Copilot){ "inputs": [ { "type": "promptString", "id": "cucimoo-key", "description": "API Key Cucimoo", "password": true } ], "servers": { "cucimoo": { "type": "http", "url": "https://cucimoo.id/mcp", "headers": { "X-Api-Key": "${input:cucimoo-key}" } } } }Claude Desktop
Tambahkan ke claude_desktop_config.json (Settings → Developer → Edit Config). Membutuhkan Node.js; mcp-remote menjembatani aplikasi ke server Cucimoo.
Claude Desktop{ "mcpServers": { "cucimoo": { "command": "npx", "args": [ "-y", "mcp-remote", "https://cucimoo.id/mcp", "--header", "X-Api-Key:${CUCIMOO_API_KEY}" ], "env": { "CUCIMOO_API_KEY": "ck_live_xxxxxxxxxxxxxxxx" } } } } - 3
Mulai bertanya
Muat ulang aplikasi AI, pastikan server cucimoo aktif, lalu coba tanyakan “Ringkas penjualan saya 7 hari terakhir.”
Tools yang tersedia
Tool adalah kemampuan yang ditawarkan Cucimoo kepada AI. AI memilih sendiri tool yang dibutuhkan untuk menjawab pertanyaan Anda.
Membaca data
Profil bisnisget_business_profile | Bisnis yang terhubung, paket, izin key, dan daftar cabang. AI memanggil ini lebih dulu. |
|---|---|
Daftar cabanglist_branches | Cabang beserta kode, alamat, zona waktu, dan jumlah staf. |
Daftar layananlist_services | Daftar harga layanan per cabang. |
Daftar staflist_staff | Nama-nama staf yang bisa ditandai pada transaksi. |
Daftar pelangganlist_customers | Cari pelanggan lewat nama, nomor HP, atau pelat kendaraan. |
Detail pelangganget_customer | Data pelanggan, kendaraan, riwayat cuci terakhir, dan membership-nya. |
Daftar transaksilist_transactions | Transaksi dengan filter cabang, tanggal, staf, metode bayar, beserta total pendapatannya. |
Detail transaksiget_transaction | Rincian satu transaksi: layanan, staf, diskon, pajak, pembayaran. |
Ringkasan laporanget_report_summary | Pendapatan, tren harian, layanan terlaris, kinerja staf, dan pengeluaran. |
Daftar sesi kasirlist_shifts | Riwayat sesi kasir beserta rekap dan selisih uang tunai. |
Sesi kasir berjalanget_current_shift | Sesi kasir yang sedang buka di satu cabang. |
Daftar pengeluaranlist_expenses | Pengeluaran operasional beserta total per kategori. |
Daftar membershiplist_memberships | Pelanggan pemegang membership dan paket yang ditawarkan. |
Program loyaltiget_loyalty | Aturan stempel/poin dan pelanggan yang punya saldo. |
Mencatat data Perlu izin Ubah data
Tambah pelanggancreate_customer | Menambahkan pelanggan baru, sekaligus kendaraannya. |
|---|---|
Catat transaksicreate_transaction | Mencatat transaksi cuci seperti di kasir — harga, diskon, dan loyalti dihitung server. |
Catat pengeluarancreate_expense | Mencatat pengeluaran operasional cabang. |
Keamanan & izin
- Key dengan izin Baca data hanya melihat tool baca. Tool pencatatan tidak ditawarkan kepadanya, dan ditolak bila tetap dipanggil.
- AI tidak bisa mengubah, menghapus, atau membatalkan data apa pun — hanya membaca dan menambah.
- Semua aturan aplikasi tetap berlaku: harga dari daftar layanan, diskon membership, loyalti, pajak, sesi kasir, dan batas paket.
- Key bertindak setara pemilik dan menjangkau seluruh cabang. Simpan seperti kata sandi, dan cabut di Pengaturan → API Key bila tidak dipakai lagi atau dicurigai bocor.
- Aplikasi AI biasanya meminta persetujuan sebelum menjalankan tool pencatatan. Periksa rinciannya sebelum menyetujui.
Detail teknis
| Endpoint | https://cucimoo.id/mcp |
|---|---|
| Transport | Streamable HTTP, stateless — setiap request POST dijawab langsung sebagai JSON, tanpa session id. GET dijawab 405. |
| Authentication | Header X-Api-Key, format yang sama dengan API Integrasi. Tanpa key: 401 dengan header WWW-Authenticate. Paket tanpa Akses AI (MCP): 402 PLAN_REQUIRED. |
| Hasil tool | JSON dengan envelope yang sama dengan API: { data } atau { data, meta }. Nominal dalam rupiah, waktu dalam ISO 8601 UTC. |
| Error | Hasil tool dengan isError: true, berisi status, pesan berbahasa Indonesia, dan error code yang sama dengan API (misalnya VALIDATION_FAILED, FORBIDDEN). |
curl -X POST https://cucimoo.id/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'X-Api-Key: ck_live_xxxxxxxxxxxxxxxx' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'