Final POS – Custom POS Builder

официальный

Создавайте кастомную POS-систему с ИИ. Проектируйте сценарии оформления заказа, киоски самообслуживания и приложения для платёжных терминалов, просматривайте их в реальном времени и разворачивайте на реальном оборудовании с оплатой картой. Также управляет магазином: товары, остатки, заказы, клиенты и отчёты о продажах. Удалённо, через OAuth.

Что можно делать с Final POS – Custom POS Builder MCP?

  • Создание кастомных POS-приложений по описанию — Попросите ассистента создать процесс оформления заказа, например киоск для кофейни, и получите ссылку для предпросмотра в реальном времени.
  • Проверка и развертывание POS-сценариев — Запросите проверку файлов сценариев вашего приложения, затем отправьте последнюю версию на ваши платежные терминалы и киоски.
  • Мониторинг и управление запасами — Проверяйте уровень остатков, находите товары с низким запасом и создавайте черновики заказов на поставку для ваших обычных поставщиков.
  • Анализ эффективности продаж — Сравнивайте продажи по категориям за недели или определяйте ваших лучших клиентов и их покупки.
  • Управление каталогом и клиентами — Добавляйте товары из таблицы с фотографиями или настраивайте услуги бронирования с назначенным персоналом.

Размещённый MCP-сервер

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

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Final

Финальный MCP-сервер: создавайте кастомные POS-приложения с помощью ИИ

Подключите Claude, ChatGPT, Gemini, Cursor, Codex или любой MCP-клиент к Final:
создавайте кастомные POS-приложения с помощью Flow (кассы, киоски самообслуживания, платежные терминалы)
и управляйте магазином за ними из Hub через один сервер.

https://ai.finalpos.com/mcp

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

Подключение · Что он умеет · Справочник инструментов · FAQ · finalpos.com


Финальный MCP-сервер — это официальный сервер Model Context Protocol для Final, коммерческой платформы для кастомных точек продаж. Одна удаленная конечная точка, https://ai.finalpos.com/mcp, дает ИИ-агенту доступ ко всем продуктам Final, которые разрешит продавец:

  • Flow, конструктор кастомных POS-приложений: опишите кассу, и агент соберет ее из проверенных экранных шаблонов, опираясь на версионно-зафиксированные POS API Final, затем проверит ее, вернет ссылку на живой предпросмотр и развернет на платежных терминалах, планшетах и киосках. Кассовые POS, самообслуживание, заказ в ресторане, кухонные дисплеи и приложения для оплаты вживую.
  • Hub, бэк-офис за этими приложениями: товары и каталог, склад и заказы на закупку, заказы, клиенты, отчеты о продажах, команда и роли, точки продаж, налоги, бронирования.

Вы входите с помощью своей учетной записи Final (OAuth 2.1) и выбираете компанию и то, что агенту разрешено делать. Ничего устанавливать или запускать локально не нужно.

Конечная точкаhttps://ai.finalpos.com/mcp
ТранспортStreamable HTTP
АутентификацияOAuth 2.1 с PKCE (вход через Final) или ключ подключения fai_ как Authorization: Bearer
Имя в реестре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

Запустите /mcp в Claude Code и выберите Аутентифицировать. Или установите плагин, который добавляет сервер вместе с навыком playbook 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

Расширение добавляет сервер, playbook Final и команды: /final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview, /final-pos:validate и /final-pos:deploy. Войдите один раз с помощью /mcp auth final внутри Gemini CLI. Чтобы добавить только сервер:

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

Cursor

Add to 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" }

Любой другой клиент: POST https://ai.finalpos.com/mcp с Authorization: Bearer fai_YOUR_KEY.

Ключи, начинающиеся с sk_ (Flow) или fpm_ (Hub), принадлежат собственным серверам этих продуктов и здесь не принимаются. Создайте ключ fai_ вместо этого или используйте OAuth.

Проверьте, что все работает

Спросите своего агента: «Используй Final, чтобы сказать мне, к какой компании ты подключен и какие пакеты ты можешь использовать». Он вызовет get_connection и list_packs.

Что ваш агент может делать

Инструменты сгруппированы в пакеты. При подключении вы выбираете, какие пакеты агент может использовать, и они также являются областями OAuth. Чтобы контекст модели оставался небольшим, подключение перечисляет только несколько пакетов за раз. Основные инструменты достигают остальных: find_tools ищет по всем разрешенным пакетам, а call_tool вызывает любой разрешенный инструмент по имени.

