Final POS – Custom POS Builder

resmi

Yapay zeka ile özel POS oluşturun. Ödeme akışları, self-checkout kioskları ve ödeme terminali uygulamaları tasarlayın, canlı önizleyin ve kart ödemeli gerçek donanıma dağıtın. Ayrıca mağazayı yönetir: ürünler, stok, siparişler, müşteriler ve satış raporları. Uzaktan, OAuth.

Final POS – Custom POS Builder MCP ile neler yapabilirsiniz?

  • Açıklamadan özel POS uygulamaları oluşturun — Asistanınızdan bir kahve dükkânı kiosku gibi bir ödeme akışı oluşturmasını isteyin ve canlı önizleme bağlantısı alın.
  • POS akışlarını doğrulayın ve dağıtın — Uygulamanızın akış dosyalarının doğrulanmasını talep edin, ardından en son sürümü ödeme terminallerinize ve kiosklarınıza gönderin.
  • Envanteri izleyin ve yönetin — Stok seviyelerini kontrol edin, düşük stoklu ürünleri bulun ve olağan tedarikçileriniz için satın alma siparişleri taslağı hazırlayın.
  • Satış performansını analiz edin — Kategorilere göre haftalar arası satışları karşılaştırın veya en iyi müşterilerinizi ve satın alımlarını belirleyin.
  • Kataloğu ve müşterileri yönetin — Fotoğraflarla birlikte bir elektronik tablodan ürün ekleyin veya atanmış personelle rezervasyon yapılabilir hizmetler oluşturun.

Barındırılan MCP Sunucusu

npx add-mcp 'https://ai.finalpos.com/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Final

Final MCP sunucusu: yapay zekâ ile özel POS uygulamaları oluşturun

Claude, ChatGPT, Gemini, Cursor, Codex veya herhangi bir MCP istemcisini Final sunucusuna bağlayın:
Flow ile özel POS uygulamaları oluşturun (ödeme akışları, self-checkout kioskları, ödeme terminalleri)
ve arkalarındaki mağazayı Hub üzerinden, tek bir sunucu aracılığıyla yönetin.

https://ai.finalpos.com/mcp

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

Bağlan · Neler yapabilir · Araç referansı · SSS · finalpos.com


Final MCP sunucusu, özel satış noktası için ticaret platformu olan Final için resmî Model Context Protocol sunucusudur. Tek bir uzak uç nokta, https://ai.finalpos.com/mcp, bir yapay zekâ aracısına satıcının izin verdiği her Final ürününe erişim sağlar:

  • Flow, özel POS uygulama oluşturucusu: bir ödeme akışı tanımlayın, aracı bunu Final'in sürüme kilitli POS API'lerine dayanan, doğrulanmış ekran şablonlarından oluştursun, ardından doğrulasın, canlı bir önizleme bağlantısı döndürsün ve ödeme terminallerine, tabletlere ve kiosklara dağıtsın. Tezgâh POS'u, self-checkout, restoran siparişi, mutfak ekranları ve yüz yüze ödeme uygulamaları.
  • Hub, bu uygulamaların arkasındaki arka ofis: ürünler ve katalog, stok ve satın alma siparişleri, siparişler, müşteriler, satış raporları, ekip ve roller, şubeler, vergiler, rezervasyonlar.

Final hesabınızla (OAuth 2.1) oturum açarsınız ve şirketi ve aracının neler yapabileceğini seçersiniz. Yerel olarak kurulacak veya çalıştırılacak hiçbir şey yoktur.

Uç noktahttps://ai.finalpos.com/mcp
TaşımaStreamable HTTP
Kimlik doğrulamaPKCE ile OAuth 2.1 (Final ile oturum açma) veya Authorization: Bearer olarak bir fai_ bağlantı anahtarı
Kayıt adıcom.finalpos/final
Şu olarak davranırBağlayan kişi, tek bir şirket üzerinde, izin verdiği paketler dahilinde
MaliyetBağlanmak ücretsizdir; aracının yaptıkları, sizin Final'de yaptığınız gibi Final planınıza tabidir

Bağlan

