Daftar sekarang dan coba semua fitur Cucimoo gratis 14 hari. Daftar gratis
MCPPaket Premium & Enterprise

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.

Tersedia di paket Premium dan Enterprise
Koneksi MCP memakai API Key, yang dibuat pemilik bisnis lewat Pengaturan → API Key di aplikasi. Bisnis yang sedang masa uji coba Premium juga bisa langsung mencobanya.

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. 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. 2

    Tambahkan Cucimoo di aplikasi AI Anda

    Alamat server MCP Cucimoo:

    https://cucimoo.id/mcp

    Ganti ck_live_xxxxxxxxxxxxxxxx di bawah dengan key Anda.

    Claude Code

    Jalankan di terminal.

    Claude Code
    claude 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. 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_profileBisnis yang terhubung, paket, izin key, dan daftar cabang. AI memanggil ini lebih dulu.
Daftar cabanglist_branchesCabang beserta kode, alamat, zona waktu, dan jumlah staf.
Daftar layananlist_servicesDaftar harga layanan per cabang.
Daftar staflist_staffNama-nama staf yang bisa ditandai pada transaksi.
Daftar pelangganlist_customersCari pelanggan lewat nama, nomor HP, atau pelat kendaraan.
Detail pelangganget_customerData pelanggan, kendaraan, riwayat cuci terakhir, dan membership-nya.
Daftar transaksilist_transactionsTransaksi dengan filter cabang, tanggal, staf, metode bayar, beserta total pendapatannya.
Detail transaksiget_transactionRincian satu transaksi: layanan, staf, diskon, pajak, pembayaran.
Ringkasan laporanget_report_summaryPendapatan, tren harian, layanan terlaris, kinerja staf, dan pengeluaran.
Daftar sesi kasirlist_shiftsRiwayat sesi kasir beserta rekap dan selisih uang tunai.
Sesi kasir berjalanget_current_shiftSesi kasir yang sedang buka di satu cabang.
Daftar pengeluaranlist_expensesPengeluaran operasional beserta total per kategori.
Daftar membershiplist_membershipsPelanggan pemegang membership dan paket yang ditawarkan.
Program loyaltiget_loyaltyAturan stempel/poin dan pelanggan yang punya saldo.

Mencatat data Perlu izin Ubah data

Tambah pelanggancreate_customerMenambahkan pelanggan baru, sekaligus kendaraannya.
Catat transaksicreate_transactionMencatat transaksi cuci seperti di kasir — harga, diskon, dan loyalti dihitung server.
Catat pengeluarancreate_expenseMencatat 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

Endpointhttps://cucimoo.id/mcp
TransportStreamable HTTP, stateless — setiap request POST dijawab langsung sebagai JSON, tanpa session id. GET dijawab 405.
AuthenticationHeader 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 toolJSON dengan envelope yang sama dengan API: { data } atau { data, meta }. Nominal dalam rupiah, waktu dalam ISO 8601 UTC.
ErrorHasil tool dengan isError: true, berisi status, pesan berbahasa Indonesia, dan error code yang sama dengan API (misalnya VALIDATION_FAILED, FORBIDDEN).
Memastikan koneksi bekerja
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":{}}'

Pertanyaan umum