Panduan Lengkap

Tutorial Penggunaan

Tidak perlu install server. Hubungkan Claude, Cursor, Windsurf, atau Cline ke ngaturbisnis MCP dan langsung kelola bisnis F&B lewat percakapan. Ada dua cara autentikasi — OAuth otomatis via browser (direkomendasikan untuk Claude Desktop & Claude Code) atau API Key manual (untuk semua tool termasuk Cursor, Windsurf & Cline).

Estimasi: 3 menit setup
6 bagian tutorial
01

Pilih Metode Autentikasi

Tidak perlu install apapun di sisi server. Pilih metode yang sesuai dengan AI tool Anda.

🔐
Metode A: OAuth — Login Otomatis
⭐ Direkomendasikan · Claude Desktop & Claude Code

Tidak perlu buat atau copy-paste token. Claude Desktop / Claude Code akan membuka browser login otomatis saat pertama kali terkoneksi. Token diperbarui otomatis setiap 1 jam.

1

Tambahkan config MCP tanpa header Authorization — lihat tab Claude Desktop atau Claude Code di Langkah 2.

2

Restart AI Anda. Saat tool pertama kali dipanggil, browser akan terbuka ke halaman login ngaturbisnis.com.

3

Login lalu klik Izinkan Akses. Selesai — AI langsung terkoneksi tanpa perlu simpan token di config.

🔑
Metode B: API Key Manual (Bearer Token)
Untuk Cursor · Windsurf · Cline · atau sebagai fallback
1
Login ke ngaturbisnis.com

Pastikan sudah punya akun aktif dengan role owner atau admin keuangan.

2
Buka menu API Key di sidebar

Klik API Key di sidebar kiri → klik "Buat API Key Baru" → isi label perangkat → submit.

3
Salin token yang muncul

Token hanya tampil sekali. Salin sekarang dan pakai di config AI Anda (tab Cursor / Windsurf / Cline di Langkah 2).

Penting: Jika lupa menyalin, revoke token tersebut dan buat yang baru. Maksimal 5 token aktif per akun.
02

Hubungkan ke AI Anda

Pilih AI yang Anda gunakan. Semua mendukung MCP protocol — satu config, langsung aktif.

1
Buka folder konfigurasi Claude

Tekan Cmd+Space, ketik Terminal, dan jalankan:

open ~/Library/Application\ Support/Claude/
2
Buka atau buat file claude_desktop_config.json
⭐ Metode OAuth (Direkomendasikan): Config di bawah tidak perlu token. Saat pertama konek, browser akan terbuka untuk login otomatis ke ngaturbisnis.com.
{ "mcpServers": { "ngaturbisnis": { "type": "http", "url": "https://mcp.ngaturbisnis.com/api/mcp" } } }
Atau gunakan API Key manual (Bearer Token) ›
{ "mcpServers": { "ngaturbisnis": { "type": "http", "url": "https://mcp.ngaturbisnis.com/api/mcp", "headers": { "Authorization": "Bearer TOKEN_ANDA" } } } }
1
Buka folder konfigurasi Claude

Tekan Win+R, paste path berikut dan tekan Enter:

%APPDATA%\Claude
2
Edit atau buat claude_desktop_config.json
⭐ Metode OAuth (Direkomendasikan): Config di bawah tidak perlu token. Saat pertama konek, browser akan terbuka untuk login otomatis ke ngaturbisnis.com.
{ "mcpServers": { "ngaturbisnis": { "type": "http", "url": "https://mcp.ngaturbisnis.com/api/mcp" } } }
Atau gunakan API Key manual (Bearer Token) ›
{ "mcpServers": { "ngaturbisnis": { "type": "http", "url": "https://mcp.ngaturbisnis.com/api/mcp", "headers": { "Authorization": "Bearer TOKEN_ANDA" } } } }
1
Claude Code (semua platform) — jalankan di terminal
⭐ Metode OAuth (Direkomendasikan): Jalankan perintah di bawah tanpa --header. Saat pertama kali dipakai, browser terbuka untuk login otomatis.
claude mcp add ngaturbisnis --transport http \ https://mcp.ngaturbisnis.com/api/mcp
Atau gunakan API Key manual (Bearer Token) ›
claude mcp add ngaturbisnis --transport http \ https://mcp.ngaturbisnis.com/api/mcp \ --header "Authorization: Bearer TOKEN_ANDA"
1
Buka Cursor Settings

Klik ikon gear → pilih "Cursor Settings" → cari "MCP"

2
Klik "Add new MCP server" atau edit ~/.cursor/mcp.json (Mac/Linux) / %APPDATA%\Cursor\mcp.json (Windows)

Gunakan API Key dari Langkah 1 (Metode B) dan paste sebagai Bearer Token:

{ "mcpServers": { "ngaturbisnis": { "url": "https://mcp.ngaturbisnis.com/api/mcp", "headers": { "Authorization": "Bearer TOKEN_ANDA" } } } }