Çoğu istemci yalnızca URL'ye ihtiyaç duyar. Şirketi ve paketleri seçtiğiniz bir Final oturum açma sayfası açılır, ardından bağlantı kurulur.

Claude (claude.ai, Claude Desktop)

Settings → Connectors → Add custom connector, URL https://ai.finalpos.com/mcp.

ChatGPT

Settings → Apps & Connectors → Advanced settings → Developer mode, ardından https://ai.finalpos.com/mcp URL'siyle Create.

Claude Code

claude mcp add --transport http final https://ai.finalpos.com/mcp

Claude Code'da /mcp komutunu çalıştırın ve Authenticate seçin. Veya sunucuyu Final playbook becerisiyle birlikte ekleyen eklentiyi kurun. Claude Code içinde:

/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

Uzantı sunucuyu, Final playbook'u ve komutları ekler: /final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview, /final-pos:validate ve /final-pos:deploy. Gemini CLI içinde bir kez /mcp auth final ile oturum açın. Yalnızca sunucuyu eklemek için:

gemini mcp add --transport http final https://ai.finalpos.com/mcp

Cursor

Add to Cursor

Veya ~/.cursor/mcp.json içinde:

{
  "mcpServers": {
    "final": { "url": "https://ai.finalpos.com/mcp" }
  }
}

VS Code (GitHub Copilot)

VS Code'da yükle veya:

code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'

Codex, betikler ve OAuth olmayan istemciler

ai.finalpos.com/connections adresinde bir bağlantı anahtarı oluşturun. Yalnızca bir kez gösterilir ve sayfa her istemci için tam kod parçacığını yazdırır. Codex için bunu ~/.codex/config.toml dosyasına ekleyin:

[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }

Diğer tüm istemciler: Authorization: Bearer fai_YOUR_KEY ile POST https://ai.finalpos.com/mcp.

sk_ (Flow) veya fpm_ (Hub) ile başlayan anahtarlar o ürünlerin kendi sunucularına aittir ve burada kabul edilmez. Bunun yerine bir fai_ anahtarı oluşturun veya OAuth kullanın.

Çalıştığını doğrulayın

Aracınıza sorun: "Final'i kullanarak hangi şirkete bağlı olduğunu ve hangi paketleri kullanabileceğini söyle." Aracı get_connection ve list_packs araçlarını çağırır.

Aracınız neler yapabilir

Araçlar paketler halinde gruplanmıştır. Bağlanırken aracının hangi paketleri kullanabileceğini seçersiniz ve bunlar aynı zamanda OAuth kapsamlarıdır. Modelin bağlamını küçük tutmak için bir bağlantı aynı anda yalnızca birkaç paket listeler. Çekirdek araçlar geri kalanına erişir: find_tools izin verilen her pakette arama yapar ve call_tool izin verilen herhangi bir aracı adıyla çağırır.

PaketÜrünNeleri kapsarVarsayılan olarak listelenir
catalogHubÜrünler, varyantlar, kategoriler, seçenekler, değiştiriciler, ürün fotoğrafları ve medya kütüphanesi✓
inventoryHubStok seviyeleri ve geçmişi, transferler, tedarikçiler, satın alma siparişleri, yeniden sipariş kuralları, stok CSV içe/dışa aktarma
ordersHubSiparişler, iadeler ve e-ticaret sipariş senkronizasyonu (salt okunur: ödemeleri kasa alır)
customersHubMüşteri kayıtları, notlar, sipariş geçmişi ve müşteri içe aktarma
reportsHubFinansal özet, satış ve ödeme dökümleri, çalışan satışları, oturumlar, işlemler, kayıt dışa aktarma
teamHubEkip üyeleri, roller ve izinler
storeHubŞubeler, istasyonlar, vergiler ve Hub uzantıları
bookingsHubRezerve edilebilir hizmetler: kurallar, kaynaklar, uygunluk, geçici tutmalar ve onaylar
buildFlowFinal POS uygulamaları oluşturun ve dağıtın: API temellendirme, şablonlar, flow dosyaları, önizleme korumalı alanları, doğrulama, dağıtım✓
build_dataFlowÖzel tablolar (uygulama veritabanı), gizli bilgi kasası ve Flow uzantıları

