Final POS – Custom POS Builder

oficial

Crea un POS personalizado con IA. Diseña flujos de caja, quioscos de autopago y aplicaciones para terminales de pago, previsualízalos en vivo y despliégalos en hardware real con pagos con tarjeta. También gestiona la tienda: productos, stock, pedidos, clientes e informes de ventas. Remoto, OAuth.

¿Qué puedes hacer con Final POS – Custom POS Builder MCP?

  • Crear apps POS personalizadas a partir de una descripción — Pídele a tu asistente que cree un flujo de pago, como un quiosco de cafetería, y obtén un enlace de vista previa en vivo.
  • Validar e implementar flujos POS — Solicita la validación de los archivos de flujo de tu app y luego envía la versión más reciente a tus terminales de pago y quioscos.
  • Monitorear y gestionar inventario — Revisa los niveles de stock, encuentra artículos con existencias bajas y redacta órdenes de compra para tus proveedores habituales.
  • Analizar el rendimiento de ventas — Compara las ventas por categoría entre semanas o identifica a tus mejores clientes y sus compras.
  • Gestionar catálogo y clientes — Agrega productos desde una hoja de cálculo con fotos, o configura servicios reservables con personal asignado.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Final

Servidor MCP oficial de Final: crea apps de punto de venta personalizadas con IA

Conecta Claude, ChatGPT, Gemini, Cursor, Codex o cualquier cliente MCP a Final:
crea apps de punto de venta personalizadas con Flow (flujos de cobro, quioscos de autopago, terminales de pago)
y gestiona la tienda que hay detrás desde Hub, a través de un único servidor.

https://ai.finalpos.com/mcp

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

Conectar · Qué puede hacer · Referencia de herramientas · Preguntas frecuentes · finalpos.com


El servidor MCP de Final es el servidor oficial del Protocolo de Contexto de Modelos (MCP) para Final, la plataforma de comercio para puntos de venta personalizados. Un único endpoint remoto, https://ai.finalpos.com/mcp, da acceso a un agente de IA a todos los productos de Final que el comerciante permita:

  • Flow, el creador de apps de punto de venta personalizadas: describe un cobro y el agente lo construye a partir de plantillas de pantalla verificadas, basadas en las APIs de punto de venta de Final con versiones fijadas, luego lo valida, devuelve un enlace de vista previa en vivo y lo despliega en terminales de pago, tabletas y quioscos. Punto de venta de mostrador, autopago, pedidos en restaurantes, pantallas de cocina y apps de pago presencial.
  • Hub, el back office detrás de esas apps: productos y catálogo, stock y órdenes de compra, pedidos, clientes, informes de ventas, equipo y roles, sucursales, impuestos, reservas.

Inicias sesión con tu cuenta de Final (OAuth 2.1) y eliges la empresa y qué puede hacer el agente. No hay nada que instalar ni ejecutar localmente.

Endpointhttps://ai.finalpos.com/mcp
TransporteHTTP transmisible
AutenticaciónOAuth 2.1 con PKCE (inicia sesión con Final), o una clave de conexión fai_ como Authorization: Bearer
Nombre del registrocom.finalpos/final
Actúa comoLa persona que lo conectó, en una empresa, dentro de los paquetes que permitió
CostoGratis para conectar; lo que hace el agente sigue tu plan de Final, como si lo hicieras tú en Final

Conectar

La mayoría de los clientes solo necesitan la URL. Abren una página de inicio de sesión de Final donde eliges la empresa y los paquetes, y luego quedan conectados.

Claude (claude.ai, Claude Desktop)

Configuración → Conectores → Añadir conector personalizado, URL https://ai.finalpos.com/mcp.

ChatGPT

Configuración → Apps y conectores → Configuración avanzada → Modo desarrollador, luego Crear con la URL https://ai.finalpos.com/mcp.

Claude Code

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

Ejecuta /mcp en Claude Code y elige Autenticar. O instala el plugin, que añade el servidor junto con la habilidad del manual de Final. Dentro de 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

La extensión añade el servidor, el manual de Final y comandos: /final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview, /final-pos:validate y /final-pos:deploy. Inicia sesión una vez con /mcp auth final dentro de Gemini CLI. Para añadir solo el servidor:

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

Cursor

Add to Cursor

O en ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

Instalar en VS Code, o:

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

Codex, scripts y clientes sin OAuth

Crea una clave de conexión en ai.finalpos.com/connections. Se muestra una sola vez, y la página imprime el fragmento exacto para cada cliente. Para Codex, añade esto a ~/.codex/config.toml:

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

