Final POS – Custom POS Builder

resmi

Bangun 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

Final

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

MCP Registry: com.finalpos/final Add to Cursor Install in VS Code License: Apache-2.0

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.

Endpointhttps://ai.finalpos.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 dengan PKCE (masuk dengan Final), atau connection key fai_ sebagai Authorization: Bearer
Nama registrycom.finalpos/final
Bertindak sebagaiOrang yang menghubungkannya, pada satu perusahaan, dalam paket yang diizinkannya
BiayaGratis 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

Add to 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) atau fpm_ (Hub) milik server produk tersebut dan tidak diterima di sini. Buat key fai_ 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.

PaketProdukCakupanDitampilkan secara default
catalogHubProduk, varian, kategori, opsi, modifier, foto produk, dan pustaka media✓
inventoryHubLevel dan riwayat stok, transfer, pemasok, purchase order, aturan pemesanan ulang, impor/ekspor CSV stok
ordersHubPesanan, refund, dan sinkronisasi pesanan e-commerce (hanya baca: kasir yang menerima pembayaran)
customersHubCatatan pelanggan, catatan, riwayat pesanan, dan impor pelanggan
reportsHubRingkasan keuangan, rincian penjualan dan pembayaran, penjualan karyawan, sesi, transaksi, ekspor catatan
teamHubAnggota tim, peran, dan izin
storeHubOutlet, stasiun, pajak, dan ekstensi Hub
bookingsHubLayanan yang dapat dipesan: aturan, sumber daya, ketersediaan, hold, dan konfirmasi
buildFlowBangun dan deploy aplikasi Final POS: landasan API, blueprint, file flow, sandbox pratinjau, validasi, deploy✓
build_dataFlowTabel 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 membawa destructiveHint, 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_secret meminta 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