Araç adları ürünlerini taşır: hub_get_products, hub_find_low_stock, flow_create_flow, flow_deploy_flow. TOOLS.md her aracı listeler, paketiyle, veriyi değiştirip değiştirmediğiyle ve argümanlarıyla.

Çekirdek araçlar (her zaman listelenir): get_connection, list_packs, find_tools, call_tool, enable_packs, disable_packs, switch_company.

Sorulabilecek şeyler

Özel POS uygulamaları oluşturma (Flow)

  • "Ürün ızgarası, değiştiriciler, sepet ve kart ödemeleri içeren bir kahve dükkânı kiosku oluştur, ardından bana bir önizleme bağlantısı ver."
  • "Tezgâh uygulamama bir bahşiş ekranı ekle ve doğrula."
  • "Barkod tarama ve fiş ekranı içeren küçük bir market için self-checkout akışı oluştur."
  • "Self-checkout akışımın en son sürümünü yayınla."

Bir uygulama oluşturma genellikle flow_get_scaffold → flow_create_flow → flow_lookup_command_frame (temellendirme) → flow_get_blueprint → flow_write_flow_files → flow_validate_flow → flow_start_preview sırasıyla çalışır ve canlı bir önizleme URL'si döndürür. Aracının oluşturduğu her şey Final oluşturucusunda da görünür; burada her dosya yazımı geri yüklenebilir bir kontrol noktasıdır.

Mağazayı yönetme (Hub)

  • "Main Street şubesinde hangi ürünler yeniden sipariş noktasının altında? Her zamanki tedarikçi için bir satın alma siparişi taslağı hazırla."
  • "Geçen haftanın kategoriye göre satışlarını bir önceki haftayla karşılaştır."
  • "Ekli tablodaki bu 40 ürünü fotoğraflarıyla birlikte ekle."
  • "Bu ay en iyi on müşterim kimdi ve ne satın aldılar?"
  • "45 dakikalık bir masajı iki terapistle rezerve edilebilir hizmet olarak ayarla."

Güvenlik ve izinler

  • Rolünüz hâlâ geçerlidir. Her Hub çağrısı bağlanan kişi olarak çalışır ve Hub her çağrıda onların canlı rolünü kontrol eder. Yalnızca sahibe özel işlemler yalnızca sahibe özel kalır.
  • Paketler izindir. Aracı yalnızca izin verdiğiniz paketlerdeki araçları çağırabilir. Paketleri istediğiniz zaman değiştirebilir veya ai.finalpos.com/connections adresinden bağlantıyı kesebilirsiniz; bağlantıyı kesmek tüm belirteçleri tek seferde iptal eder.
  • Yazma işlemleri etiketlenir. Okuma araçları readOnlyHint taşır; dağıtımlar ve silmeler destructiveHint taşır, böylece istemciler işlem yapmadan önce sorabilir. Sunucu, aracılara dağıtımları, silmeleri ve toplu değişiklikleri sizinle onaylamalarını söyler.
  • Para kasada kalır. Ödeme alma, iade etme ve sipariş iptali MCP üzerinden kullanılamaz.
  • Gizli bilgiler modelden geçmez. flow_request_secret sizden oluşturucuda bir API anahtarı girmenizi ister.
  • Her şey günlüğe kaydedilir. Bağlantılar sayfası her bağlı istemciyi ve yaptığı her çağrıyı canlı olarak gösterir.
  • Flow sınırları: Flow saatte 30 önizleme başlatma, 12 oluşturma ve dağıtım ve 300 dosya yazımına izin verir.

Gizlilik ve destek

  • Final'in sakladıkları. Bağlantı (kimin kurduğu, şirket ve paketler), Hub ve Flow'a erişmek için kullandığı belirteç (şifrelenmiş) ve her araç çağrısının günlüğü: araç, sonuç, ne kadar sürdüğü ve argümanların ve sonucun gizlenmiş önizlemeleri. Bu günlüğü Bağlantılar sayfasında görürsünüz.
  • Final'in görmedikleri. Sohbetiniz. MCP istemcileri araç çağrılarını gönderir, etraflarındaki sohbeti değil.
  • Bağlantıyı kesmek saklanan belirteci siler ve o bağlantıya verilen her belirteci iptal eder.
  • Gizlilik politikası · Koşullar
  • Destek: support@finalpos.com. Bu kılavuz veya eklentiyle ilgili sorunlar için bir sorun açın.

