Final POS MCP server
2026년 10월 18일 커밋AI 에이전트를 통해 맞춤형 POS 애플리케이션을 구축하고 재고, 주문, 판매 보고서를 포함한 소매 운영을 관리합니다.
다른 이름 Final-Commerce/final-pos-mcp, final
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 2.0.1
- 마지막 커밋
- 2026년 10월 18일
- 라이선스
- Apache-2.0
Final POS MCP란?
Final POS은(는) MCP server입니다. AI 에이전트를 통해 맞춤형 POS 애플리케이션을 구축하고 재고, 주문, 판매 보고서를 포함한 소매 운영을 관리합니다.
프로젝트 README에서 생성된 요약
Final POS MCP server 정보
Final MCP server는 Final 커머스 플랫폼에 대한 원격 연결을 제공하여, AI 에이전트가 소매 운영을 관리하고 맞춤형 POS 애플리케이션을 개발할 수 있도록 합니다. 사용자는 단일 HTTP 엔드포인트를 사용하여 Claude, ChatGPT, Gemini, Cursor 또는 VS Code와 같은 클라이언트를 연결할 수 있습니다. 이 서버는 두 가지 주요 제품을 통해 작동합니다. 결제 flow, 셀프 체크아웃 키오스크, 결제 단말기 구축에 사용되는 Flow와 카탈로그, 재고, 주문, 판매 보고서 관리를 위한 백오피스 역할을 하는 Hub가 있습니다.
설정은 OAuth 2.1을 통해 이루어지며, 로그인 페이지에서 회사와 특정 권한 pack을 선택하거나 OAuth를 지원하지 않는 클라이언트를 위해 connection key를 사용할 수 있습니다. 에이전트는 연결된 사용자를 대신하여 동작하며 기존의 역할과 권한을 준수합니다. 서버는 스토어 데이터의 구축 및 관리를 용이하게 하지만, 모델을 통해 실제 결제 처리나 환불을 직접 수행하지는 않습니다. 개발자는 catalog, inventory, build와 같은 특정 pack을 활성화하거나 비활성화하여 에이전트의 작업 범위를 제어할 수 있습니다.
활용 사례
- 1맞춤형 결제 애플리케이션 개발AI 에이전트가 제품 그리드와 카드 결제 기능이 포함된 커피숍 키오스크를 구축하고 라이브 미리보기 링크를 제공할 수 있습니다.
- 2재고 관리 작업 자동화에이전트에게 특정 매장의 재고 부족 품목을 식별하고 공급업체를 위한 구매 주문 초안을 작성하도록 요청할 수 있습니다.
- 3소매 판매 실적 분석개발자가 지난주 대비 카테고리별 판매 데이터 비교를 요청할 수 있습니다.
- 4고객 및 서비스 데이터 관리에이전트가 우수 고객과 구매 이력을 식별하거나 직원을 위한 예약 가능 서비스를 설정할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Final POS MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Final POS MCP 설치
$ claude mcp add --transport http final https://ai.finalpos.com/mcpCursor에 Final POS MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"final": {
"url": "https://ai.finalpos.com/mcp"
}
}
}VS Code에 Final POS MCP 설치
.vscode/mcp.json
{
"servers": {
"final": {
"type": "http",
"url": "https://ai.finalpos.com/mcp"
}
}
}VS Code CLI에 Final POS MCP 설치
$ code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'Codex에 Final POS MCP 설치
$ codex mcp add final --url https://ai.finalpos.com/mcpCodex config.toml에 Final POS MCP 설치
~/.codex/config.toml
[mcp_servers.final] url = "https://ai.finalpos.com/mcp"
Gemini CLI에 Final POS MCP 설치
$ gemini mcp add -s user --transport http final https://ai.finalpos.com/mcpGemini settings.json에 Final POS MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"final": {
"url": "https://ai.finalpos.com/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능final-commerce/final-pos-mcp is public and reachablegithub.com/final-commerce/final-pos-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-18github.com/final-commerce/final-pos-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 516 ms통과
README
GitHub에서 보기The Final MCP server is the official Model Context Protocol server for
Final, the commerce platform for custom point of sale.
One remote endpoint, https://ai.finalpos.com/mcp, gives an AI agent access to
every Final product the merchant allows:
- Flow, the custom POS app builder: describe a checkout and the agent builds it from vetted screen blueprints, grounded in Final's version-locked POS APIs, then validates it, returns a live preview link and deploys it to payment terminals, tablets and kiosks. Counter POS, self-checkout, restaurant ordering, kitchen displays and in-person payment apps.
- Hub, the back office behind those apps: products and catalog, stock and purchase orders, orders, customers, sales reports, team and roles, outlets, taxes, bookings.
You sign in with your Final account (OAuth 2.1) and choose the company and what the agent may do. There is nothing to install or run locally.
| Endpoint | https://ai.finalpos.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with PKCE (sign in with Final), or a fai_ connection key as Authorization: Bearer |
| Registry name | com.finalpos/final |
| Acts as | The person who connected it, on one company, within the packs they allowed |
| Cost | Free to connect; what the agent does follows your Final plan, as if you did it in Final |
Connect
Most clients only need the URL. They open a Final sign-in page where you pick the company and the packs, then they're connected.
Claude (claude.ai, Claude Desktop)
Settings → Connectors → Add custom connector, URL https://ai.finalpos.com/mcp.
ChatGPT
Settings → Apps & Connectors → Advanced settings → Developer mode, then
Create with the URL https://ai.finalpos.com/mcp.
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
Run /mcp in Claude Code and choose Authenticate. Or install the plugin,
which adds the server together with the Final playbook skill. Inside 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
The extension adds the server, the Final playbook and commands:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate and /final-pos:deploy. Sign in once with
/mcp auth final inside Gemini CLI. To add only the server:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
Or in ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
Install in VS Code, or:
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, scripts and clients without OAuth
Create a connection key at ai.finalpos.com/connections.
It is shown once, and the page prints the exact snippet for each client. For
Codex, add this to ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
Any other client: POST https://ai.finalpos.com/mcp with
Authorization: Bearer fai_YOUR_KEY.
Keys that start with
sk_(Flow) orfpm_(Hub) belong to those products' own servers and are not accepted here. Create afai_key instead, or use OAuth.
Check that it works
Ask your agent: "Use Final to tell me which company you're connected to and
which packs you can use." It calls get_connection and list_packs.
What your agent can do
Tools are grouped in packs. When you connect you choose which packs the
agent may use, and those are also the OAuth scopes. To keep the model's context
small, a connection lists only a few packs at a time. The core tools reach the
rest: find_tools searches every allowed pack, and call_tool calls any
allowed tool by name.
| Pack | Product | What it covers | Listed by default |
|---|---|---|---|
catalog |
Hub | Products, variants, categories, options, modifiers, product photos and the media library | ✓ |
inventory |
Hub | Stock levels and history, transfers, suppliers, purchase orders, reorder rules, stock CSV import/export | |
orders |
Hub | Orders, refunds and e-commerce order sync (read-only: the till takes payments) | |
customers |
Hub | Customer records, notes, order history and customer import | |
reports |
Hub | Financial summary, sales and payment breakdowns, employee sales, sessions, transactions, record export | |
team |
Hub | Team members, roles and permissions | |
store |
Hub | Outlets, stations, taxes and Hub extensions | |
bookings |
Hub | Bookable services: rules, resources, availability, holds and confirmations | |
build |
Flow | Build and deploy Final POS apps: API grounding, blueprints, flow files, preview sandboxes, validation, deploy | ✓ |
build_data |
Flow | Custom tables (the app database), the secrets vault and Flow extensions |
Tool names carry their product: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow. TOOLS.md lists every
tool, with its pack, whether it changes data, and its arguments.
Core tools (always listed): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company.
Things to ask
Building custom POS apps (Flow)
- "Build a coffee-shop kiosk with a product grid, modifiers, a cart and card payments, then give me a preview link."
- "Add a tip screen to my counter app and validate it."
- "Create a self-checkout flow for a small grocery store with barcode scanning and a receipt screen."
- "Ship the latest version of my self-checkout flow."
An app build usually runs flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (grounding) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview, and
returns a live preview URL. Everything the agent builds also appears in the
Final builder, where every file write is a restorable checkpoint.
Running the store (Hub)
- "Which products are below their reorder point at the Main Street outlet? Draft a purchase order for the usual supplier."
- "Compare last week's sales by category with the week before."
- "Add these 40 products from the attached spreadsheet, with photos."
- "Who were my top ten customers this month, and what did they buy?"
- "Set up a 45-minute massage as a bookable service with two therapists."
Safety and permissions
- Your role still applies. Every Hub call runs as the person who connected, and Hub checks their live role on each call. Owner-only actions stay owner-only.
- Packs are the permission. The agent can only call tools in the packs you allowed. You can change packs or disconnect at any time at ai.finalpos.com/connections, and disconnecting revokes every token at once.
- Writes are labelled. Read tools carry
readOnlyHint, and deploys and deletes carrydestructiveHint, so clients can ask before acting. The server tells agents to confirm deploys, deletes and bulk changes with you. - Money stays on the till. Taking payments, refunding and voiding orders are not available over MCP.
- Secrets never pass through the model.
flow_request_secretasks you to enter an API key in the builder. - Everything is logged. The Connections page shows each connected client and every call it made, live.
- Flow limits: Flow allows 30 preview boots, 12 builds and deploys, and 300 file writes per hour.
Privacy and support
- What Final keeps. The connection (who made it, the company and the packs), the token it uses to reach Hub and Flow (encrypted), and a log of each tool call: the tool, the outcome, how long it took, and redacted previews of the arguments and result. You see that log on the Connections page.
- What Final doesn't see. Your conversation. MCP clients send tool calls, not the chat around them.
- Disconnecting deletes the stored token and revokes every token issued to that connection.
- Privacy policy · Terms
- Support: support@finalpos.com. For problems with this guide or the plugin, open an issue.
Flow's direct endpoint
Setups made before the gateway may still use https://flow.finalpos.com/api/mcp
with a Flow sk_ key (registry name com.finalpos.build/final-flows). It keeps
working, but new setups should use https://ai.finalpos.com/mcp, which includes
Flow.
FAQ
What is the Final MCP server?
It is the official MCP server for Final POS. One remote URL,
https://ai.finalpos.com/mcp, lets an AI assistant read and manage a
merchant's Final back office (Hub) and build point-of-sale apps (Flow).
Can ChatGPT or Claude manage my Final POS inventory?
Yes. Allow the inventory pack when you connect. The agent can check stock
levels, find low stock, suggest reorders, raise purchase orders and record
received goods.
Can an AI agent build a POS app on Final?
Yes. With the build pack the agent creates a flow, writes the app against
Final's version-locked APIs and vetted screen blueprints, validates it, and
returns a live preview URL. You launch it from the Final builder.
Do I need an API key?
No, if your client supports OAuth (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): just sign in with Final. Codex and scripts use a fai_
key from ai.finalpos.com/connections.
Which company does it act on?
The one you pick when you connect. If your account has several, the agent can
call switch_company.
Can the agent take payments or issue refunds?
No. Payments, refunds and voids happen on the till. Orders are read-only over MCP.
Why does my agent only see a few tools?
Clients put every listed tool into the model's context, and quality drops with
long lists. The agent finds the rest with find_tools, calls them with
call_tool, or lists a whole pack with enable_packs.
Is there a cost?
Connecting is free. What the agent does is billed like the same work done in Final yourself, under your Final plan.
Where are the Final POS API docs?
At finalpos.com/docs. An agent building an app
doesn't need them separately: the build pack grounds every call against
Final's version-locked APIs (flow_lookup_pos_api,
flow_lookup_command_frame).
About this repository
This repo holds the public setup guide, the MCP Registry entries
(server.json, legacy/), the Gemini CLI extension
(gemini-extension.json, GEMINI.md, commands/), the Claude Code and
Cursor plugin marketplaces (.claude-plugin/, .cursor-plugin/, and
plugins/final/, which both share) and the generated
tool reference with its machine-readable twin catalog.json,
which the server card at https://ai.finalpos.com/.well-known/mcp/server-card.json
also reads. GEMINI.md and the Claude skill are the same
playbook, and CI checks that they match. The server itself is hosted by Final;
no code from this repo runs on your machine.
License
Apache-2.0 © Final Commerce
Final POS MCP 질문
Final POS MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http final https://ai.finalpos.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Final POS MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Final MCP server란 무엇인가요?
Final POS를 위한 공식 MCP server로, AI 어시스턴트가 판매자의 백오피스(Hub)를 관리하고 POS 앱(Flow)을 구축할 수 있도록 지원합니다.
ChatGPT나 Claude로 Final POS 재고를 관리할 수 있나요?
네, 연결 시 inventory pack을 허용하면 에이전트가 재고 수준 확인, 재고 부족 품목 검색, 구매 주문 관리를 수행할 수 있습니다.
AI 에이전트가 Final에서 POS 앱을 만들 수 있나요?
네, build pack을 사용하면 에이전트가 flow를 생성하고, 검증된 블루프린트를 바탕으로 앱을 작성하며, 이를 검증한 뒤 라이브 미리보기 URL을 제공할 수 있습니다.
API key가 필요한가요?
클라이언트가 OAuth를 지원하면 별도의 키 없이 Final 계정으로 로그인하면 됩니다. Codex와 같은 클라이언트나 스크립트의 경우 fai_ connection key를 사용합니다.