Final POS – Custom POS Builder
offiziellErstellen Sie ein individuelles POS-System mit KI. Entwerfen Sie Checkout-Abläufe, Self-Checkout-Kioske und Zahlungsterminal-Apps, zeigen Sie sie live in der Vorschau an und stellen Sie sie auf echter Hardware mit Kartenzahlungen bereit. Verwaltet auch den Laden: Produkte, Lagerbestand, Bestellungen, Kunden und Verkaufsberichte. Remote, OAuth.
Was kann man mit Final POS – Custom POS Builder MCP machen?
- Erstellen Sie benutzerdefinierte POS-Apps anhand einer Beschreibung — Bitten Sie Ihren Assistenten, einen Checkout-Ablauf zu erstellen, etwa einen Kiosk für ein Café, und erhalten Sie einen Live-Vorschau-Link.
- Validieren und bereitstellen von POS-Abläufen — Fordern Sie die Validierung der Flow-Dateien Ihrer App an und bringen Sie dann die neueste Version auf Ihre Zahlungsterminals und Kioske.
- Inventar überwachen und verwalten — Prüfen Sie Lagerbestände, finden Sie Artikel mit niedrigem Bestand und erstellen Sie Bestellentwürfe für Ihre üblichen Lieferanten.
- Verkaufsleistung analysieren — Vergleichen Sie Verkäufe nach Kategorie über Wochen hinweg oder identifizieren Sie Ihre Top-Kunden und deren Einkäufe.
- Katalog und Kunden verwalten — Fügen Sie Produkte aus einer Tabelle mit Fotos hinzu oder richten Sie buchbare Dienstleistungen mit zugewiesenem Personal ein.
Gehosteter MCP-Server
npx add-mcp 'https://ai.finalpos.com/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
Final MCP-Server: Erstelle individuelle POS-Apps mit KI
Verbinde Claude, ChatGPT, Gemini, Cursor, Codex oder einen beliebigen MCP-Client mit Final:
erstelle individuelle POS-Apps mit Flow (Checkout-Abläufe, Self-Checkout-Kioske, Zahlungsterminals)
und verwalte den dahinterstehenden Store über Hub, über einen einzigen Server.
https://ai.finalpos.com/mcp
Verbinden · Was er kann · Tool-Referenz · FAQ · finalpos.com
Der Final MCP-Server ist der offizielle Model Context Protocol Server für
Final, die Commerce-Plattform für individuelle Kassensysteme.
Ein einziger Remote-Endpunkt, https://ai.finalpos.com/mcp, gibt einem KI-Agenten Zugriff auf
jedes Final-Produkt, das der Händler erlaubt:
- Flow, der Builder für individuelle POS-Apps: Beschreibe einen Checkout und der Agent baut ihn aus geprüften Bildschirm-Blaupausen, basierend auf Finals versionierten POS-APIs, validiert ihn, liefert einen Live-Vorschau-Link und stellt ihn auf Zahlungsterminals, Tablets und Kiosken bereit. Kassen-POS, Self-Checkout, Restaurant-Bestellung, Küchenanzeigen und Zahlungs-Apps für den persönlichen Verkauf.
- Hub, das Backoffice hinter diesen Apps: Produkte und Katalog, Lagerbestand und Bestellungen, Aufträge, Kunden, Verkaufsberichte, Team und Rollen, Filialen, Steuern, Buchungen.
Du meldest dich mit deinem Final-Konto an (OAuth 2.1) und wählst das Unternehmen und das aus, was der Agent tun darf. Es muss nichts installiert oder lokal ausgeführt werden.
| Endpunkt | https://ai.finalpos.com/mcp |
| Transport | Streamable HTTP |
| Authentifizierung | OAuth 2.1 mit PKCE (Anmeldung mit Final) oder ein fai_-Verbindungsschlüssel als Authorization: Bearer |
| Registrierungsname | com.finalpos/final |
| Agiert als | Die Person, die es verbunden hat, für ein Unternehmen, innerhalb der erlaubten Pakete |
| Kosten | Kostenlos zu verbinden; was der Agent tut, folgt deinem Final-Plan, als ob du es selbst in Final tun würdest |
Verbinden
Die meisten Clients benötigen nur die URL. Sie öffnen eine Final-Anmeldeseite, auf der du das Unternehmen und die Pakete auswählst, dann sind sie verbunden.
Claude (claude.ai, Claude Desktop)
Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, URL https://ai.finalpos.com/mcp.
ChatGPT
Einstellungen → Apps & Connectors → Erweiterte Einstellungen → Entwicklermodus, dann
Erstellen mit der URL https://ai.finalpos.com/mcp.
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
Führe /mcp in Claude Code aus und wähle Authentifizieren. Oder installiere das Plugin,
das den Server zusammen mit dem Final-Playbook-Skill hinzufügt. In 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
Die Erweiterung fügt den Server, das Final-Playbook und Befehle hinzu:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate und /final-pos:deploy. Melde dich einmal mit
/mcp auth final in Gemini CLI an. Um nur den Server hinzuzufügen:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
Oder in ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
In VS Code installieren, oder:
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, Skripte und Clients ohne OAuth
Erstelle einen Verbindungsschlüssel unter ai.finalpos.com/connections.
Er wird nur einmal angezeigt, und die Seite gibt den genauen Snippet für jeden Client aus. Für
Codex füge dies zu ~/.codex/config.toml hinzu:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
Jeder andere Client: POST https://ai.finalpos.com/mcp mit
Authorization: Bearer fai_YOUR_KEY.
Schlüssel, die mit
sk_(Flow) oderfpm_(Hub) beginnen, gehören zu den eigenen Servern dieser Produkte und werden hier nicht akzeptiert. Erstelle stattdessen einenfai_-Schlüssel oder verwende OAuth.
Prüfen, ob es funktioniert
Frage deinen Agenten: „Verwende Final, um mir zu sagen, mit welchem Unternehmen du verbunden bist und
welche Pakete du verwenden kannst." Er ruft get_connection und list_packs auf.
Was dein Agent tun kann
Tools sind in Paketen gruppiert. Wenn du dich verbindest, wählst du aus, welche Pakete der
Agent verwenden darf, und diese sind auch die OAuth-Bereiche. Um den Kontext des Modells klein
zu halten, listet eine Verbindung jeweils nur wenige Pakete auf. Die Kern-Tools erreichen den
Rest: find_tools durchsucht jedes erlaubte Paket, und call_tool ruft jedes
erlaubte Tool namentlich auf.
| Paket | Produkt | Was es abdeckt | Standardmäßig aufgelistet |
|---|---|---|---|
catalog | Hub | Produkte, Varianten, Kategorien, Optionen, Modifikatoren, Produktfotos und die Medienbibliothek | ✓ |
inventory | Hub | Lagerbestände und -verlauf, Umlagerungen, Lieferanten, Bestellungen, Nachbestellregeln, Lager-CSV-Import/Export | |
orders | Hub | Aufträge, Rückerstattungen und E-Commerce-Auftragssynchronisierung (schreibgeschützt: die Kasse nimmt Zahlungen entgegen) | |
customers | Hub | Kundendatensätze, Notizen, Bestellverlauf und Kundenimport | |
reports | Hub | Finanzübersicht, Verkaufs- und Zahlungsaufschlüsselungen, Mitarbeiterverkäufe, Sitzungen, Transaktionen, Datensatzexport | |
team | Hub | Teammitglieder, Rollen und Berechtigungen | |
store | Hub | Filialen, Stationen, Steuern und Hub-Erweiterungen | |
bookings | Hub | Buchbare Dienstleistungen: Regeln, Ressourcen, Verfügbarkeit, Reservierungen und Bestätigungen | |
build | Flow | Erstellen und Bereitstellen von Final POS-Apps: API-Grundlage, Blaupausen, Flow-Dateien, Vorschau-Sandboxes, Validierung, Bereitstellung | ✓ |
build_data | Flow | Benutzerdefinierte Tabellen (die App-Datenbank), der Secrets-Tresor und Flow-Erweiterungen |
Toolnamen tragen ihr Produkt: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow. TOOLS.md listet jedes
Tool auf, mit seinem Paket, ob es Daten ändert, und seinen Argumenten.
Kern-Tools (immer aufgelistet): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company.
Beispielfragen
Erstellen individueller POS-Apps (Flow)
- „Baue einen Coffee-Shop-Kiosk mit Produktraster, Modifikatoren, Warenkorb und Kartenzahlung und gib mir dann einen Vorschau-Link."
- „Füge meiner Kassen-App einen Trinkgeld-Bildschirm hinzu und validiere ihn."
- „Erstelle einen Self-Checkout-Ablauf für einen kleinen Lebensmittelladen mit Barcode-Scan und Belegbildschirm."
- „Veröffentliche die neueste Version meines Self-Checkout-Ablaufs."
Ein App-Build läuft normalerweise über flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (Grundlage) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview und
liefert eine Live-Vorschau-URL. Alles, was der Agent erstellt, erscheint auch im
Final-Builder, wo jeder Dateischreibvorgang ein wiederherstellbarer Prüfpunkt ist.
Den Store betreiben (Hub)
- „Welche Produkte liegen in der Filiale Main Street unter ihrem Nachbestellpunkt? Entwirf eine Bestellung für den üblichen Lieferanten."
- „Vergleiche die Verkäufe der letzten Woche nach Kategorie mit der Woche davor."
- „Füge diese 40 Produkte aus der angehängten Tabelle mit Fotos hinzu."
- „Wer waren meine Top-Ten-Kunden diesen Monat, und was haben sie gekauft?"
- „Richte eine 45-minütige Massage als buchbare Dienstleistung mit zwei Therapeuten ein."
Sicherheit und Berechtigungen
- Deine Rolle gilt weiterhin. Jeder Hub-Aufruf läuft als die Person, die verbunden hat, und Hub prüft ihre aktuelle Rolle bei jedem Aufruf. Nur-Besitzer-Aktionen bleiben Nur-Besitzer-Aktionen.
- Pakete sind die Berechtigung. Der Agent kann nur Tools in den Paketen aufrufen, die du erlaubt hast. Du kannst Pakete jederzeit ändern oder die Verbindung trennen unter ai.finalpos.com/connections, und das Trennen widerruft alle Token auf einmal.
- Schreibvorgänge sind gekennzeichnet. Lese-Tools tragen
readOnlyHint, und Bereitstellungen und Löschungen tragendestructiveHint, sodass Clients vor dem Handeln fragen können. Der Server weist Agenten an, Bereitstellungen, Löschungen und Massenänderungen mit dir zu bestätigen. - Geld bleibt an der Kasse. Zahlungen entgegennehmen, Rückerstattungen und Stornierungen von Aufträgen sind über MCP nicht verfügbar.
- Geheimnisse gehen nie durch das Modell.
flow_request_secretfordert dich auf, einen API-Schlüssel im Builder einzugeben. - Alles wird protokolliert. Die Verbindungsseite zeigt jeden verbundenen Client und jeden Aufruf, den er getätigt hat, live an.
- Flow-Limits: Flow erlaubt 30 Vorschau-Starts, 12 Builds und Bereitstellungen und 300 Dateischreibvorgänge pro Stunde.
Datenschutz und Support
- Was Final speichert. Die Verbindung (wer sie erstellt hat, das Unternehmen und die Pakete), das Token, das es zum Erreichen von Hub und Flow verwendet (verschlüsselt), und ein Protokoll jedes Tool-Aufrufs: das Tool, das Ergebnis, die Dauer und geschwärzte Vorschauen der Argumente und des Ergebnisses. Du siehst dieses Protokoll auf der Verbindungsseite.
- Was Final nicht sieht. Deine Unterhaltung. MCP-Clients senden Tool-Aufrufe, nicht den Chat darum herum.
- Trennen löscht das gespeicherte Token und widerruft alle Token, die für diese Verbindung ausgestellt wurden.
- Datenschutzrichtlinie · Bedingungen
- Support: support@finalpos.com. Bei Problemen mit diesem Leitfaden oder dem Plugin öffne ein Issue.
Flows direkter Endpunkt
Einrichtungen, die vor dem Gateway erstellt wurden, können weiterhin https://flow.finalpos.com/api/mcp
mit einem Flow-sk_-Schlüssel verwenden (Registrierungsname com.finalpos.build/final-flows). Es funktioniert
weiterhin, aber neue Einrichtungen sollten https://ai.finalpos.com/mcp verwenden, das
Flow enthält.
FAQ
Was ist der Final MCP-Server?
Es ist der offizielle MCP-Server für Final POS. Eine einzige Remote-URL,
https://ai.finalpos.com/mcp, ermöglicht einem KI-Assistenten, das
Backoffice eines Händlers (Hub) zu lesen und zu verwalten und Point-of-Sale-Apps (Flow) zu erstellen.
Kann ChatGPT oder Claude mein Final POS-Inventar verwalten?
Ja. Erlaube das inventory-Paket, wenn du dich verbindest. Der Agent kann Lagerbestände
prüfen, niedrige Bestände finden, Nachbestellungen vorschlagen, Bestellungen aufgeben und
eingegangene Waren erfassen.
Kann ein KI-Agent eine POS-App auf Final erstellen?
Ja. Mit dem build-Paket erstellt der Agent einen Ablauf, schreibt die App gegen
Finals versionierte APIs und geprüfte Bildschirm-Blaupausen, validiert sie und
liefert eine Live-Vorschau-URL. Du startest sie aus dem Final-Builder.
Benötige ich einen API-Schlüssel?
Nein, wenn dein Client OAuth unterstützt (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): Melde dich einfach mit Final an. Codex und Skripte verwenden einen fai_-Schlüssel
von ai.finalpos.com/connections.
Auf welches Unternehmen wirkt es?
Auf das, das du beim Verbinden auswählst. Wenn dein Konto mehrere hat, kann der Agent
switch_company aufrufen.
Kann der Agent Zahlungen entgegennehmen oder Rückerstattungen ausstellen?
Nein. Zahlungen, Rückerstattungen und Stornierungen erfolgen an der Kasse. Aufträge sind über MCP schreibgeschützt.
Warum sieht mein Agent nur wenige Tools?
Clients setzen jedes aufgelistete Tool in den Kontext des Modells, und die Qualität sinkt mit
langen Listen. Der Agent findet den Rest mit find_tools, ruft sie mit
call_tool auf oder listet ein ganzes Paket mit enable_packs auf.
Gibt es Kosten?
Das Verbinden ist kostenlos. Was der Agent tut, wird wie die gleiche Arbeit in Final selbst abgerechnet, unter deinem Final-Plan.
Wo sind die Final POS-API-Dokumente?
Unter finalpos.com/docs. Ein Agent, der eine App erstellt,
benötigt sie nicht separat: Das build-Paket fundiert jeden Aufruf gegen
Finals versionierte APIs (flow_lookup_pos_api,
flow_lookup_command_frame).
Über dieses Repository
Dieses Repo enthält den öffentlichen Einrichtungsleitfaden, die MCP-Registry-Einträge
(server.json, legacy/), die Gemini-CLI-Erweiterung
(gemini-extension.json, GEMINI.md, commands/), die Claude-Code- und
Cursor-Plugin-Marktplätze (.claude-plugin/, .cursor-plugin/ und
plugins/final/, die beide teilen) und die generierte
Tool-Referenz mit ihrem maschinenlesbaren Gegenstück catalog.json,
das auch die Serverkarte unter https://ai.finalpos.com/.well-known/mcp/server-card.json
liest. GEMINI.md und der Claude-Skill sind dasselbe
Playbook, und CI prüft, dass sie übereinstimmen. Der Server selbst wird von Final gehostet;
kein Code aus diesem Repo läuft auf deinem Rechner.
Lizenz
Apache-2.0 © Final Commerce