Menghubungkan asisten AI lewat MCP

Label tebal ditulis persis seperti di aplikasi.

Apa ini

MCP (Model Context Protocol) membuat asisten AI seperti Claude atau ChatGPT bisa membaca data bisnis Anda: penjualan, meja, staf dan stok. Anda membuat token, menempel URL-nya sebagai konektor di asisten AI, lalu bertanya, mis. "Menu apa yang paling laku minggu ini?". Tiap token terisolasi per bisnis, bisa dibatasi ke outlet tertentu, dan bisa dicabut kapan saja.

Membuka halaman token

Buka Pengaturan → Integrasi & data → AI & Integrasi. Anda dibawa ke halaman Pengembang, tab Token AI (MCP).

Membuat token

1. Ketuk Buat token MCP (atau Buat token baru). "URL token hanya ditampilkan satu kali."
2. Nama token, mis. "Claude, Owner".
3. Masa berlaku: bawaannya Tanpa batas (aktif sampai dicabut); bisa diganti dengan Tanggal berakhir.
4. Cakupan lokasi: kosongkan untuk semua lokasi, atau pilih beberapa outlet untuk membatasi token ke outlet itu saja.
5. Izin:
   • Baca analitik (penjualan, staf, meja, inventori): selalu aktif.
   • Tulis operasi (buat tiket, setujui refund, kirim pesan): opsional. "Izin tulis tetap tunduk pada role Anda, token tidak bisa melakukan hal yang Anda sendiri tidak bisa." Asisten AI harus meminta konfirmasi Anda sebelum memakai alat tulis.
   • Data tamu (nama, telepon, email pelanggan, reservasi): hanya pemilik, dan hanya untuk token semua outlet.
6. Ketuk Buat token.

Menyalin URL (sekali saja)

Jendela Token dibuat, salin sekarang menampilkan URL server MCP. Ketuk Salin URL MCP, simpan di tempat aman, lalu Sudah saya simpan. "Siapa pun yang memiliki URL ini bisa membaca analitik bisnis Anda sampai token dicabut." Sansflow tidak menyimpan URL itu; bila hilang, buat token baru lalu cabut yang lama.

Memasang di asisten AI

Panduan pengaturan punya tab Claude, ChatGPT, Cursor, Windsurf, Codex CLI dan Umum, masing-masing dengan langkah dan blok konfigurasi yang bisa disalin:

• Claude: di Claude buka Settings, Connectors, Add custom connector; beri nama Sansflow POS, tempel URL MCP sebagai Server URL (tanpa auth tambahan, token ada di dalam URL), lalu aktifkan di kolom chat. Buka konektor Claude membuka halamannya. Instruksi kustom berisi teks yang bisa ditempel ke asisten.
• ChatGPT: Buka konektor ChatGPT, tempel URL MCP.
• Cursor, Codex, Windsurf: salin blok konfigurasi ke file yang disebutkan.
• Umum: URL MCP untuk aplikasi lain yang mendukung MCP.

Uji koneksi mengirim ping lewat jalur yang sama dengan Claude atau ChatGPT; hasilnya Terhubung dengan latensi dan jumlah tools, atau Koneksi gagal (Uji lagi).

Memantau dan mencabut

Daftar token menampilkan cakupan (Semua lokasi atau "{n} lokasi"), izin (Baca saja atau Baca + Tulis), Dibuat, Terakhir dipakai, Berakhir. Lihat aktivitas menampilkan 100 panggilan tool terakhir (disimpan 90 hari). Cabut meminta konfirmasi Cabut token ini?: asisten AI kehilangan akses seketika dan tidak bisa dibatalkan.

Kunci API untuk developer

Untuk menghubungkan aplikasi lain (akuntansi, CRM) tanpa AI, tab API key di halaman yang sama membuat kunci API. Kontraknya ada di dokumentasi API v1. Akses API termasuk paket Sansflow Premium.