Ganti TOKEN_ANDA dengan API Key dari menu API Key di dashboard ngaturbisnis.com.

Verifikasi: Restart Cursor setelah menyimpan. Buka chat Cursor (Cmd/Ctrl+L), ketik "Tampilkan ringkasan bisnis saya".
1
Buka Windsurf Settings → Cascade → MCP Servers

Klik "+" atau edit langsung ~/.codeium/windsurf/mcp_config.json

Gunakan API Key dari Langkah 1 (Metode B) dan paste sebagai Bearer Token:

{ "mcpServers": { "ngaturbisnis": { "serverUrl": "https://mcp.ngaturbisnis.com/api/mcp", "headers": { "Authorization": "Bearer TOKEN_ANDA" } } } }

Ganti TOKEN_ANDA dengan API Key dari menu API Key di dashboard ngaturbisnis.com.

Catatan: Windsurf menggunakan key serverUrl (bukan url). Restart Windsurf setelah setup.
1
Install ekstensi Cline dari VS Code Marketplace

Cari "Cline" di Extensions (Cmd/Ctrl+Shift+X) dan install.

2
Klik ikon Cline di sidebar → klik ikon MCP → "Add Server" → pilih "Remote (HTTP SSE)"

Isi form:

  • Server name: ngaturbisnis
  • URL: https://mcp.ngaturbisnis.com/api/mcp
  • Header key: Authorization
  • Header value: Bearer TOKEN_ANDA (API Key dari Langkah 1 Metode B)

Atau edit ~/.vscode/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{ "mcpServers": { "ngaturbisnis": { "url": "https://mcp.ngaturbisnis.com/api/mcp", "headers": { "Authorization": "Bearer TOKEN_ANDA" } } } }
💡
Tentang Cline

Cline adalah ekstensi AI coding assistant untuk VS Code yang mendukung MCP. Token yang sama dari ngaturbisnis.com bisa dipakai di semua AI tool.

3
Restart AI Anda sepenuhnya

Tutup aplikasi AI Anda (bukan hanya minimize), lalu buka kembali. Saat terbuka, AI akan otomatis terkoneksi ke ngaturbisnis MCP server Anda.

Verifikasi koneksi: Ketik di chat AI Anda: "Tampilkan ringkasan bisnis saya". Jika AI merespons dengan data bisnis, artinya koneksi berhasil!
03

Catat Pengeluaran dari Foto

Fitur paling populer — ambil foto nota belanja atau struk, kirim ke Claude, dan semua data terekstrak otomatis tanpa ketik manual.

1
Ambil foto nota atau struk belanja

Foto dengan pencahayaan cukup agar teks terbaca jelas. Format JPG, PNG, atau HEIC didukung.

2
Lampirkan foto ke Claude Desktop

Klik ikon attachment (📎) di Claude Desktop, pilih file foto, lalu ketik instruksi Anda.

3
Claude membaca dan mengekstrak data

Claude akan menganalisis gambar, mengidentifikasi item, nominal, tanggal, dan kategori yang sesuai.

4
Konfirmasi dan data tersimpan

Claude menampilkan ringkasan data yang diekstrak. Konfirmasi "Ya" dan data langsung tersimpan ke database.

Claude / Cursor / Windsurf — ngaturbisnis MCP
📎 struk_bahan_baku.jpg

Tolong baca nota ini dan catat pengeluarannya

C

Saya melihat struk belanja bahan baku. Berikut data yang saya ekstrak:

NamaBelanja Bahan Baku Mingguan
TotalRp 425.000
Tanggal05/07/2026
KategoriBahan Baku

Apakah saya catat ke database sekarang?

Ya, catat

C

✅ Berhasil dicatat!

ID: pge_a1b2c3...
Tersimpan di toko: Warung Sehat Sudirman
💡
Tips Foto yang Baik

Foto dengan background gelap agar teks lebih kontras. Hindari bayangan. Pastikan seluruh nota terlihat dalam frame. Resolusi minimal 720p sudah cukup.

04

Analitik Bisnis

Tanya Claude dalam bahasa natural untuk mendapat laporan bisnis lengkap — omzet, laba, pertumbuhan, dan insight otomatis.

Contoh Pertanyaan yang Bisa Ditanyakan

"Omzet bulan ini berapa?"

→ baca_ringkasan_bisnis

"Laporan pengeluaran Juli 2026"

→ baca_ringkasan_bisnis

"Performa toko Sudirman vs Tanah Abang"

→ baca_ringkasan_bisnis

"Pengeluaran terbesar bulan ini apa?"

→ baca_ringkasan_bisnis

"Tunjukkan pertumbuhan omzet vs bulan lalu"

→ baca_ringkasan_bisnis

"Margin laba saya seberapa besar?"

→ baca_ringkasan_bisnis
Claude Desktop — ngaturbisnis MCP

Tampilkan ringkasan bisnis bulan ini lengkap dengan insight

C

📊 Ringkasan Bisnis — Juli 2026

