❓ Pertanyaan yang Sering Diajukan

FAQ Teknis ngaturbisnis MCP

Semua jawaban yang Anda butuhkan tentang setup, keamanan, tools, dan troubleshooting MCP Server untuk bisnis F&B.

Setup Claude Desktop OAuth Login API Key Error 401 Multi-toko Foto nota Harga
🤖

Tentang ngaturbisnis MCP

Dasar-dasar tentang apa itu MCP dan cara kerjanya

5 pertanyaan

ngaturbisnis MCP adalah server MCP (Model Context Protocol) yang menghubungkan Claude AI dengan data bisnis F&B Anda di ngaturbisnis.com.

Dengan MCP ini, Anda bisa catat pengeluaran, pantau omzet, buat transaksi kasir, dan minta analisis bisnis — semua cukup lewat percakapan di Claude Desktop atau Claude Code tanpa harus membuka dashboard.

MCP (Model Context Protocol) adalah standar terbuka buatan Anthropic yang memungkinkan Claude AI terhubung ke tools dan data eksternal secara real-time.

  • 📡 Protokol: HTTP Transport (2025-03-26) + SSE (2024-11-05)
  • 🔗 Transport: HTTP POST + SSE Streaming
  • 🔒 Autentikasi: OAuth 2.0 PKCE / API Key (Bearer Token)

Dengan MCP, Claude bukan sekadar chatbot — ia bisa langsung membaca dan menulis data ke sistem Anda secara aman.

ngaturbisnis MCP kompatibel dengan semua model Claude yang mendukung tool use:

  • ✓ Claude Opus 4 / Sonnet 4 / Haiku 4
  • ✓ Claude 3.5 Sonnet / Haiku
  • ✓ Model lama yang mendukung tool use

Untuk analisis gambar nota, disarankan menggunakan Claude Sonnet atau Opus agar akurasi OCR lebih tinggi.

Akun Claude Free sudah cukup untuk mulai menggunakan ngaturbisnis MCP.

Claude Free
  • ✓ Bisa pakai semua tools MCP
  • ✓ Batas pesan lebih sedikit/hari
  • ✓ Model standar
Claude Pro ($20/bln)
  • ✓ 5× lebih banyak pesan/hari
  • ✓ Akses model terbaru lebih cepat
  • ✓ Ideal untuk penggunaan harian

ngaturbisnis MCP sendiri sepenuhnya gratis. Biaya hanya dari langganan Claude Anda ke Anthropic.

ngaturbisnis dioptimalkan untuk bisnis Food & Beverage (warung, kafe, restoran, katering, cloud kitchen), namun secara teknis bisa digunakan untuk bisnis retail kecil yang memiliki pola transaksi pemasukan dan pengeluaran serupa.

Fitur foto nota berfungsi untuk struk dari supplier manapun, tidak terbatas industri F&B.

⚙️

Setup & Instalasi

Cara menghubungkan Claude Desktop dengan ngaturbisnis

7 pertanyaan

OAuth adalah metode autentikasi modern di mana Anda tidak perlu copy-paste token secara manual. Claude Desktop atau Claude Code akan membuka browser secara otomatis untuk login saat pertama kali terkoneksi.

⭐ Cara pakai OAuth (Claude Desktop):
  1. Tambahkan config MCP tanpa header Authorization
  2. Restart Claude Desktop
  3. Saat tool dipanggil pertama kali, browser terbuka ke login ngaturbisnis.com
  4. Login → klik Izinkan Akses → selesai!
# claude_desktop_config.json (OAuth — tanpa token)
{
"mcpServers": {
"ngaturbisnis": {
"type": "http",
"url": "https://mcp.ngaturbisnis.com/api/mcp"
}
}
}

OAuth tersedia untuk Claude Desktop dan Claude Code. Untuk Cursor, Windsurf, dan Cline gunakan API Key manual.

Ada dua metode:

⭐ Metode OAuth — Direkomendasikan (tanpa token)
# Claude Code CLI — OAuth (tanpa --header)
claude mcp add ngaturbisnis --transport http \
https://mcp.ngaturbisnis.com/api/mcp
# Metode manual: Edit JSON config Claude Desktop
{
"mcpServers": {
"ngaturbisnis": {
"type": "http",
"url": "https://mcp.ngaturbisnis.com/api/mcp",
"headers": {
"Authorization": "Bearer TOKEN_ANDA"
}
}
}
}

