Final POS

Servidor MCP oficial alojado para crear aplicaciones personalizadas de punto de venta, kioscos y autopago con agentes de IA: búsquedas de API fundamentadas, planos de pantalla, vistas previas en vivo e implementaciones en terminales de pago reales.

GitHubPrueba este MCPPatrocinado

Documentación

Final POS MCP

Crea tu propio punto de venta, kiosco, autopago, KDS y aplicaciones de pago presencial con agentes de IA —
desde Gemini CLI, Claude Code, Cursor, ChatGPT o cualquier cliente MCP.

finalpos.com · Final Builder · API Docs

Final permite que cualquiera cree su propio POS — cada píxel, cada permiso, cada interacción — y lo ejecute en cualquier hardware: escritorio, tableta, móvil, kiosco, terminal de pago, escáner de colas o pantalla de menú, con pagos con tarjeta integrados en más de 24 países.

Este repositorio es el hogar oficial para conectar tu propio agente de IA a Final. Incluye:

Una extensión de Gemini CLI (este repositorio se instala directamente).
El servidor MCP de Final Flows alojado — 20 herramientas para consultas de API fundamentadas, planos de pantalla verificados, escrituras de archivos de flujo, vistas previas en sandbox en vivo, compuertas de validación y despliegues.
El servidor MCP de documentación de Final — busca en la API REST de Final POS.
Fragmentos de configuración para Claude Code, Cursor, ChatGPT y cualquier cliente MCP.

Todo lo que tu agente construye aparece en vivo en el Final builder: la aplicación se muestra en tu cuadrícula de inicio, la sesión del agente aparece como un chat, y cada escritura de archivo es un punto de restauración.

Obtén una clave de API

Todos los clientes se autentican con una clave de API de organización de Final (sk_...):

Inicia sesión en build.finalpos.com.
Abre un flujo, luego en el panel de chat haz clic en el ícono de cable → "Conecta tu herramienta de IA".
Genera una clave — se muestra una sola vez, así que cópiala de inmediato.

Instalación

Gemini CLI

gemini extensions install https://github.com/Final-Commerce/final-pos-mcp

Se te pedirá tu FINAL_API_KEY durante la instalación (se almacena en tu llavero del sistema). Cámbiala más tarde con:

gemini extensions config final-pos

Luego comienza a construir:

/final-pos:new a coffee-shop kiosk with a product grid, cart, and card payments
/final-pos:preview   # live sandbox preview URL
/final-pos:validate  # run the full gate suite
/final-pos:deploy    # ship it

Claude Code

claude mcp add final-flows --transport http https://build.finalpos.com/api/mcp \
  --header "Authorization: Bearer sk_YOUR_KEY"

Cursor

O agrégalo a ~/.cursor/mcp.json manualmente:

{
  "mcpServers": {
    "final-flows": {
      "url": "https://build.finalpos.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_YOUR_KEY" }
    }
  }
}

ChatGPT y cualquier otro cliente MCP

El servidor habla Streamable HTTP estándar:

Endpoint: https://build.finalpos.com/api/mcp
Encabezado de autenticación: Authorization: Bearer sk_YOUR_KEY (o x-api-key: sk_YOUR_KEY)

En ChatGPT, agrégalo como conector en Configuración → Conectores (modo desarrollador). Funciona igual en VS Code, Windsurf, Zed y cualquier otra herramienta que hable MCP.

Lo que tu agente puede hacer

Categoría	Herramientas
Fundamentación	`lookup_command_frame`, `lookup_pos_api`, `lookup_engine_component`, `list_blueprints`, `get_blueprint`, `get_scaffold`
Ciclo de vida del flujo	`list_flows`, `create_flow`, `connect_chat`, `log_message`, `read_flow_files`, `write_flow_files`, `delete_flow_files`
Vista previa y publicación	`start_preview`, `sync_preview`, `get_preview_status`, `stop_preview`, `validate_flow`, `open_in_builder`, `deploy_flow`

Un flujo típico: get_scaffold → create_flow → fundamenta cada llamada de UI en lookup_command_frame → adapta un plano verificado → write_flow_files → validate_flow → start_preview → te entrega una URL en vivo.

Todas las llamadas de herramientas están limitadas a los flujos de tu propia organización. Límites de tasa por clave: 30 arranques de vista previa/hora, 12 compilaciones+despliegues/hora, 300 escrituras de archivos/hora.

Seguridad

Tu clave de API está limitada a la organización y es revocable; el secreto nunca se almacena en este repositorio de extensión — Gemini CLI lo guarda en tu llavero del sistema.
Los servidores MCP están alojados por Final; ningún código de este repositorio se ejecuta localmente excepto los archivos de prompt/contexto.
Los agentes no pueden tocar archivos propiedad del motor, y cada despliegue pasa por compuertas de seguridad, verificación de tipos y escaneos de secretos.