ПакетПродуктЧто покрываетПеречислен по умолчанию
catalogHubТовары, варианты, категории, опции, модификаторы, фото товаров и медиатека✓
inventoryHubУровни запасов и история, перемещения, поставщики, заказы на закупку, правила повторного заказа, импорт/экспорт CSV запасов
ordersHubЗаказы, возвраты и синхронизация заказов электронной коммерции (только чтение: касса принимает платежи)
customersHubЗаписи клиентов, заметки, история заказов и импорт клиентов
reportsHubФинансовая сводка, разбивка продаж и платежей, продажи сотрудников, сессии, транзакции, экспорт записей
teamHubЧлены команды, роли и разрешения
storeHubТочки продаж, станции, налоги и расширения Hub
bookingsHubБронируемые услуги: правила, ресурсы, доступность, удержания и подтверждения
buildFlowСоздание и развертывание POS-приложений Final: привязка API, шаблоны, файлы потоков, песочницы предпросмотра, проверка, развертывание✓
build_dataFlowПользовательские таблицы (база данных приложения), хранилище секретов и расширения 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)

  • «Какие товары ниже точки повторного заказа в точке продаж на Мейн-стрит? Составь заказ на закупку у обычного поставщика».
  • «Сравни продажи за прошлую неделю по категориям с предыдущей неделей».
  • «Добавь эти 40 товаров из прикрепленной таблицы, с фото».
  • «Кто были мои десять лучших клиентов в этом месяце, и что они купили?»
  • «Настрой 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. По проблемам с этим руководством или плагином откройте issue.

Прямая конечная точка Flow

Настройки, сделанные до шлюза, могут по-прежнему использовать https://flow.finalpos.com/api/mcp с ключом Flow sk_ (имя в реестре com.finalpos.build/final-flows). Он продолжает работать, но новые настройки должны использовать https://ai.finalpos.com/mcp, который включает Flow.

FAQ

Что такое финальный MCP-сервер?

Это официальный MCP-сервер для Final POS. Один удаленный URL, https://ai.finalpos.com/mcp, позволяет ИИ-ассистенту читать и управлять бэк-офисом продавца Final (Hub) и создавать POS-приложения (Flow).

Может ли ChatGPT или Claude управлять моим инвентарем Final POS?

Да. Разрешите пакет inventory при подключении. Агент может проверять уровни запасов, находить низкие запасы, предлагать повторные заказы, создавать заказы на закупку и записывать полученные товары.

Может ли ИИ-агент создать POS-приложение на Final?

Да. С пакетом build агент создает поток, пишет приложение против версионно-зафиксированных API Final и проверенных экранных шаблонов, проверяет его и возвращает URL живого предпросмотра. Вы запускаете его из конструктора Final.

Нужен ли мне API-ключ?

Нет, если ваш клиент поддерживает OAuth (Claude, ChatGPT, Claude Code, Cursor, Gemini CLI, VS Code): просто войдите через Final. Codex и скрипты используют ключ fai_ с ai.finalpos.com/connections.

На какую компанию он действует?

На ту, которую вы выбираете при подключении. Если в вашей учетной записи несколько, агент может вызвать switch_company.

Может ли агент принимать платежи или выдавать возвраты?

Нет. Платежи, возвраты и аннулирования происходят на кассе. Заказы доступны только для чтения через MCP.

Почему мой агент видит только несколько инструментов?

Клиенты помещают каждый перечисленный инструмент в контекст модели, и качество падает с длинными списками. Агент находит остальные с помощью find_tools, вызывает их с помощью call_tool или перечисляет целый пакет с помощью enable_packs.

Есть ли стоимость?

Подключение бесплатно. То, что делает агент, оплачивается как та же работа, выполненная в Final вами, в рамках вашего тарифа Final.

Где документация по API Final POS?

На finalpos.com/docs. Агенту, создающему приложение, она не нужна отдельно: пакет build привязывает каждый вызов к версионно-зафиксированным API Final (flow_lookup_pos_api, flow_lookup_command_frame).

Об этом репозитории

В этом репозитории хранятся публичное руководство по настройке, записи MCP Registry (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 — это один и тот же playbook, и CI проверяет, что они совпадают. Сам сервер размещен Final; никакой код из этого репозитория не запускается на вашей машине.

Лицензия

Apache-2.0 © Final Commerce