Setelah setup, restart Claude Desktop. Lihat panduan lengkap di halaman Tutorial.

🍎
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
🪟
Windows
C:\Users\NamaAnda\AppData\Roaming\Claude\claude_desktop_config.json
🐧
Linux
~/.config/Claude/claude_desktop_config.json

Jika file belum ada, buat baru dengan isi: {"mcpServers": {}}

Tidak. ngaturbisnis MCP menggunakan transport HTTP Streamable — tidak perlu install Node.js, Python, atau library apapun.

Cukup:

  1. Install Claude Desktop atau Claude Code
  2. Buat API Key di dashboard ngaturbisnis.com
  3. Tambahkan config satu kali

Ya! ngaturbisnis MCP sudah mendukung Claude.ai web melalui OAuth 2.0. Cukup tambahkan MCP server dengan URL endpoint, lalu browser akan membuka halaman login ngaturbisnis.com secara otomatis.

  • ✓ Claude.ai web (OAuth otomatis)
  • ✓ Claude Desktop (Mac & Windows)
  • ✓ Claude Code (CLI terminal)
  • ✓ Cursor, Windsurf, Cline (VS Code)
  • ✗ Aplikasi mobile Claude — belum didukung

Ya! Cursor mendukung MCP server via API Key manual. Buka Cursor Settings → MCP, lalu tambahkan server baru:

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

Buat API Key di dashboard ngaturbisnis.com (menu API Key → Buat Token Baru), lalu ganti TOKEN_ANDA. File config: ~/.cursor/mcp.json (Mac/Linux). Restart Cursor setelah menyimpan.

Windsurf — buka Settings → Cascade → MCP Servers, tambahkan dengan API Key manual:

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

Cline (VS Code) — install ekstensi Cline, klik ikon MCP → Add Server → Remote HTTP SSE:

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

Buat API Key di menu API Key di dashboard ngaturbisnis.com. Satu API Key bisa dipakai di semua AI tool (Cursor, Windsurf, Cline). Untuk Claude Desktop & Claude Code, gunakan OAuth agar lebih mudah.

🔑

API Key & Autentikasi

Membuat, mengelola, dan mengamankan API Key — serta pilihan OAuth

4 pertanyaan
⭐ OAuth (Direkomendasikan)
  • ✓ Tidak perlu copy-paste token
  • ✓ Login sekali via browser
  • ✓ Token diperbarui otomatis (1 jam)
  • ✓ Lebih aman — token tidak tersimpan di file
  • · Hanya untuk Claude Desktop & Claude Code
🔑 API Key Manual
  • ✓ Didukung semua AI tool
  • ✓ Cocok untuk Cursor, Windsurf, Cline
  • ✓ Tidak perlu buka browser
  • · Harus copy-paste token manual
  • · Token tidak expired (perlu revoke manual)

Gunakan OAuth untuk Claude Desktop & Claude Code. Gunakan API Key untuk Cursor, Windsurf, Cline, atau jika OAuth tidak tersedia.

API Key adalah token autentikasi manual yang dipakai untuk Cursor, Windsurf, Cline, atau sebagai alternatif OAuth.

Cara membuat API Key:
  1. Login ke ngaturbisnis.com
  2. Buka menu API Key di dashboard
  3. Klik Buat Token Baru
  4. Beri nama (mis: "Cursor Kantor")
  5. Salin token — hanya muncul sekali!

Jika pakai Claude Desktop atau Claude Code, pertimbangkan OAuth sebagai alternatif yang lebih mudah — tidak perlu copy-paste token sama sekali.

API Key disimpan di file config Claude Desktop di perangkat Anda — tidak dikirim ke server lain selain mcp.ngaturbisnis.com.

Jika API Key bocor:
  1. Login ke ngaturbisnis.com → menu API Key
  2. Klik Cabut pada token yang bocor (langsung nonaktif)
  3. Buat token baru
  4. Update config Claude Desktop dengan token baru

Tips: buat satu token per perangkat agar mudah dikontrol dan dicabut jika diperlukan.