Cualquier otro cliente: POST https://ai.finalpos.com/mcp con Authorization: Bearer fai_YOUR_KEY.

Las claves que empiezan con sk_ (Flow) o fpm_ (Hub) pertenecen a los servidores propios de esos productos y no se aceptan aquí. Crea una clave fai_ en su lugar, o usa OAuth.

Comprueba que funciona

Pregunta a tu agente: "Usa Final para decirme a qué empresa estás conectado y qué paquetes puedes usar." Llama a get_connection y list_packs.

Qué puede hacer tu agente

Las herramientas se agrupan en paquetes. Cuando te conectas, eliges qué paquetes puede usar el agente, y esos también son los alcances de OAuth. Para mantener el contexto del modelo pequeño, una conexión lista solo unos pocos paquetes a la vez. Las herramientas principales llegan al resto: find_tools busca en cada paquete permitido, y call_tool llama a cualquier herramienta permitida por nombre.

PaqueteProductoQué cubreListado por defecto
catalogHubProductos, variantes, categorías, opciones, modificadores, fotos de productos y la biblioteca de medios✓
inventoryHubNiveles de stock e historial, transferencias, proveedores, órdenes de compra, reglas de reposición, importación/exportación CSV de stock
ordersHubPedidos, reembolsos y sincronización de pedidos de comercio electrónico (solo lectura: la caja toma los pagos)
customersHubRegistros de clientes, notas, historial de pedidos e importación de clientes
reportsHubResumen financiero, desgloses de ventas y pagos, ventas por empleado, sesiones, transacciones, exportación de registros
teamHubMiembros del equipo, roles y permisos
storeHubSucursales, estaciones, impuestos y extensiones de Hub
bookingsHubServicios reservables: reglas, recursos, disponibilidad, retenciones y confirmaciones
buildFlowCrear y desplegar apps de punto de venta de Final: fundamentos de API, plantillas, archivos de flujo, entornos de vista previa, validación, despliegue✓
build_dataFlowTablas personalizadas (la base de datos de la app), el almacén de secretos y extensiones de Flow

Los nombres de las herramientas llevan su producto: hub_get_products, hub_find_low_stock, flow_create_flow, flow_deploy_flow. TOOLS.md lista cada herramienta, con su paquete, si cambia datos, y sus argumentos.

Herramientas principales (siempre listadas): get_connection, list_packs, find_tools, call_tool, enable_packs, disable_packs, switch_company.

Cosas para preguntar

Crear apps de punto de venta personalizadas (Flow)

  • "Crea un quiosco de cafetería con una cuadrícula de productos, modificadores, un carrito y pagos con tarjeta, y dame un enlace de vista previa."
  • "Añade una pantalla de propinas a mi app de mostrador y valídala."
  • "Crea un flujo de autopago para una pequeña tienda de comestibles con escaneo de códigos de barras y una pantalla de recibo."
  • "Envía la última versión de mi flujo de autopago."

Una compilación de app normalmente ejecuta flow_get_scaffold → flow_create_flow → flow_lookup_command_frame (fundamentos) → flow_get_blueprint → flow_write_flow_files → flow_validate_flow → flow_start_preview, y devuelve una URL de vista previa en vivo. Todo lo que el agente construye también aparece en el creador de Final, donde cada escritura de archivo es un punto de restauración.

Gestionar la tienda (Hub)

  • "¿Qué productos están por debajo de su punto de reposición en la sucursal de Main Street? Redacta una orden de compra para el proveedor habitual."
  • "Compara las ventas de la semana pasada por categoría con la semana anterior."
  • "Añade estos 40 productos de la hoja de cálculo adjunta, con fotos."
  • "¿Quiénes fueron mis diez mejores clientes este mes, y qué compraron?"
  • "Configura un masaje de 45 minutos como servicio reservable con dos terapeutas."

Seguridad y permisos

  • Tu rol sigue aplicando. Cada llamada de Hub se ejecuta como la persona que se conectó, y Hub verifica su rol en vivo en cada llamada. Las acciones solo para propietarios siguen siendo solo para propietarios.
  • Los paquetes son el permiso. El agente solo puede llamar a herramientas en los paquetes que permitiste. Puedes cambiar los paquetes o desconectarte en cualquier momento en ai.finalpos.com/connections, y desconectarte revoca todos los tokens a la vez.
  • Las escrituras están etiquetadas. Las herramientas de lectura llevan readOnlyHint, y los despliegues y eliminaciones llevan destructiveHint, para que los clientes puedan preguntar antes de actuar. El servidor dice a los agentes que confirmen despliegues, eliminaciones y cambios masivos contigo.
  • El dinero se queda en la caja. Tomar pagos, reembolsar y anular pedidos no están disponibles a través de MCP.
  • Los secretos nunca pasan por el modelo. flow_request_secret te pide que ingreses una clave de API en el creador.
  • Todo queda registrado. La página de Conexiones muestra cada cliente conectado y cada llamada que hizo, en vivo.
  • Límites de Flow: Flow permite 30 arranques de vista previa, 12 compilaciones y despliegues, y 300 escrituras de archivos por hora.

