Final POS

Servidor MCP oficial hospedado para criar aplicativos personalizados de ponto de venda, quiosque e autoatendimento com agentes de IA — consultas de API fundamentadas, modelos de tela, pré-visualizações ao vivo e implantações em terminais de pagamento reais.

GitHubExperimente este MCPPatrocinado

Documentação

Final POS MCP

Crie aplicativos personalizados de ponto de venda, quiosque, self-checkout, KDS e pagamentos presenciais com agentes de IA —
a partir do Gemini CLI, Claude Code, Cursor, ChatGPT ou qualquer cliente MCP.

finalpos.com · Final Builder · Documentação da API

Final permite que qualquer pessoa crie seu próprio POS — cada pixel, cada permissão, cada interação — e execute-o em qualquer hardware: desktop, tablet, mobile, quiosque, terminal de pagamento, line buster ou menu board, com pagamentos por cartão integrados em mais de 24 países.

Este repositório é o lar oficial para conectar seu próprio agente de IA ao Final. Ele inclui:

Uma extensão do Gemini CLI (este repositório instala diretamente).
O servidor MCP Final Flows hospedado — 20 ferramentas para consultas de API fundamentadas, blueprints de tela validados, gravações de arquivos de fluxo, pré-visualizações ao vivo em sandbox, portões de validação e deploys.
O servidor MCP de documentação do Final — pesquise a API REST do Final POS.
Snippets de configuração para Claude Code, Cursor, ChatGPT e qualquer cliente MCP.

Tudo o que seu agente constrói aparece ao vivo no Final builder: o aplicativo aparece na sua grade inicial, a sessão do agente aparece como um chat, e cada gravação de arquivo é um checkpoint restaurável.

Obtenha uma chave de API

Todos os clientes autenticam com uma chave de API da organização do Final (sk_...):

Entre em build.finalpos.com.
Abra um fluxo e, na barra de chat, clique no ícone de cabo → "Conecte sua ferramenta de IA".
Gere uma chave — ela é exibida uma única vez, então copie-a imediatamente.

Instalação

Gemini CLI

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

Você será solicitado a fornecer seu FINAL_API_KEY durante a instalação (armazenado no seu chaveiro do sistema). Altere-o depois com:

gemini extensions config final-pos

Então comece 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

Ou adicione ao ~/.cursor/mcp.json manualmente:

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

ChatGPT e qualquer outro cliente MCP

O servidor fala Streamable HTTP padrão:

Endpoint: https://build.finalpos.com/api/mcp
Cabeçalho de autenticação: Authorization: Bearer sk_YOUR_KEY (ou x-api-key: sk_YOUR_KEY)

No ChatGPT, adicione-o como conector em Configurações → Conectores (modo desenvolvedor). Funciona da mesma forma no VS Code, Windsurf, Zed e qualquer outra ferramenta que fale MCP.

O que seu agente pode fazer

Categoria	Ferramentas
Fundamentação	`lookup_command_frame`, `lookup_pos_api`, `lookup_engine_component`, `list_blueprints`, `get_blueprint`, `get_scaffold`
Ciclo de vida do fluxo	`list_flows`, `create_flow`, `connect_chat`, `log_message`, `read_flow_files`, `write_flow_files`, `delete_flow_files`
Pré-visualização e publicação	`start_preview`, `sync_preview`, `get_preview_status`, `stop_preview`, `validate_flow`, `open_in_builder`, `deploy_flow`

Um build típico: get_scaffold → create_flow → fundamente cada chamada de UI em lookup_command_frame → adapte um blueprint validado → write_flow_files → validate_flow → start_preview → entregue a você uma URL ao vivo.

Todas as chamadas de ferramentas são limitadas aos fluxos da sua própria organização. Limites de taxa por chave: 30 inicializações de pré-visualização/hora, 12 builds+deploys/hora, 300 gravações de arquivo/hora.

Segurança

Sua chave de API é limitada à organização e revogável; o segredo nunca é armazenado por este repositório de extensão — o Gemini CLI o mantém no seu chaveiro do sistema.
Os servidores MCP são hospedados pela Final; nenhum código deste repositório é executado localmente, exceto arquivos de prompt/contexto.
Os agentes não podem tocar em arquivos de propriedade do mecanismo, e cada deploy passa por verificações de proteção, typecheck e varredura de segredos.