Ya, Anda bisa membuat beberapa API Key sekaligus — direkomendasikan satu key per perangkat atau per penggunaan:

  • → "Claude Desktop MacBook"
  • → "Claude Desktop Windows Kantor"
  • → "Claude Code Server"

Dengan pemisahan ini, jika satu perangkat hilang, Anda hanya perlu mencabut token perangkat itu tanpa mengganggu perangkat lain.

🔧

Tools & Fitur

Panduan menggunakan 12 tools MCP yang tersedia

4 pertanyaan
READ
baca_ringkasan_bisnis
Ringkasan omzet, laba, pengeluaran, produk terlaris per toko dan periode
WRITE
tambah_toko
Buat outlet atau cabang baru lengkap dengan alamat
WRITE
catat_pengeluaran
Catat biaya operasional dari chat atau foto nota/struk
WRITE
catat_pemasukan
Catat pendapatan manual di luar sistem kasir
WRITE
buat_transaksi_kasir
Buat invoice penjualan dengan item, harga, dan metode bayar (cash/transfer/QRIS)
READ
tren_perkembangan_bisnis
Bandingkan dua periode: minggu ini vs lalu, bulan ini vs lalu, atau custom range
READ
prediksi_dan_rekomendasi
Proyeksi omzet bulan depan + rekomendasi aksi berbasis data historis
READ
daftar_toko
List semua toko beserta statistik bulanan (omzet, pengeluaran, laba)
READ
daftar_kasir
List kasir dengan performa bulanan dan assignment toko
READ
daftar_barang
Master barang + top 15 produk terlaris 30 hari terakhir
READ
daftar_menu
Menu toko grouped by kategori dengan status ketersediaan
READ
riwayat_transaksi
Detail riwayat transaksi kasir dengan line items dan payment breakdown
  1. Buka Claude Desktop
  2. Drag-and-drop atau klik attach foto nota/struk ke chat
  3. Ketik perintah: "Catat pengeluaran dari nota ini"
  4. Claude membaca gambar, mengekstrak data, dan memanggil tool secara otomatis
Format yang didukung: JPG, PNG, WEBP, HEIC, PDF
Tips: Foto dengan pencahayaan cukup dan tulisan jelas memberikan akurasi terbaik

ngaturbisnis MCP mendukung multi-toko dalam satu akun.

Contoh perintah multi-toko:
"Tambah toko baru bernama Cabang Bandung"
"Catat pengeluaran Rp 150.000 untuk Cabang Bandung"
"Ringkasan bisnis Toko Pusat bulan Juli"
"Bandingkan performa semua toko bulan ini"

Tidak ada batasan dari sisi ngaturbisnis MCP. Anda bisa catat sebanyak apapun yang dibutuhkan.

Batasan yang mungkin berlaku:

  • ⚠️ Batas pesan per hari dari paket Claude Anda
  • ⚠️ Batas storage akun ngaturbisnis.com (info di halaman akun)
🔒

Keamanan & Data

Perlindungan data bisnis dan privasi

3 pertanyaan
✓
Enkripsi HTTPS/TLS — semua komunikasi terenkripsi end-to-end
✓
Isolasi per akun — Claude hanya bisa mengakses data milik API Key Anda
✓
Server di Indonesia — data tidak keluar dari yurisdiksi Indonesia
✓
Tidak dijual ke pihak ketiga — data Anda hanya untuk kebutuhan layanan
✓
Backup harian otomatis

Data bisnis Anda (transaksi, omzet, dll) tidak dikirim ke Anthropic. Yang terjadi saat Claude menggunakan tool:

  1. Claude mengirim perintah tool ke server ngaturbisnis.com (mis: "ambil ringkasan bulan Juli")
  2. Server mengembalikan respons data ke Claude
  3. Claude merangkum respons untuk Anda

Anthropic mungkin menyimpan percakapan sesuai kebijakan privasi mereka, termasuk respons data yang dikembalikan oleh tool. Hindari mengirim informasi sangat sensitif (kata sandi, nomor rekening) melalui chat.

Data transaksi, pengeluaran, dan pemasukan disimpan selama akun Anda aktif tanpa batas waktu.