Flow'un doğrudan uç noktası

Ağ geçidinden önce yapılan kurulumlar hâlâ bir Flow sk_ anahtarıyla https://flow.finalpos.com/api/mcp kullanıyor olabilir (kayıt adı com.finalpos.build/final-flows). Çalışmaya devam eder, ancak yeni kurulumlar Flow'u içeren https://ai.finalpos.com/mcp kullanmalıdır.

SSS

Final MCP sunucusu nedir?

Final POS için resmî MCP sunucusudur. Tek bir uzak URL, https://ai.finalpos.com/mcp, bir yapay zekâ asistanının bir satıcının Final arka ofisini (Hub) okumasına ve yönetmesine ve satış noktası uygulamaları (Flow) oluşturmasına olanak tanır.

ChatGPT veya Claude Final POS envanterimi yönetebilir mi?

Evet. Bağlanırken inventory paketine izin verin. Aracı stok seviyelerini kontrol edebilir, düşük stoğu bulabilir, yeniden sipariş önerebilir, satın alma siparişleri oluşturabilir ve teslim alınan malları kaydedebilir.

Bir yapay zekâ aracısı Final'de POS uygulaması oluşturabilir mi?

Evet. build paketiyle aracı bir flow oluşturur, uygulamayı Final'in sürüme kilitli API'lerine ve doğrulanmış ekran şablonlarına göre yazar, doğrular ve canlı bir önizleme URL'si döndürür. Uygulamayı Final oluşturucusundan başlatırsınız.

API anahtarına ihtiyacım var mı?

İstemciniz OAuth'u destekliyorsa (Claude, ChatGPT, Claude Code, Cursor, Gemini CLI, VS Code) hayır: yalnızca Final ile oturum açın. Codex ve betikler ai.finalpos.com/connections adresinden bir fai_ anahtarı kullanır.

Hangi şirket üzerinde işlem yapar?

Bağlanırken seçtiğiniz şirket üzerinde. Hesabınızda birden fazla varsa aracı switch_company aracını çağırabilir.

Aracı ödeme alabilir veya iade yapabilir mi?

Hayır. Ödemeler, iadeler ve iptaller kasada gerçekleşir. Siparişler MCP üzerinden salt okunurdur.

Aracım neden yalnızca birkaç araç görüyor?

İstemciler listelenen her aracı modelin bağlamına koyar ve uzun listelerle kalite düşer. Aracı geri kalanını find_tools ile bulur, call_tool ile çağırır veya bir paketin tamamını enable_packs ile listeler.

Bir maliyeti var mı?

Bağlanmak ücretsizdir. Aracının yaptıkları, aynı işi Final'de kendiniz yapmışsınız gibi, Final planınız kapsamında faturalandırılır.

Final POS API belgeleri nerede?

finalpos.com/docs adresinde. Uygulama oluşturan bir aracının bunlara ayrıca ihtiyacı yoktur: build paketi her çağrıyı Final'in sürüme kilitli API'lerine (flow_lookup_pos_api, flow_lookup_command_frame) göre temellendirir.

Bu depo hakkında

Bu depo, genel kurulum kılavuzunu, MCP Registry girdilerini (server.json, legacy/), Gemini CLI uzantısını (gemini-extension.json, GEMINI.md, commands/), Claude Code ve Cursor eklenti pazaryerlerini (.claude-plugin/, .cursor-plugin/ ve ikisinin de paylaştığı plugins/final/) ve oluşturulan araç referansını makine tarafından okunabilir eşi catalog.json ile birlikte barındırır; https://ai.finalpos.com/.well-known/mcp/server-card.json adresindeki sunucu kartı da bunu okur. GEMINI.md ve Claude becerisi aynı playbook'tur ve CI bunların eşleştiğini kontrol eder. Sunucunun kendisi Final tarafından barındırılır; bu depodaki hiçbir kod makinenizde çalışmaz.

Lisans

Apache-2.0 © Final Commerce