LAD Food MCP Server v3.0.0

Servidor MCP (Model Context Protocol) para integrar qualquer LLM (Claude, GPT, Gemini, etc.) com o sistema LAD Food de gestao de restaurantes.

Arquitetura

Qualquer LLM (Claude Desktop, GPT, Cursor, etc.)
    |
    | MCP Protocol (stdio local OU HTTP/SSE remoto)
    |
ladfood-mcp server
    |
    +-- API LADFood (apiladfood.ladsistemas.com.br) — operacional
    +-- API BI (biapi.ladsistemas.com.br) — relatorios consolidados
    +-- PostgreSQL direto (opcional) — escrita de opcionais/precos/parametros

Modos de Transporte

| Modo | Uso | Comando | |------|-----|---------| | stdio | Local (Claude Code, Cursor IDE) | npm start | | HTTP/SSE | Remoto (qualquer cliente MCP via rede) | npm run start:http |

Setup Rapido

1. Instalar dependencias

npm install
npm run build

2. Configurar variaveis de ambiente

cp .env.example .env
# Edite .env com suas credenciais

3. Rodar

# Local (stdio)
npm start

# Remoto (HTTP/SSE na porta 3100)
npm run start:http

# Docker
docker compose up -d

Conectar sua LLM

Claude Desktop

Edite ~/.claude/config.json (ou via Claude Desktop > Settings > MCP):

Modo local (stdio):

{
  "mcpServers": {
    "ladfood": {
      "command": "node",
      "args": ["/caminho/para/ladfood-mcp/dist/index.js"],
      "env": {
        "LADFOOD_EMAIL": "[email protected]",
        "LADFOOD_PASSWORD": "sua-senha",
        "LADFOOD_EMPRESA_ID": "1234",
        "LADFOOD_BI_API_URL": "https://biapi.ladsistemas.com.br"
      }
    }
  }
}

Modo remoto (SSE):

{
  "mcpServers": {
    "ladfood": {
      "url": "http://seu-servidor:3100/sse"
    }
  }
}

Cursor IDE

Em .cursor/mcp.json do projeto:

{
  "mcpServers": {
    "ladfood": {
      "command": "node",
      "args": ["/caminho/para/ladfood-mcp/dist/index.js"],
      "env": {
        "LADFOOD_EMAIL": "[email protected]",
        "LADFOOD_PASSWORD": "sua-senha",
        "LADFOOD_EMPRESA_ID": "1234",
        "LADFOOD_BI_API_URL": "https://biapi.ladsistemas.com.br"
      }
    }
  }
}

GPT (via API Actions)

O GPT usa OpenAPI Actions (nao MCP). Use o arquivo action.yaml disponivel em: lad-docs/docs/projects/api-ladfood/gpt/action.yaml

Configure como Custom GPT Action apontando para https://biapi.ladsistemas.com.br.

IMPORTANTE: O GPT DEVE chamar /auth/login primeiro para obter o token JWT.

Qualquer LLM com suporte MCP (via SSE)

1. Suba o servidor HTTP: npm run start:http (ou via Docker)
2. Conecte via SSE endpoint: http://seu-servidor:3100/sse
3. Envie mensagens via: POST http://seu-servidor:3100/messages?sessionId=...

Ferramentas Disponiveis

Autenticacao e Status

| Tool | Descricao | |------|-----------| | ladfood_auth | Login e obtencao de token JWT | | ladfood_status | Status da conexao e seguranca |

Operacionais (API LADFood)

| Tool | Descricao | |------|-----------| | ladfood_empresa_consultar | Dados cadastrais da empresa | | ladfood_empresa_parametros | Parametros de configuracao | | ladfood_empresas_listar | Empresas do usuario | | ladfood_produtos_listar | Lista de produtos | | ladfood_produtos_listar_paginado | Produtos com paginacao | | ladfood_categorias_listar | Categorias de produtos | | ladfood_setores_listar | Setores de producao | | ladfood_estoque_produtos | Estoque por produto | | ladfood_comandas_abertas | Comandas em aberto | | ladfood_comanda_detalhes | Detalhes de comanda | | ladfood_contas_abertas | Contas de clientes | | ladfood_caixa_aberto | Status do caixa | | ladfood_caixa_fechamento | Relatorio de fechamento | | ladfood_formas_pagamento | Formas de pagamento | | ladfood_tabela_precos | Tabelas de preco | | ladfood_clientes_buscar | Busca de clientes | | ladfood_kds_pedidos | Pedidos no KDS | | ladfood_kds_metricas | Metricas do KDS |

