Final POS – Custom POS Builder

officiel

Créez un POS personnalisé avec l'IA. Concevez des flux de caisse, des bornes libre-service et des applications de terminal de paiement, prévisualisez-les en direct et déployez-les sur du matériel réel avec paiements par carte. Gère également la boutique : produits, stock, commandes, clients et rapports de ventes. À distance, OAuth.

Que pouvez-vous faire avec Final POS – Custom POS Builder MCP ?

  • Créer des applications POS personnalisées à partir d’une description — Demandez à votre assistant de créer un flux de caisse, comme un kiosque de café, et obtenez un lien d’aperçu en direct.
  • Valider et déployer les flux POS — Demandez la validation des fichiers de flux de votre application, puis publiez la dernière version sur vos terminaux de paiement et kiosques.
  • Suivre et gérer les stocks — Vérifiez les niveaux de stock, identifiez les articles en rupture ou en faible quantité, et rédigez des bons de commande pour vos fournisseurs habituels.
  • Analyser les performances des ventes — Comparez les ventes par catégorie sur plusieurs semaines ou identifiez vos meilleurs clients et leurs achats.
  • Gérer le catalogue et les clients — Ajoutez des produits à partir d’une feuille de calcul avec photos, ou configurez des services réservables avec du personnel assigné.

Serveur MCP hébergé

npx add-mcp 'https://ai.finalpos.com/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Final

Serveur MCP Final : créez des applications POS personnalisées avec l'IA

Connectez Claude, ChatGPT, Gemini, Cursor, Codex ou tout client MCP à Final :
créez des applications POS personnalisées avec Flow (flux de caisse, bornes de libre-service, terminaux de paiement)
et gérez le magasin qui les alimente depuis Hub, via un seul serveur.

https://ai.finalpos.com/mcp

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

Se connecter · Ce qu'il peut faire · Référence des outils · FAQ · finalpos.com


Le serveur MCP Final est le serveur officiel du Model Context Protocol pour Final, la plateforme de commerce pour les points de vente personnalisés. Un seul point de terminaison distant, https://ai.finalpos.com/mcp, donne à un agent IA accès à chaque produit Final que le marchand autorise :

  • Flow, le créateur d'applications POS personnalisées : décrivez un flux de caisse et l'agent le construit à partir de maquettes d'écran validées, ancrées dans les API POS versionnées de Final, puis le valide, renvoie un lien d'aperçu en direct et le déploie sur les terminaux de paiement, tablettes et bornes. POS de comptoir, libre-service, commande en restaurant, écrans de cuisine et applications de paiement en personne.
  • Hub, le back-office derrière ces applications : produits et catalogue, stock et bons de commande, commandes, clients, rapports de ventes, équipe et rôles, points de vente, taxes, réservations.

Vous vous connectez avec votre compte Final (OAuth 2.1) et choisissez l'entreprise et ce que l'agent peut faire. Rien à installer ni à exécuter localement.

Point de terminaisonhttps://ai.finalpos.com/mcp
TransportHTTP streamable
AuthentificationOAuth 2.1 avec PKCE (connexion avec Final), ou une clé de connexion fai_ comme Authorization: Bearer
Nom du registrecom.finalpos/final
Agit en tant queLa personne qui l'a connecté, sur une entreprise, dans les packs qu'elle a autorisés
CoûtConnexion gratuite ; ce que fait l'agent suit votre forfait Final, comme si vous le faisiez dans Final

Se connecter

La plupart des clients n'ont besoin que de l'URL. Ils ouvrent une page de connexion Final où vous choisissez l'entreprise et les packs, puis ils sont connectés.

Claude (claude.ai, Claude Desktop)

Paramètres → Connecteurs → Ajouter un connecteur personnalisé, URL https://ai.finalpos.com/mcp.

ChatGPT

Paramètres → Applications et connecteurs → Paramètres avancés → Mode développeur, puis Créer avec l'URL https://ai.finalpos.com/mcp.

Claude Code

claude mcp add --transport http final https://ai.finalpos.com/mcp

Exécutez /mcp dans Claude Code et choisissez S'authentifier. Ou installez le plugin, qui ajoute le serveur avec la compétence Final playbook. Dans 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

L'extension ajoute le serveur, le playbook Final et les commandes : /final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview, /final-pos:validate et /final-pos:deploy. Connectez-vous une fois avec /mcp auth final dans Gemini CLI. Pour ajouter uniquement le serveur :

gemini mcp add --transport http final https://ai.finalpos.com/mcp

Cursor

Add to Cursor

Ou dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "final": { "url": "https://ai.finalpos.com/mcp" }
  }
}

VS Code (GitHub Copilot)

Installer dans VS Code, ou :

code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'

Codex, scripts et clients sans OAuth

