Final POS – Custom POS Builder
आधिकारिकAI के साथ कस्टम POS बनाएं। चेकआउट फ्लो, सेल्फ-चेकआउट कियोस्क और पेमेंट-टर्मिनल ऐप डिज़ाइन करें, उन्हें लाइव प्रीव्यू करें और कार्ड पेमेंट के साथ असली हार्डवेयर पर डिप्लॉय करें। स्टोर भी चलाता है: उत्पाद, स्टॉक, ऑर्डर, ग्राहक और सेल्स रिपोर्ट। रिमोट, OAuth।
Final POS – Custom POS Builder MCP के साथ आप क्या कर सकते हैं?
- विवरण से कस्टम POS ऐप्स बनाएं — अपने असिस्टेंट से चेकआउट फ्लो बनाने के लिए कहें, जैसे कॉफी-शॉप कियोस्क, और लाइव प्रीव्यू लिंक पाएं।
- POS फ्लो को मान्य करें और तैनात करें — अपने ऐप की फ्लो फाइलों का सत्यापन अनुरोध करें, फिर नवीनतम संस्करण अपने पेमेंट टर्मिनलों और कियोस्क पर भेजें।
- इन्वेंट्री की निगरानी और प्रबंधन करें — स्टॉक स्तर जांचें, कम-स्टॉक आइटम खोजें, और अपने सामान्य आपूर्तिकर्ताओं के लिए खरीद ऑर्डर तैयार करें।
- बिक्री प्रदर्शन का विश्लेषण करें — सप्ताहों के बीच श्रेणी के अनुसार बिक्री की तुलना करें या अपने शीर्ष ग्राहकों और उनकी खरीदारी की पहचान करें।
- कैटलॉग और ग्राहकों का प्रबंधन करें — फोटो के साथ स्प्रेडशीट से उत्पाद जोड़ें, या निर्धारित स्टाफ के साथ बुक करने योग्य सेवाएं सेट करें।
होस्ट किया गया MCP सर्वर
npx add-mcp 'https://ai.finalpos.com/mcp'Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है
दस्तावेज़
Final MCP सर्वर: AI के साथ कस्टम POS ऐप्स बनाएं
Claude, ChatGPT, Gemini, Cursor, Codex या किसी भी MCP क्लाइंट को Final से कनेक्ट करें:
Flow (चेकआउट फ्लो, सेल्फ-चेकआउट कियोस्क, भुगतान टर्मिनल) के साथ कस्टम POS ऐप्स बनाएं
और एक ही सर्वर के माध्यम से उनके पीछे के स्टोर को Hub से चलाएं।
https://ai.finalpos.com/mcp
कनेक्ट करें · यह क्या कर सकता है · टूल संदर्भ · FAQ · finalpos.com
Final MCP सर्वर कस्टम पॉइंट ऑफ सेल के लिए कॉमर्स प्लेटफॉर्म, Final के लिए आधिकारिक मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर है।
एक रिमोट एंडपॉइंट, https://ai.finalpos.com/mcp, एक AI एजेंट को व्यापारी द्वारा अनुमत हर Final उत्पाद तक पहुंच प्रदान करता है:
- Flow, कस्टम POS ऐप बिल्डर: एक चेकआउट का वर्णन करें और एजेंट इसे सत्यापित स्क्रीन ब्लूप्रिंट से बनाता है, जो Final के संस्करण-लॉक किए गए POS APIs पर आधारित होता है, फिर इसे मान्य करता है, एक लाइव प्रीव्यू लिंक लौटाता है और इसे भुगतान टर्मिनलों, टैबलेट और कियोस्क पर तैनात करता है। काउंटर POS, सेल्फ-चेकआउट, रेस्तरां ऑर्डरिंग, किचन डिस्प्ले और इन-पर्सन भुगतान ऐप्स।
- Hub, उन ऐप्स के पीछे का बैक ऑफिस: उत्पाद और कैटलॉग, स्टॉक और खरीद ऑर्डर, ऑर्डर, ग्राहक, बिक्री रिपोर्ट, टीम और भूमिकाएं, आउटलेट, कर, बुकिंग।
आप अपने Final खाते (OAuth 2.1) से साइन इन करते हैं और कंपनी चुनते हैं और एजेंट क्या कर सकता है। स्थानीय रूप से इंस्टॉल या चलाने के लिए कुछ भी नहीं है।
| एंडपॉइंट | https://ai.finalpos.com/mcp |
| ट्रांसपोर्ट | स्ट्रीमेबल HTTP |
| प्रमाणीकरण | PKCE के साथ OAuth 2.1 (Final के साथ साइन इन करें), या Authorization: Bearer के रूप में fai_ कनेक्शन कुंजी |
| रजिस्ट्री नाम | com.finalpos/final |
| के रूप में कार्य करता है | वह व्यक्ति जिसने इसे कनेक्ट किया, एक कंपनी पर, उन पैक्स के भीतर जिन्हें उन्होंने अनुमति दी |
| लागत | कनेक्ट करना मुफ्त है; एजेंट जो करता है वह आपकी Final योजना का पालन करता है, जैसे आपने इसे Final में किया हो |
कनेक्ट करें
अधिकांश क्लाइंट्स को केवल URL की आवश्यकता होती है। वे एक Final साइन-इन पेज खोलते हैं जहां आप कंपनी और पैक्स चुनते हैं, फिर वे कनेक्ट हो जाते हैं।
Claude (claude.ai, Claude Desktop)
सेटिंग्स → कनेक्टर्स → कस्टम कनेक्टर जोड़ें, URL https://ai.finalpos.com/mcp।
ChatGPT
सेटिंग्स → ऐप्स और कनेक्टर्स → उन्नत सेटिंग्स → डेवलपर मोड, फिर URL https://ai.finalpos.com/mcp के साथ बनाएं।
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
Claude Code में /mcp चलाएं और प्रमाणित करें चुनें। या प्लगइन इंस्टॉल करें, जो Final प्लेबुक कौशल के साथ सर्वर जोड़ता है। 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
एक्सटेंशन सर्वर, Final प्लेबुक और कमांड जोड़ता है:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate और /final-pos:deploy। Gemini CLI के अंदर /mcp auth final के साथ एक बार साइन इन करें। केवल सर्वर जोड़ने के लिए:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
या ~/.cursor/mcp.json में:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, स्क्रिप्ट्स और OAuth के बिना क्लाइंट्स
ai.finalpos.com/connections पर एक कनेक्शन कुंजी बनाएं।
यह केवल एक बार दिखाई जाती है, और पेज प्रत्येक क्लाइंट के लिए सटीक स्निपेट प्रिंट करता है। Codex के लिए, इसे ~/.codex/config.toml में जोड़ें:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
कोई अन्य क्लाइंट: Authorization: Bearer fai_YOUR_KEY के साथ POST https://ai.finalpos.com/mcp।
sk_(Flow) याfpm_(Hub) से शुरू होने वाली कुंजियाँ उन उत्पादों के अपने सर्वर से संबंधित हैं और यहां स्वीकार नहीं की जाती हैं। इसके बजायfai_कुंजी बनाएं, या OAuth का उपयोग करें।
जांचें कि यह काम करता है
अपने एजेंट से पूछें: "Final का उपयोग करके मुझे बताएं कि आप किस कंपनी से जुड़े हैं और कौन से पैक्स आप उपयोग कर सकते हैं।" यह get_connection और list_packs को कॉल करता है।
आपका एजेंट क्या कर सकता है
टूल्स पैक्स में समूहीकृत हैं। जब आप कनेक्ट करते हैं तो आप चुनते हैं कि एजेंट कौन से पैक्स का उपयोग कर सकता है, और वे OAuth स्कोप भी हैं। मॉडल के संदर्भ को छोटा रखने के लिए, एक कनेक्शन एक समय में केवल कुछ पैक्स सूचीबद्ध करता है। कोर टूल्स बाकी तक पहुंचते हैं: find_tools हर अनुमत पैक खोजता है, और call_tool नाम से किसी भी अनुमत टूल को कॉल करता है।
| पैक | उत्पाद | यह क्या कवर करता है | डिफ़ॉल्ट रूप से सूचीबद्ध |
|---|---|---|---|
catalog | Hub | उत्पाद, वेरिएंट, श्रेणियां, विकल्प, संशोधक, उत्पाद फोटो और मीडिया लाइब्रेरी | ✓ |
inventory | Hub | स्टॉक स्तर और इतिहास, स्थानांतरण, आपूर्तिकर्ता, खरीद ऑर्डर, पुनः ऑर्डर नियम, स्टॉक CSV आयात/निर्यात | |
orders | Hub | ऑर्डर, रिफंड और ई-कॉमर्स ऑर्डर सिंक (केवल पढ़ने के लिए: टिल भुगतान लेता है) | |
customers | Hub | ग्राहक रिकॉर्ड, नोट्स, ऑर्डर इतिहास और ग्राहक आयात | |
reports | Hub | वित्तीय सारांश, बिक्री और भुगतान विवरण, कर्मचारी बिक्री, सत्र, लेनदेन, रिकॉर्ड निर्यात | |
team | Hub | टीम सदस्य, भूमिकाएं और अनुमतियां | |
store | Hub | आउटलेट, स्टेशन, कर और Hub एक्सटेंशन | |
bookings | Hub | बुक करने योग्य सेवाएं: नियम, संसाधन, उपलब्धता, होल्ड और पुष्टिकरण | |
build | Flow | Final POS ऐप्स बनाएं और तैनात करें: API ग्राउंडिंग, ब्लूप्रिंट, फ्लो फाइलें, प्रीव्यू सैंडबॉक्स, मान्यता, तैनाती | ✓ |
build_data | Flow | कस्टम टेबल (ऐप डेटाबेस), सीक्रेट्स वॉल्ट और Flow एक्सटेंशन |
टूल नाम अपने उत्पाद ले जाते हैं: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow। TOOLS.md हर टूल को सूचीबद्ध करता है, उसके पैक के साथ, चाहे वह डेटा बदलता हो, और उसके तर्क।
कोर टूल्स (हमेशा सूचीबद्ध): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company।
पूछने के लिए चीजें
कस्टम POS ऐप्स बनाना (Flow)
- "उत्पाद ग्रिड, संशोधक, कार्ट और कार्ड भुगतान के साथ एक कॉफी-शॉप कियोस्क बनाएं, फिर मुझे एक प्रीव्यू लिंक दें।"
- "मेरे काउंटर ऐप में एक टिप स्क्रीन जोड़ें और इसे मान्य करें।"
- "बारकोड स्कैनिंग और रसीद स्क्रीन के साथ एक छोटे किराना स्टोर के लिए सेल्फ-चेकआउट फ्लो बनाएं।"
- "मेरे सेल्फ-चेकआउट फ्लो का नवीनतम संस्करण भेजें।"
एक ऐप बिल्ड आमतौर पर flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (ग्राउंडिंग) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview चलाता है, और
एक लाइव प्रीव्यू URL लौटाता है। एजेंट जो कुछ भी बनाता है वह Final बिल्डर में भी दिखाई देता है, जहां हर फाइल लेखन एक पुनर्स्थापनीय चेकपॉइंट है।
स्टोर चलाना (Hub)
- "मेन स्ट्रीट आउटलेट पर कौन से उत्पाद अपने पुनः ऑर्डर बिंदु से नीचे हैं? सामान्य आपूर्तिकर्ता के लिए एक खरीद ऑर्डर तैयार करें।"
- "पिछले सप्ताह की बिक्री की तुलना श्रेणी के अनुसार पिछले सप्ताह से करें।"
- "संलग्न स्प्रेडशीट से फोटो के साथ ये 40 उत्पाद जोड़ें।"
- "इस महीने मेरे शीर्ष दस ग्राहक कौन थे, और उन्होंने क्या खरीदा?"
- "दो चिकित्सकों के साथ एक बुक करने योग्य सेवा के रूप में 45 मिनट की मालिश सेट करें।"
सुरक्षा और अनुमतियां
- आपकी भूमिका अभी भी लागू होती है। हर Hub कॉल उस व्यक्ति के रूप में चलती है जिसने कनेक्ट किया, और Hub प्रत्येक कॉल पर उनकी लाइव भूमिका जांचता है। केवल मालिक-विशिष्ट क्रियाएं केवल मालिक-विशिष्ट रहती हैं।
- पैक्स अनुमति हैं। एजेंट केवल उन पैक्स में टूल्स कॉल कर सकता है जिन्हें आपने अनुमति दी है। आप किसी भी समय ai.finalpos.com/connections पर पैक्स बदल सकते हैं या डिस्कनेक्ट कर सकते हैं, और डिस्कनेक्ट करना एक साथ हर टोकन रद्द कर देता है।
- लेखन लेबल किए जाते हैं। रीड टूल्स
readOnlyHintले जाते हैं, और तैनाती और हटानाdestructiveHintले जाते हैं, ताकि क्लाइंट कार्य करने से पहले पूछ सकें। सर्वर एजेंटों को तैनाती, हटाने और थोक परिवर्तनों की पुष्टि आपसे करने के लिए कहता है। - पैसा टिल पर रहता है। भुगतान लेना, रिफंड करना और ऑर्डर रद्द करना MCP पर उपलब्ध नहीं हैं।
- रहस्य कभी भी मॉडल से नहीं गुजरते।
flow_request_secretआपसे बिल्डर में एक API कुंजी दर्ज करने के लिए कहता है। - सब कुछ लॉग किया जाता है। कनेक्शन पेज प्रत्येक कनेक्टेड क्लाइंट और उसके द्वारा की गई हर कॉल को लाइव दिखाता है।
- Flow सीमाएं: Flow प्रति घंटे 30 प्रीव्यू बूट, 12 बिल्ड और तैनाती, और 300 फाइल लेखन की अनुमति देता है।
गोपनीयता और समर्थन
- Final क्या रखता है। कनेक्शन (किसने बनाया, कंपनी और पैक्स), Hub और Flow तक पहुंचने के लिए उपयोग किया जाने वाला टोकन (एन्क्रिप्टेड), और प्रत्येक टूल कॉल का लॉग: टूल, परिणाम, इसमें कितना समय लगा, और संपादित तर्कों और परिणाम के पूर्वावलोकन। आप उस लॉग को कनेक्शन पेज पर देखते हैं।
- Final क्या नहीं देखता। आपकी बातचीत। MCP क्लाइंट टूल कॉल भेजते हैं, उनके आसपास की चैट नहीं।
- डिस्कनेक्ट करना संग्रहीत टोकन हटा देता है और उस कनेक्शन को जारी किए गए हर टोकन को रद्द कर देता है।
- गोपनीयता नीति · शर्तें
- समर्थन: support@finalpos.com। इस गाइड या प्लगइन के साथ समस्याओं के लिए, एक मुद्दा खोलें।
Flow का प्रत्यक्ष एंडपॉइंट
गेटवे से पहले बनाए गए सेटअप अभी भी Flow sk_ कुंजी (रजिस्ट्री नाम com.finalpos.build/final-flows) के साथ https://flow.finalpos.com/api/mcp का उपयोग कर सकते हैं। यह काम करता रहता है, लेकिन नए सेटअप को https://ai.finalpos.com/mcp का उपयोग करना चाहिए, जिसमें Flow शामिल है।
FAQ
Final MCP सर्वर क्या है?
यह Final POS के लिए आधिकारिक MCP सर्वर है। एक रिमोट URL,
https://ai.finalpos.com/mcp, एक AI सहायक को व्यापारी के Final बैक ऑफिस (Hub) को पढ़ने और प्रबंधित करने और पॉइंट-ऑफ-सेल ऐप्स (Flow) बनाने की अनुमति देता है।
क्या ChatGPT या Claude मेरी Final POS इन्वेंट्री प्रबंधित कर सकते हैं?
हाँ। कनेक्ट करते समय inventory पैक की अनुमति दें। एजेंट स्टॉक स्तर जांच सकता है, कम स्टॉक ढूंढ सकता है, पुनः ऑर्डर सुझा सकता है, खरीद ऑर्डर बढ़ा सकता है और प्राप्त माल रिकॉर्ड कर सकता है।
क्या एक AI एजेंट Final पर POS ऐप बना सकता है?
हाँ। build पैक के साथ एजेंट एक फ्लो बनाता है, Final के संस्करण-लॉक किए गए APIs और सत्यापित स्क्रीन ब्लूप्रिंट के खिलाफ ऐप लिखता है, इसे मान्य करता है, और एक लाइव प्रीव्यू URL लौटाता है। आप इसे Final बिल्डर से लॉन्च करते हैं।
क्या मुझे API कुंजी की आवश्यकता है?
नहीं, यदि आपका क्लाइंट OAuth का समर्थन करता है (Claude, ChatGPT, Claude Code, Cursor, Gemini CLI, VS Code): बस Final के साथ साइन इन करें। Codex और स्क्रिप्ट्स ai.finalpos.com/connections से fai_ कुंजी का उपयोग करते हैं।
यह किस कंपनी पर कार्य करता है?
वह जो आप कनेक्ट करते समय चुनते हैं। यदि आपके खाते में कई हैं, तो एजेंट switch_company कॉल कर सकता है।
क्या एजेंट भुगतान ले सकता है या रिफंड जारी कर सकता है?
नहीं। भुगतान, रिफंड और रद्दीकरण टिल पर होते हैं। ऑर्डर MCP पर केवल पढ़ने के लिए होते हैं।
मेरा एजेंट केवल कुछ टूल्स क्यों देखता है?
क्लाइंट हर सूचीबद्ध टूल को मॉडल के संदर्भ में रखते हैं, और लंबी सूचियों के साथ गुणवत्ता घटती है। एजेंट बाकी को find_tools के साथ ढूंढता है, call_tool के साथ कॉल करता है, या enable_packs के साथ एक पूरा पैक सूचीबद्ध करता है।
क्या कोई लागत है?
कनेक्ट करना मुफ्त है। एजेंट जो करता है उसे Final में स्वयं किए गए समान कार्य की तरह, आपकी Final योजना के तहत बिल किया जाता है।
Final POS API दस्तावेज़ कहां हैं?
finalpos.com/docs पर। एक ऐप बनाने वाले एजेंट को उन्हें अलग से आवश्यकता नहीं होती: build पैक हर कॉल को Final के संस्करण-लॉक किए गए APIs (flow_lookup_pos_api, flow_lookup_command_frame) के खिलाफ ग्राउंड करता है।
इस रिपॉजिटरी के बारे में
इस रिपो में सार्वजनिक सेटअप गाइड, MCP रजिस्ट्री प्रविष्टियां
(server.json, legacy/), Gemini CLI एक्सटेंशन
(gemini-extension.json, GEMINI.md, commands/), Claude Code और
Cursor प्लगइन मार्केटप्लेस (.claude-plugin/, .cursor-plugin/, और
plugins/final/, जो दोनों साझा करते हैं) और उत्पन्न
टूल संदर्भ इसके मशीन-पठनीय जुड़वां catalog.json के साथ है,
जिसे https://ai.finalpos.com/.well-known/mcp/server-card.json पर सर्वर कार्ड भी पढ़ता है। GEMINI.md और Claude कौशल एक ही प्लेबुक हैं, और CI जांचता है कि वे मेल खाते हैं। सर्वर स्वयं Final द्वारा होस्ट किया गया है; इस रिपो का कोई कोड आपकी मशीन पर नहीं चलता है।
लाइसेंस
Apache-2.0 © Final Commerce