Anda dapat:

  • → Lihat & filter data dari dashboard
  • → Ekspor ke Excel / CSV kapan saja
  • → Hapus data tertentu jika diperlukan
🛠️

Troubleshooting

Mengatasi masalah koneksi dan error umum

6 pertanyaan

Jika browser tidak terbuka otomatis saat menggunakan OAuth, periksa:

1
Config masih ada header Authorization
Hapus bagian "headers" dari config — OAuth tidak butuh header token.
2
Claude Desktop belum di-restart
Tutup sepenuhnya (bukan minimize), lalu buka kembali.
3
Browser default tidak terkonfigurasi
Pastikan sistem Anda punya browser default. OAuth membuka URL https://mcp.ngaturbisnis.com/oauth/authorize
4
Versi Claude Desktop terlalu lama
Update ke versi terbaru Claude Desktop. OAuth MCP memerlukan versi yang mendukung authorization code flow.

Sebagai alternatif, gunakan API Key manual (Metode B di tutorial) jika OAuth bermasalah.

1
Belum restart Claude Desktop
Wajib restart setelah setiap perubahan config.
2
Format JSON config salah
Validasi di jsonlint.com — koma trailing dan kurung tidak pasangan sering jadi penyebab.
3
Token tidak valid / sudah dicabut
Buat token baru di dashboard, pastikan tidak ada spasi di awal/akhir.
4
URL MCP salah
Pastikan pakai: https://mcp.ngaturbisnis.com/api/mcp

Error 401 berarti API Key tidak valid atau tidak dikirim dengan benar.

Periksa format header:
Authorization: Bearer ngb_live_sk_xxx

Pastikan ada spasi antara "Bearer" dan token. Gunakan huruf kapital "Bearer".

Checklist:
  • □ Token tidak mengandung spasi tersembunyi
  • □ Token belum dicabut di dashboard
  • □ Bukan token contoh dari dokumentasi
  • □ Header ditulis di config, bukan di URL
  1. Buka https://mcp.ngaturbisnis.com di browser — jika tidak terbuka, kemungkinan server maintenance
  2. Cek apakah firewall/antivirus memblokir koneksi dari Claude Desktop
  3. Coba nonaktifkan VPN sementara
  4. Coba dari jaringan berbeda (WiFi vs data seluler)
  5. Pastikan Claude Desktop versi terbaru

Kemungkinan penyebab:

  1. Cache browser — refresh dashboard dengan Ctrl+Shift+R (hard refresh)
  2. Filter tanggal di dashboard tidak menampilkan tanggal transaksi yang baru dicatat — cek filter
  3. Tool mengembalikan error — baca respons Claude secara lengkap, biasanya ada pesan error dari API
  4. Toko tidak ditemukan — pastikan nama toko yang disebutkan ke Claude sama persis dengan nama toko di dashboard

Ya, koneksi internet diperlukan karena MCP berkomunikasi real-time antara:

  • → Claude Desktop ↔ Server Anthropic (untuk AI)
  • → Claude Desktop ↔ mcp.ngaturbisnis.com (untuk data bisnis)

Tidak ada mode offline. Rekomendasi: koneksi minimal 1 Mbps untuk pengalaman terbaik.

💰

Harga & Akun

Informasi biaya dan manajemen akun

3 pertanyaan
Rp 0
Gratis Selamanya

Semua fitur MCP terbuka untuk pengguna ngaturbisnis.com

Satu-satunya biaya adalah dari langganan Claude Anda sendiri ke Anthropic (bukan ke kami).

Daftar akun bisa dilakukan di ngaturbisnis.com. Setelah akun aktif, Anda langsung bisa membuat API Key di dashboard dan menghubungkannya dengan Claude Desktop.

Anda bisa melaporkan bug atau request fitur melalui:

  • → Fitur feedback di dashboard ngaturbisnis.com
  • → Email ke tim kami (tersedia di halaman kontak)

Kami aktif mengembangkan tools baru berdasarkan kebutuhan pengguna.

💬

Masih Ada Pertanyaan?

Lihat dokumentasi lengkap atau panduan setup step-by-step di halaman Tutorial.

Baca Dokumentasi → Lihat Tutorial Setup