Relatorios BI (API LAD BI)

| Tool | Descricao | |------|-----------| | bi_relatorio_caixa | Movimentacao consolidada de caixa | | bi_comandas_abertas | Comandas abertas (BI) | | bi_comanda_contexto | Contexto completo de comanda | | bi_cancelamentos | Analise de cancelamentos | | bi_estoque_saidas_ingredientes | Consumo teorico de ingredientes | | bi_categorias | Categorias (BI) | | bi_produtos | Produtos com paginacao (BI) | | bi_cardapio_salao | Cardapio do salao | | bi_cardapio_delivery | Cardapio do delivery | | bi_contas_pagar | Contas a pagar consolidado | | bi_dre | DRE — Demonstracao de Resultado | | bi_conta_cliente | Contas a receber / fiado | | bi_taxa_servico | Taxa de servico por funcionario | | bi_vendas_produto_vendedor | Cruzamento produto x vendedor | | bi_kds_produtividade | Produtividade por funcionario | | bi_kds_vendas_canal | Vendas por canal | | bi_kds_funcionarios | Lista de funcionarios | | bi_kds_resumo_vendas | Resumo diario de vendas | | bi_feedback_sugestao | Enviar sugestao | | bi_feedback_erro | Reportar erro | | bi_invoicy_exportar | Exportar documentos fiscais | | bi_invoicy_consultar | Consultar exportacao fiscal |

Escrita (API + PostgreSQL)

| Tool | Descricao | |------|-----------| | ladfood_produto_criar | Criar produto | | ladfood_produto_editar | Editar produto | | ladfood_produto_excluir | Excluir produto | | ladfood_estoque_saida | Saida de estoque | | ladfood_opcionais_listar | Listar opcionais (DB) | | ladfood_opcional_criar | Criar grupo de opcional (DB) | | ladfood_opcional_editar | Editar opcional (DB) | | ladfood_preco_listar | Listar precos (DB) | | ladfood_preco_atualizar | Atualizar preco (DB) | | ladfood_preco_criar | Criar preco (DB) | | ladfood_parametro_editar | Editar parametros (DB) |

Seguranca

• Rate Limiting: 100 req/min global, 30/min reads, 10/min writes com backoff progressivo
• Access Control: Acesso restrito a empresas do usuario autenticado
• Audit Log: Todas operacoes de escrita logadas em JSON estruturado
• Input Validation: Protecao contra SQL injection e payloads maliciosos
• Token JWT: Autenticacao bearer com refresh automatico

Deploy com Docker

# Build e start
docker compose up -d

# Verificar health
curl http://localhost:3100/health

# Ver logs
docker compose logs -f ladfood-mcp

Variaveis de Ambiente

| Variavel | Obrigatoria | Descricao | |----------|-------------|-----------| | LADFOOD_API_URL | Nao | URL da API LADFood (default: apiladfood.ladsistemas.com.br) | | LADFOOD_BI_API_URL | Nao | URL da API BI (default: biapi.ladsistemas.com.br) | | LADFOOD_EMAIL | Nao | Email para auto-login | | LADFOOD_PASSWORD | Nao | Senha para auto-login | | LADFOOD_EMPRESA_ID | Nao | ID da empresa padrao | | LADFOOD_DB_URL | Nao | Connection string PostgreSQL (para tools de DB) | | PORT | Nao | Porta HTTP (default: 3100) | | ALLOWED_ORIGINS | Nao | CORS origins (default: *) |

Desenvolvimento

# Type-check
npm run typecheck

# Build
npm run build

# Dev (stdio)
npm run dev

# Dev (HTTP)
npm run dev:http

Arquitetura

Ver ARCHITECTURE.md para detalhes de design.