Final POS – Custom POS Builder
resmiBangun POS kustom dengan AI. Rancang alur checkout, kiosk swalayan, dan aplikasi terminal pembayaran, pratinjau secara langsung, dan terapkan ke perangkat keras nyata dengan pembayaran kartu. Juga menjalankan toko: produk, stok, pesanan, pelanggan, dan laporan penjualan. Jarak jauh, OAuth.
Apa yang bisa Anda lakukan dengan Final POS – Custom POS Builder MCP?
- Bangun aplikasi POS kustom dari deskripsi — Minta asisten Anda membuat alur pembayaran, seperti kios kedai kopi, dan dapatkan tautan pratinjau langsung.
- Validasi dan terapkan alur POS — Minta validasi file alur aplikasi Anda, lalu kirim versi terbaru ke terminal pembayaran dan kios Anda.
- Pantau dan kelola inventaris — Periksa tingkat stok, temukan item yang stoknya menipis, dan buat draf pesanan pembelian untuk pemasok biasa Anda.
- Analisis kinerja penjualan — Bandingkan penjualan berdasarkan kategori antar minggu atau identifikasi pelanggan teratas Anda dan pembelian mereka.
- Kelola katalog dan pelanggan — Tambahkan produk dari spreadsheet beserta foto, atau siapkan layanan yang dapat dipesan dengan staf yang ditugaskan.
Server MCP Terhosting
npx add-mcp 'https://ai.finalpos.com/mcp'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
Server MCP resmi: bangun aplikasi POS kustom dengan AI
Hubungkan Claude, ChatGPT, Gemini, Cursor, Codex, atau klien MCP mana pun ke Final:
bangun aplikasi POS kustom dengan Flow (alur checkout, kios self-checkout, terminal pembayaran)
dan kelola toko di baliknya dari Hub, melalui satu server.
https://ai.finalpos.com/mcp
Hubungkan · Yang bisa dilakukannya · Referensi alat · FAQ · finalpos.com
Server MCP Final adalah server Model Context Protocol resmi untuk
Final, platform commerce untuk point of sale kustom.
Satu endpoint remote, https://ai.finalpos.com/mcp, memberi agen AI akses ke
setiap produk Final yang diizinkan oleh merchant:
- Flow, pembangun aplikasi POS kustom: jelaskan sebuah checkout dan agen akan membangunnya dari blueprint layar yang telah terkurasi, berlandaskan API POS Final yang terkunci versinya, lalu memvalidasinya, mengembalikan tautan pratinjau langsung, dan men-deploy-nya ke terminal pembayaran, tablet, dan kios. POS kasir, self-checkout, pemesanan restoran, layar dapur, dan aplikasi pembayaran tatap muka.
- Hub, back office di balik aplikasi tersebut: produk dan katalog, stok dan purchase order, pesanan, pelanggan, laporan penjualan, tim dan peran, outlet, pajak, pemesanan.
Anda masuk dengan akun Final Anda (OAuth 2.1) dan memilih perusahaan serta apa yang boleh dilakukan agen. Tidak ada yang perlu dipasang atau dijalankan secara lokal.
| Endpoint | https://ai.finalpos.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 dengan PKCE (masuk dengan Final), atau connection key fai_ sebagai Authorization: Bearer |
| Nama registry | com.finalpos/final |
| Bertindak sebagai | Orang yang menghubungkannya, pada satu perusahaan, dalam paket yang diizinkannya |
| Biaya | Gratis untuk dihubungkan; apa yang dilakukan agen mengikuti paket Final Anda, seolah-olah Anda melakukannya di Final |
Hubungkan
Sebagian besar klien hanya memerlukan URL. Mereka membuka halaman masuk Final di mana Anda memilih perusahaan dan paket, lalu terhubung.
Claude (claude.ai, Claude Desktop)
Settings → Connectors → Add custom connector, URL https://ai.finalpos.com/mcp.
ChatGPT
Settings → Apps & Connectors → Advanced settings → Developer mode, lalu
Create dengan URL https://ai.finalpos.com/mcp.
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
Jalankan /mcp di Claude Code dan pilih Authenticate. Atau pasang plugin,
yang menambahkan server bersama skill playbook Final. Di dalam Claude
Code:
/plugin marketplace add Final-Commerce/final-pos-mcp
/plugin install final@final
Gemini CLI
gemini extensions install https://github.com/Final-Commerce/final-pos-mcp
Ekstensi ini menambahkan server, playbook Final, dan perintah:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate, dan /final-pos:deploy. Masuk sekali dengan
/mcp auth final di dalam Gemini CLI. Untuk menambahkan hanya servernya:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
Atau di ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
Pasang di VS Code, atau:
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, skrip, dan klien tanpa OAuth
Buat connection key di ai.finalpos.com/connections.
Key ditampilkan sekali, dan halaman tersebut mencetak cuplikan persis untuk setiap klien. Untuk
Codex, tambahkan ini ke ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
Klien lain mana pun: POST https://ai.finalpos.com/mcp dengan
Authorization: Bearer fai_YOUR_KEY.
Key yang diawali dengan
sk_(Flow) ataufpm_(Hub) milik server produk tersebut dan tidak diterima di sini. Buat keyfai_sebagai gantinya, atau gunakan OAuth.
Periksa apakah berfungsi
Tanyakan kepada agen Anda: "Gunakan Final untuk memberi tahu saya perusahaan mana yang terhubung
dan paket mana yang bisa Anda gunakan." Agen akan memanggil get_connection dan list_packs.
Yang bisa dilakukan agen Anda
Alat dikelompokkan dalam paket. Saat menghubungkan, Anda memilih paket mana yang
boleh digunakan agen, dan itu juga merupakan scope OAuth. Untuk menjaga konteks model
tetap kecil, sebuah koneksi hanya menampilkan beberapa paket sekaligus. Alat inti menjangkau
sisanya: find_tools mencari di semua paket yang diizinkan, dan call_tool memanggil alat
mana pun yang diizinkan berdasarkan nama.
| Paket | Produk | Cakupan | Ditampilkan secara default |
|---|---|---|---|
catalog | Hub | Produk, varian, kategori, opsi, modifier, foto produk, dan pustaka media | ✓ |
inventory | Hub | Level dan riwayat stok, transfer, pemasok, purchase order, aturan pemesanan ulang, impor/ekspor CSV stok | |
orders | Hub | Pesanan, refund, dan sinkronisasi pesanan e-commerce (hanya baca: kasir yang menerima pembayaran) | |
customers | Hub | Catatan pelanggan, catatan, riwayat pesanan, dan impor pelanggan | |
reports | Hub | Ringkasan keuangan, rincian penjualan dan pembayaran, penjualan karyawan, sesi, transaksi, ekspor catatan | |
team | Hub | Anggota tim, peran, dan izin | |
store | Hub | Outlet, stasiun, pajak, dan ekstensi Hub | |
bookings | Hub | Layanan yang dapat dipesan: aturan, sumber daya, ketersediaan, hold, dan konfirmasi | |
build | Flow | Bangun dan deploy aplikasi Final POS: landasan API, blueprint, file flow, sandbox pratinjau, validasi, deploy | ✓ |
build_data | Flow | Tabel kustom (basis data aplikasi), vault rahasia, dan ekstensi Flow |
Nama alat membawa produknya: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow. TOOLS.md mencantumkan setiap
alat, beserta paketnya, apakah mengubah data, dan argumennya.
Alat inti (selalu ditampilkan): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company.
Hal yang bisa ditanyakan
Membangun aplikasi POS kustom (Flow)
- "Bangun kios kedai kopi dengan grid produk, modifier, keranjang, dan pembayaran kartu, lalu beri saya tautan pratinjau."
- "Tambahkan layar tip ke aplikasi kasir saya dan validasikan."
- "Buat alur self-checkout untuk toko kelontong kecil dengan pemindaian barcode dan layar struk."
- "Rilis versi terbaru alur self-checkout saya."
Pembangunan aplikasi biasanya berjalan flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (landasan) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview, dan
mengembalikan URL pratinjau langsung. Semua yang dibangun agen juga muncul di
pembangun Final, di mana setiap penulisan file adalah checkpoint yang dapat dipulihkan.
Menjalankan toko (Hub)
- "Produk mana yang berada di bawah titik pemesanan ulang di outlet Main Street? Susun draf purchase order untuk pemasok biasa."
- "Bandingkan penjualan minggu lalu per kategori dengan minggu sebelumnya."
- "Tambahkan 40 produk ini dari spreadsheet terlampir, beserta fotonya."
- "Siapa sepuluh pelanggan teratas saya bulan ini, dan apa yang mereka beli?"
- "Siapkan pijat 45 menit sebagai layanan yang dapat dipesan dengan dua terapis."
Keamanan dan izin
- Peran Anda tetap berlaku. Setiap panggilan Hub berjalan sebagai orang yang menghubungkan, dan Hub memeriksa peran langsung mereka pada setiap panggilan. Tindakan khusus pemilik tetap khusus pemilik.
- Paket adalah izinnya. Agen hanya dapat memanggil alat dalam paket yang Anda izinkan. Anda dapat mengubah paket atau memutuskan koneksi kapan saja di ai.finalpos.com/connections, dan memutuskan koneksi mencabut semua token sekaligus.
- Penulisan diberi label. Alat baca membawa
readOnlyHint, dan deploy serta hapus membawadestructiveHint, sehingga klien dapat bertanya sebelum bertindak. Server memberi tahu agen untuk mengonfirmasi deploy, hapus, dan perubahan massal dengan Anda. - Uang tetap di kasir. Menerima pembayaran, refund, dan void pesanan tidak tersedia melalui MCP.
- Rahasia tidak pernah melewati model.
flow_request_secretmeminta Anda memasukkan API key di pembangun. - Semuanya dicatat. Halaman Connections menampilkan setiap klien yang terhubung dan setiap panggilan yang dilakukannya, secara langsung.
- Batas Flow: Flow mengizinkan 30 boot pratinjau, 12 build dan deploy, serta 300 penulisan file per jam.
Privasi dan dukungan
- Apa yang disimpan Final. Koneksi (siapa yang membuatnya, perusahaan, dan paket), token yang digunakan untuk menjangkau Hub dan Flow (terenkripsi), dan log setiap panggilan alat: alat, hasil, berapa lama, dan pratinjau argumen dan hasil yang telah disunting. Anda melihat log tersebut di halaman Connections.
- Apa yang tidak dilihat Final. Percakapan Anda. Klien MCP mengirim panggilan alat, bukan obrolan di sekitarnya.
- Memutuskan koneksi menghapus token yang tersimpan dan mencabut setiap token yang diterbitkan untuk koneksi tersebut.
- Kebijakan privasi · Ketentuan
- Dukungan: support@finalpos.com. Untuk masalah dengan panduan ini atau plugin, buka issue.
Endpoint langsung Flow
Pengaturan yang dibuat sebelum gateway mungkin masih menggunakan https://flow.finalpos.com/api/mcp
dengan key Flow sk_ (nama registry com.finalpos.build/final-flows). Ini tetap
berfungsi, tetapi pengaturan baru sebaiknya menggunakan https://ai.finalpos.com/mcp, yang mencakup
Flow.
FAQ
Apa itu server MCP Final?
Ini adalah server MCP resmi untuk Final POS. Satu URL remote,
https://ai.finalpos.com/mcp, memungkinkan asisten AI membaca dan mengelola
back office Final merchant (Hub) dan membangun aplikasi point-of-sale (Flow).
Bisakah ChatGPT atau Claude mengelola inventaris Final POS saya?
Ya. Izinkan paket inventory saat Anda menghubungkan. Agen dapat memeriksa level
stok, menemukan stok rendah, menyarankan pemesanan ulang, membuat purchase order, dan mencatat
barang yang diterima.
Bisakah agen AI membangun aplikasi POS di Final?
Ya. Dengan paket build, agen membuat flow, menulis aplikasi terhadap
API Final yang terkunci versinya dan blueprint layar yang telah terkurasi, memvalidasinya, dan
mengembalikan URL pratinjau langsung. Anda meluncurkannya dari pembangun Final.
Apakah saya perlu API key?
Tidak, jika klien Anda mendukung OAuth (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): cukup masuk dengan Final. Codex dan skrip menggunakan key fai_
dari ai.finalpos.com/connections.
Perusahaan mana yang menjadi sasarannya?
Perusahaan yang Anda pilih saat menghubungkan. Jika akun Anda memiliki beberapa, agen dapat
memanggil switch_company.
Bisakah agen menerima pembayaran atau mengeluarkan refund?
Tidak. Pembayaran, refund, dan void terjadi di kasir. Pesanan bersifat hanya baca melalui MCP.
Mengapa agen saya hanya melihat beberapa alat?
Klien memasukkan setiap alat yang ditampilkan ke dalam konteks model, dan kualitas menurun dengan
daftar yang panjang. Agen menemukan sisanya dengan find_tools, memanggilnya dengan
call_tool, atau menampilkan seluruh paket dengan enable_packs.
Apakah ada biayanya?
Menghubungkan gratis. Apa yang dilakukan agen ditagih seperti pekerjaan yang sama yang dilakukan di Final sendiri, sesuai paket Final Anda.
Di mana dokumentasi API Final POS?
Di finalpos.com/docs. Agen yang membangun aplikasi
tidak memerlukannya secara terpisah: paket build melandasi setiap panggilan terhadap
API Final yang terkunci versinya (flow_lookup_pos_api,
flow_lookup_command_frame).
Tentang repositori ini
Repo ini berisi panduan penyiapan publik, entri MCP Registry
(server.json, legacy/), ekstensi Gemini CLI
(gemini-extension.json, GEMINI.md, commands/), marketplace plugin Claude Code dan
Cursor (.claude-plugin/, .cursor-plugin/, dan
plugins/final/, yang keduanya berbagi) serta
referensi alat yang dihasilkan beserta kembarannya yang dapat dibaca mesin catalog.json,
yang juga dibaca oleh kartu server di https://ai.finalpos.com/.well-known/mcp/server-card.json.
GEMINI.md dan skill Claude adalah playbook yang sama, dan CI memeriksa bahwa keduanya cocok. Server itu sendiri dihosting oleh Final;
tidak ada kode dari repo ini yang berjalan di mesin Anda.
Lisensi
Apache-2.0 © Final Commerce