Créez une clé de connexion sur ai.finalpos.com/connections. Elle n'est affichée qu'une fois, et la page imprime l'extrait exact pour chaque client. Pour Codex, ajoutez ceci à ~/.codex/config.toml :

[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }

Tout autre client : POST https://ai.finalpos.com/mcp avec Authorization: Bearer fai_YOUR_KEY.

Les clés commençant par sk_ (Flow) ou fpm_ (Hub) appartiennent aux serveurs propres de ces produits et ne sont pas acceptées ici. Créez une clé fai_ à la place, ou utilisez OAuth.

Vérifier que cela fonctionne

Demandez à votre agent : « Utilise Final pour me dire à quelle entreprise tu es connecté et quels packs tu peux utiliser. » Il appelle get_connection et list_packs.

Ce que votre agent peut faire

Les outils sont regroupés en packs. Lors de la connexion, vous choisissez les packs que l' agent peut utiliser, et ce sont aussi les portées OAuth. Pour garder le contexte du modèle réduit, une connexion ne liste que quelques packs à la fois. Les outils de base atteignent le reste : find_tools recherche dans chaque pack autorisé, et call_tool appelle tout outil autorisé par son nom.

PackProduitCe qu'il couvreListé par défaut
catalogHubProduits, variantes, catégories, options, modificateurs, photos de produits et bibliothèque multimédia✓
inventoryHubNiveaux de stock et historique, transferts, fournisseurs, bons de commande, règles de réapprovisionnement, import/export CSV de stock
ordersHubCommandes, remboursements et synchronisation des commandes e-commerce (lecture seule : la caisse prend les paiements)
customersHubFiches clients, notes, historique de commandes et import de clients
reportsHubRésumé financier, ventes et répartitions des paiements, ventes par employé, sessions, transactions, export d'enregistrements
teamHubMembres de l'équipe, rôles et permissions
storeHubPoints de vente, postes, taxes et extensions Hub
bookingsHubServices réservables : règles, ressources, disponibilités, blocages et confirmations
buildFlowCréer et déployer des applications POS Final : ancrage API, maquettes, fichiers de flux, sandbox d'aperçu, validation, déploiement✓
build_dataFlowTables personnalisées (la base de données de l'application), le coffre-fort de secrets et les extensions Flow

Les noms d'outils portent leur produit : hub_get_products, hub_find_low_stock, flow_create_flow, flow_deploy_flow. TOOLS.md liste chaque outil, avec son pack, s'il modifie des données, et ses arguments.

Outils de base (toujours listés) : get_connection, list_packs, find_tools, call_tool, enable_packs, disable_packs, switch_company.

Choses à demander

Créer des applications POS personnalisées (Flow)

  • « Crée une borne de coffee-shop avec une grille de produits, des modificateurs, un panier et des paiements par carte, puis donne-moi un lien d'aperçu. »
  • « Ajoute un écran de pourboire à mon application de comptoir et valide-le. »
  • « Crée un flux de libre-service pour une petite épicerie avec scan de codes-barres et un écran de reçu. »
  • « Livre la dernière version de mon flux de libre-service. »

Une création d'application exécute généralement flow_get_scaffold → flow_create_flow → flow_lookup_command_frame (ancrage) → flow_get_blueprint → flow_write_flow_files → flow_validate_flow → flow_start_preview, et renvoie une URL d'aperçu en direct. Tout ce que l'agent construit apparaît aussi dans le créateur Final, où chaque écriture de fichier est un point de contrôle restaurable.

Gérer le magasin (Hub)

  • « Quels produits sont sous leur seuil de réapprovisionnement au point de vente Main Street ? Rédige un bon de commande pour le fournisseur habituel. »
  • « Compare les ventes de la semaine dernière par catégorie avec celles de la semaine précédente. »
  • « Ajoute ces 40 produits depuis la feuille de calcul jointe, avec photos. »
  • « Qui étaient mes dix meilleurs clients ce mois-ci, et qu'ont-ils acheté ? »
  • « Configure un massage de 45 minutes comme service réservable avec deux thérapeutes. »

Sécurité et permissions

  • Votre rôle s'applique toujours. Chaque appel Hub s'exécute en tant que la personne qui a connecté, et Hub vérifie son rôle en direct à chaque appel. Les actions réservées aux propriétaires restent réservées aux propriétaires.
  • Les packs sont la permission. L'agent ne peut appeler que les outils dans les packs que vous avez autorisés. Vous pouvez modifier les packs ou vous déconnecter à tout moment sur ai.finalpos.com/connections, et la déconnexion révoque tous les jetons d'un coup.
  • Les écritures sont étiquetées. Les outils de lecture portent readOnlyHint, et les déploiements et suppressions portent destructiveHint, afin que les clients puissent demander avant d'agir. Le serveur demande aux agents de confirmer les déploiements, suppressions et modifications groupées avec vous.
  • L'argent reste à la caisse. Prendre des paiements, rembourser et annuler des commandes ne sont pas disponibles via MCP.
  • Les secrets ne passent jamais par le modèle. flow_request_secret vous demande de saisir une clé API dans le créateur.
  • Tout est journalisé. La page Connexions montre chaque client connecté et chaque appel qu'il a fait, en direct.
  • Limites Flow : Flow autorise 30 démarrages d'aperçu, 12 créations et déploiements, et 300 écritures de fichiers par heure.

Confidentialité et support

  • Ce que Final conserve. La connexion (qui l'a faite, l'entreprise et les packs), le jeton qu'elle utilise pour atteindre Hub et Flow (chiffré), et un journal de chaque appel d'outil : l'outil, le résultat, la durée, et des aperçus expurgés des arguments et du résultat. Vous voyez ce journal sur la page Connexions.
  • Ce que Final ne voit pas. Votre conversation. Les clients MCP envoient des appels d'outils, pas le chat qui les entoure.
  • La déconnexion supprime le jeton stocké et révoque chaque jeton émis pour cette connexion.
  • Politique de confidentialité · Conditions
  • Support : support@finalpos.com. Pour des problèmes avec ce guide ou le plugin, ouvrez une issue.

Point de terminaison direct de Flow

Les configurations faites avant la passerelle peuvent encore utiliser https://flow.finalpos.com/api/mcp avec une clé Flow sk_ (nom du registre com.finalpos.build/final-flows). Cela continue de fonctionner, mais les nouvelles configurations devraient utiliser https://ai.finalpos.com/mcp, qui inclut Flow.

FAQ

Qu'est-ce que le serveur MCP Final ?

C'est le serveur MCP officiel pour Final POS. Une seule URL distante, https://ai.finalpos.com/mcp, permet à un assistant IA de lire et gérer le back-office Final d'un marchand (Hub) et de créer des applications de point de vente (Flow).

ChatGPT ou Claude peuvent-ils gérer mon inventaire Final POS ?

Oui. Autorisez le pack inventory lors de la connexion. L'agent peut vérifier les niveaux de stock, trouver les stocks faibles, suggérer des réapprovisionnements, créer des bons de commande et enregistrer les marchandises reçues.

Un agent IA peut-il créer une application POS sur Final ?

Oui. Avec le pack build, l'agent crée un flux, écrit l'application contre les API versionnées de Final et les maquettes d'écran validées, la valide, et renvoie une URL d'aperçu en direct. Vous la lancez depuis le créateur Final.

Ai-je besoin d'une clé API ?

Non, si votre client prend en charge OAuth (Claude, ChatGPT, Claude Code, Cursor, Gemini CLI, VS Code) : connectez-vous simplement avec Final. Codex et les scripts utilisent une clé fai_ depuis ai.finalpos.com/connections.

Sur quelle entreprise agit-il ?

Celle que vous choisissez lors de la connexion. Si votre compte en a plusieurs, l'agent peut appeler switch_company.

L'agent peut-il prendre des paiements ou émettre des remboursements ?

Non. Les paiements, remboursements et annulations se font à la caisse. Les commandes sont en lecture seule via MCP.

Pourquoi mon agent ne voit-il que quelques outils ?

Les clients placent chaque outil listé dans le contexte du modèle, et la qualité diminue avec les longues listes. L'agent trouve le reste avec find_tools, les appelle avec call_tool, ou liste tout un pack avec enable_packs.

Y a-t-il un coût ?

La connexion est gratuite. Ce que fait l'agent est facturé comme le même travail effectué dans Final vous-même, sous votre forfait Final.

Où sont les docs API Final POS ?

Sur finalpos.com/docs. Un agent créant une application n'en a pas besoin séparément : le pack build ancre chaque appel contre les API versionnées de Final (flow_lookup_pos_api, flow_lookup_command_frame).

À propos de ce dépôt

Ce dépôt contient le guide de configuration public, les entrées du registre MCP (server.json, legacy/), l'extension Gemini CLI (gemini-extension.json, GEMINI.md, commands/), les places de marché de plugins Claude Code et Cursor (.claude-plugin/, .cursor-plugin/, et plugins/final/, que les deux partagent) et la référence d'outils générée avec son jumeau lisible par machine catalog.json, que la carte du serveur à https://ai.finalpos.com/.well-known/mcp/server-card.json lit aussi. GEMINI.md et la compétence Claude sont le même playbook, et CI vérifie qu'ils correspondent. Le serveur lui-même est hébergé par Final ; aucun code de ce dépôt ne s'exécute sur votre machine.

Licence

Apache-2.0 © Final Commerce