Final POS – Custom POS Builder
oficialCrea 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
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
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.
| Endpoint | https://ai.finalpos.com/mcp |
| Transporte | HTTP transmisible |
| Autenticación | OAuth 2.1 con PKCE (inicia sesión con Final), o una clave de conexión fai_ como Authorization: Bearer |
| Nombre del registro | com.finalpos/final |
| Actúa como | La persona que lo conectó, en una empresa, dentro de los paquetes que permitió |
| Costo | Gratis 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
O en ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
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) ofpm_(Hub) pertenecen a los servidores propios de esos productos y no se aceptan aquí. Crea una clavefai_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.
| Paquete | Producto | Qué cubre | Listado por defecto |
|---|---|---|---|
catalog | Hub | Productos, variantes, categorías, opciones, modificadores, fotos de productos y la biblioteca de medios | ✓ |
inventory | Hub | Niveles de stock e historial, transferencias, proveedores, órdenes de compra, reglas de reposición, importación/exportación CSV de stock | |
orders | Hub | Pedidos, reembolsos y sincronización de pedidos de comercio electrónico (solo lectura: la caja toma los pagos) | |
customers | Hub | Registros de clientes, notas, historial de pedidos e importación de clientes | |
reports | Hub | Resumen financiero, desgloses de ventas y pagos, ventas por empleado, sesiones, transacciones, exportación de registros | |
team | Hub | Miembros del equipo, roles y permisos | |
store | Hub | Sucursales, estaciones, impuestos y extensiones de Hub | |
bookings | Hub | Servicios reservables: reglas, recursos, disponibilidad, retenciones y confirmaciones | |
build | Flow | Crear y desplegar apps de punto de venta de Final: fundamentos de API, plantillas, archivos de flujo, entornos de vista previa, validación, despliegue | ✓ |
build_data | Flow | Tablas 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 llevandestructiveHint, 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_secrette 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