Final POS – Custom POS Builder
공식AI로 맞춤형 POS를 구축하세요. 체크아웃 흐름, 셀프 체크아웃 키오스크, 결제 단말기 앱을 설계하고, 실시간으로 미리 보며 카드 결제가 가능한 실제 하드웨어에 배포할 수 있습니다. 또한 매장 운영도 지원합니다: 상품, 재고, 주문, 고객, 판매 보고서. 원격, OAuth.
Final POS – Custom POS Builder MCP(으)로 무엇을 할 수 있나요?
- Build custom POS apps from a description — 어시스턴트에게 체크아웃 플로우(예: 커피숍 키오스크)를 만들어 달라고 요청하고, 실시간 미리보기 링크를 받아보세요.
- Validate and deploy POS flows — 앱의 플로우 파일 검증을 요청한 후, 최신 버전을 결제 단말기와 키오스크에 배포하세요.
- Monitor and manage inventory — 재고 수준을 확인하고, 재고 부족 품목을 찾아 평소 거래처에 대한 구매 발주서를 작성하세요.
- Analyze sales performance — 주간별 카테고리별 매출을 비교하거나, 주요 고객과 그들의 구매 내역을 파악하세요.
- Manage catalog and customers — 사진이 포함된 스프레드시트에서 제품을 추가하거나, 담당 직원을 지정한 예약 가능한 서비스를 설정하세요.
호스팅형 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 서버는 맞춤형 판매 시점(POS)을 위한 커머스 플랫폼인
Final의 공식 Model Context Protocol 서버입니다.
하나의 원격 엔드포인트 https://ai.finalpos.com/mcp를 통해 AI 에이전트가 판매자가 허용한 모든 Final 제품에 접근할 수 있습니다:
- Flow, 맞춤형 POS 앱 빌더: 체크아웃을 설명하면 에이전트가 검증된 화면 청사진을 기반으로, Final의 버전 고정 POS API에 근거하여 앱을 구축하고, 검증한 후, 실시간 미리보기 링크를 반환하고 결제 단말기, 태블릿, 키오스크에 배포합니다. 카운터 POS, 셀프 체크아웃, 레스토랑 주문, 주방 디스플레이 및 대면 결제 앱.
- Hub, 이러한 앱 뒤의 백오피스: 제품 및 카탈로그, 재고 및 구매 주문, 주문, 고객, 판매 보고서, 팀 및 역할, 매장, 세금, 예약.
Final 계정(OAuth 2.1)으로 로그인하고 회사와 에이전트가 수행할 수 있는 작업을 선택합니다. 로컬에 설치하거나 실행할 것이 없습니다.
| 엔드포인트 | https://ai.finalpos.com/mcp |
| 전송 방식 | Streamable HTTP |
| 인증 | OAuth 2.1 with PKCE(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)
VS Code에 설치, 또는:
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)
- "Main Street 매장에서 재주문 지점 아래에 있는 제품은 무엇인가요? 평소 공급업체에 대한 구매 주문 초안을 작성해줘."
- "지난주 판매를 카테고리별로 그 전주와 비교해줘."
- "첨부된 스프레드시트에서 사진과 함께 이 40개 제품을 추가해줘."
- "이번 달 상위 10명의 고객은 누구이며 무엇을 구매했나요?"
- "두 명의 치료사와 함께 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을 사용할 수 있습니다. 계속 작동하지만, 새 설정은 Flow를 포함하는 https://ai.finalpos.com/mcp을 사용해야 합니다.
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의 버전 고정 API 및 검증된 화면 청사진에 대해 앱을 작성하고, 검증한 후 실시간 미리보기 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의 버전 고정 API(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이 호스팅합니다. 이 저장소의 코드는 사용자 컴퓨터에서 실행되지 않습니다.
License
Apache-2.0 © Final Commerce