Privacidad y soporte

  • Qué conserva Final. La conexión (quién la hizo, la empresa y los paquetes), el token que usa para llegar a Hub y Flow (cifrado), y un registro de cada llamada de herramienta: la herramienta, el resultado, cuánto tardó, y vistas previas redactadas de los argumentos y el resultado. Ves ese registro en la página de Conexiones.
  • Qué no ve Final. Tu conversación. Los clientes MCP envían llamadas de herramientas, no el chat que las rodea.
  • Desconectarte elimina el token almacenado y revoca todos los tokens emitidos para esa conexión.
  • Política de privacidad · Términos
  • Soporte: support@finalpos.com. Para problemas con esta guía o el plugin, abre un issue.

Endpoint directo de Flow

Las configuraciones hechas antes de la puerta de enlace aún pueden usar https://flow.finalpos.com/api/mcp con una clave de Flow sk_ (nombre del registro com.finalpos.build/final-flows). Sigue funcionando, pero las nuevas configuraciones deberían usar https://ai.finalpos.com/mcp, que incluye Flow.

Preguntas frecuentes

¿Qué es el servidor MCP de Final?

Es el servidor MCP oficial para Final POS. Una única URL remota, https://ai.finalpos.com/mcp, permite a un asistente de IA leer y gestionar el back office de Final de un comerciante (Hub) y crear apps de punto de venta (Flow).

¿Puede ChatGPT o Claude gestionar mi inventario de Final POS?

Sí. Permite el paquete inventory cuando te conectes. El agente puede verificar los niveles de stock, encontrar stock bajo, sugerir reposiciones, crear órdenes de compra y registrar mercancía recibida.

¿Puede un agente de IA crear una app de punto de venta en Final?

Sí. Con el paquete build el agente crea un flujo, escribe la app contra las APIs de Final con versiones fijadas y plantillas de pantalla verificadas, la valida, y devuelve una URL de vista previa en vivo. La lanzas desde el creador de Final.

¿Necesito una clave de API?

No, si tu cliente soporta OAuth (Claude, ChatGPT, Claude Code, Cursor, Gemini CLI, VS Code): solo inicia sesión con Final. Codex y scripts usan una clave fai_ de ai.finalpos.com/connections.

¿Sobre qué empresa actúa?

La que elijas cuando te conectes. Si tu cuenta tiene varias, el agente puede llamar a switch_company.

¿Puede el agente tomar pagos o emitir reembolsos?

No. Los pagos, reembolsos y anulaciones ocurren en la caja. Los pedidos son de solo lectura a través de MCP.

¿Por qué mi agente solo ve unas pocas herramientas?

Los clientes ponen cada herramienta listada en el contexto del modelo, y la calidad baja con listas largas. El agente encuentra el resto con find_tools, las llama con call_tool, o lista un paquete completo con enable_packs.

¿Hay algún costo?

Conectar es gratis. Lo que hace el agente se factura como el mismo trabajo hecho en Final por ti mismo, bajo tu plan de Final.

¿Dónde están los documentos de la API de Final POS?

En finalpos.com/docs. Un agente que crea una app no los necesita por separado: el paquete build fundamenta cada llamada contra las APIs de Final con versiones fijadas (flow_lookup_pos_api, flow_lookup_command_frame).

Sobre este repositorio

Este repositorio contiene la guía de configuración pública, las entradas del Registro MCP (server.json, legacy/), la extensión de Gemini CLI (gemini-extension.json, GEMINI.md, commands/), los mercados de plugins de Claude Code y Cursor (.claude-plugin/, .cursor-plugin/, y plugins/final/, que ambos comparten) y la referencia de herramientas generada con su gemelo legible por máquina catalog.json, que la tarjeta del servidor en https://ai.finalpos.com/.well-known/mcp/server-card.json también lee. GEMINI.md y la habilidad de Claude son el mismo manual, y CI verifica que coincidan. El servidor en sí está alojado por Final; ningún código de este repositorio se ejecuta en tu máquina.

Licencia

Apache-2.0 © Final Commerce