Final POS – Custom POS Builder
resmiYapay 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 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
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ç nokta | https://ai.finalpos.com/mcp |
| Taşıma | Streamable HTTP |
| Kimlik doğrulama | PKCE 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ır | Bağlayan kişi, tek bir şirket üzerinde, izin verdiği paketler dahilinde |
| Maliyet | Bağ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
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) veyafpm_(Hub) ile başlayan anahtarlar o ürünlerin kendi sunucularına aittir ve burada kabul edilmez. Bunun yerine birfai_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ün | Neleri kapsar | Varsayılan olarak listelenir |
|---|---|---|---|
catalog | Hub | Ürünler, varyantlar, kategoriler, seçenekler, değiştiriciler, ürün fotoğrafları ve medya kütüphanesi | ✓ |
inventory | Hub | Stok seviyeleri ve geçmişi, transferler, tedarikçiler, satın alma siparişleri, yeniden sipariş kuralları, stok CSV içe/dışa aktarma | |
orders | Hub | Siparişler, iadeler ve e-ticaret sipariş senkronizasyonu (salt okunur: ödemeleri kasa alır) | |
customers | Hub | Müşteri kayıtları, notlar, sipariş geçmişi ve müşteri içe aktarma | |
reports | Hub | Finansal özet, satış ve ödeme dökümleri, çalışan satışları, oturumlar, işlemler, kayıt dışa aktarma | |
team | Hub | Ekip üyeleri, roller ve izinler | |
store | Hub | Şubeler, istasyonlar, vergiler ve Hub uzantıları | |
bookings | Hub | Rezerve edilebilir hizmetler: kurallar, kaynaklar, uygunluk, geçici tutmalar ve onaylar | |
build | Flow | Final POS uygulamaları oluşturun ve dağıtın: API temellendirme, şablonlar, flow dosyaları, önizleme korumalı alanları, doğrulama, dağıtım | ✓ |
build_data | Flow | Ö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ı
readOnlyHinttaşır; dağıtımlar ve silmelerdestructiveHinttaşı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_secretsizden 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