Omzet
Rp 12,75 jt
↑ +18.3%
Laba Kotor
Rp 8,43 jt
Margin 66.1%
Pengeluaran
Rp 4,32 jt
33.9% dari omzet
Sesi Penjualan
24 sesi
Avg Rp 531rb/sesi

💡 Insight: Margin 66.1% sangat sehat untuk bisnis F&B. Pertumbuhan +18.3% menunjukkan tren positif. Pastikan stok bahan baku mencukupi permintaan yang meningkat.

05

Skenario Penggunaan

Lima skenario nyata penggunaan 12 tools ngaturbisnis MCP — dari mencatat pengeluaran hingga membuat transaksi kasir.

📸
Skenario 1 — Foto Nota Belanja

Tool: catat_pengeluaran

Claude Desktop — ngaturbisnis MCP
📎 struk_bahan_baku.jpg

Tolong baca nota ini dan catat pengeluarannya

C

Saya melihat struk belanja bahan baku. Berikut data yang saya ekstrak:

NamaBelanja Bahan Baku Mingguan
TotalRp 425.000
Tanggal05/07/2026
KategoriBahan Baku

Apakah saya catat ke database sekarang?

Ya, catat

C

✅ Berhasil dicatat!

Pengeluaran Rp 425.000 tersimpan di toko Warung Sehat Sudirman.

🏪
Skenario 2 — Buat Toko Baru

Tool: tambah_toko

Claude Desktop — ngaturbisnis MCP

Buat toko baru bernama "Warung Barokah Kemang", alamat Jl. Kemang Raya No. 12

C

✅ Toko berhasil dibuat!

NamaWarung Barokah Kemang
AlamatJl. Kemang Raya No. 12
StatusAktif
📊
Skenario 3 — Ringkasan Bisnis Bulan Ini

Tool: baca_ringkasan_bisnis

Claude Desktop — ngaturbisnis MCP

Ringkasan bisnis bulan ini, lengkap dengan insight

C

📊 Ringkasan Bisnis — Juli 2026

Omzet
Rp 12,75 jt
↑ +18.3%
Laba Kotor
Rp 8,43 jt
Margin 66.1%
Pengeluaran
Rp 4,32 jt
33.9% dari omzet
Sesi Kasir
24 sesi
Avg Rp 531rb/sesi

💡 Insight: Margin 66.1% sangat sehat. Pertumbuhan +18.3% menunjukkan tren positif — pastikan stok bahan baku mencukupi permintaan yang meningkat.

🧾
Skenario 4 — Catat Penjualan Kasir

Tool: buat_transaksi_kasir

Claude Desktop — ngaturbisnis MCP

Catat penjualan hari ini: 3 Nasi Goreng, 2 Es Teh, bayar cash

C

✅ Transaksi berhasil dicatat!

3x Nasi GorengRp 45.000
2x Es TehRp 12.000
TotalRp 57.000
PembayaranCash
💰
Skenario 5 — Catat Pemasukan Luar Biasa

Tool: catat_pemasukan

Claude Desktop — ngaturbisnis MCP

Catat pemasukan dari acara catering kemarin, Rp 3.500.000 untuk toko Sudirman

C

✅ Pemasukan berhasil dicatat!

KeteranganAcara Catering
NominalRp 3.500.000
TokoWarung Sehat Sudirman
Tanggal04/07/2026
06

Tips & Trik

Maksimalkan penggunaan ngaturbisnis MCP dengan tips berikut dari para pengguna.

🎯
Sebut nama toko secara eksplisit

Jika punya beberapa toko, selalu sebut nama toko saat mencatat: "Catat pengeluaran ini untuk toko Sudirman". Claude akan otomatis mencari UUID yang tepat.

📅
Cek ringkasan bisnis setiap Senin pagi

Biasakan bertanya "Performa bisnis minggu lalu?" setiap awal minggu. Ini memberi gambaran trend mingguan dan membantu keputusan pembelian bahan baku.

📸
Foto nota langsung saat menerima

Jangan tumpuk nota — langsung foto dan kirim ke Claude saat menerima. Lebih mudah dan data langsung tercatat real-time tanpa numpuk di akhir bulan.

💬
Tanya dalam bahasa natural saja

Tidak perlu hafal nama tool. Cukup tanya seperti berbicara ke asisten: "Kasir mana yang paling produktif bulan ini?" — Claude akan memanggil tool yang tepat otomatis.

🔐
Kelola akses per device dengan mudah

Jika pakai OAuth (Claude Desktop / Claude Code), setiap perangkat mendapat token sendiri secara otomatis — tinggal login di browser masing-masing perangkat.

Jika pakai API Key manual (Cursor / Windsurf / Cline), buat key berbeda per perangkat agar mudah dicabut jika device hilang:

"Claude Desktop MacBook Kerja"
"Cursor Windows Kantor"
"Windsurf Laptop Pribadi"
© 2026 ngaturbisnis MCP — Kompatibel dengan Claude, Cursor, Windsurf & Cline