Final POS – Custom POS Builder

offiziell

Erstellen 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

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

MCP Registry: com.finalpos/final Add to Cursor Install in VS Code License: Apache-2.0

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.

Endpunkthttps://ai.finalpos.com/mcp
TransportStreamable HTTP
AuthentifizierungOAuth 2.1 mit PKCE (Anmeldung mit Final) oder ein fai_-Verbindungsschlüssel als Authorization: Bearer
Registrierungsnamecom.finalpos/final
Agiert alsDie Person, die es verbunden hat, für ein Unternehmen, innerhalb der erlaubten Pakete
KostenKostenlos 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

Add to 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) oder fpm_ (Hub) beginnen, gehören zu den eigenen Servern dieser Produkte und werden hier nicht akzeptiert. Erstelle stattdessen einen fai_-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.

PaketProduktWas es abdecktStandardmäßig aufgelistet
catalogHubProdukte, Varianten, Kategorien, Optionen, Modifikatoren, Produktfotos und die Medienbibliothek✓
inventoryHubLagerbestände und -verlauf, Umlagerungen, Lieferanten, Bestellungen, Nachbestellregeln, Lager-CSV-Import/Export
ordersHubAufträge, Rückerstattungen und E-Commerce-Auftragssynchronisierung (schreibgeschützt: die Kasse nimmt Zahlungen entgegen)
customersHubKundendatensätze, Notizen, Bestellverlauf und Kundenimport
reportsHubFinanzübersicht, Verkaufs- und Zahlungsaufschlüsselungen, Mitarbeiterverkäufe, Sitzungen, Transaktionen, Datensatzexport
teamHubTeammitglieder, Rollen und Berechtigungen
storeHubFilialen, Stationen, Steuern und Hub-Erweiterungen
bookingsHubBuchbare Dienstleistungen: Regeln, Ressourcen, Verfügbarkeit, Reservierungen und Bestätigungen
buildFlowErstellen und Bereitstellen von Final POS-Apps: API-Grundlage, Blaupausen, Flow-Dateien, Vorschau-Sandboxes, Validierung, Bereitstellung✓
build_dataFlowBenutzerdefinierte 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 tragen destructiveHint, 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_secret fordert 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