elevor-mcp — MCP server ERP360 / Elevor (DentalInoveh)

Servidor MCP que expõe o ERP360 da Elevor para um agente/app. Construído e testado ao vivo (10/06) contra a instalação de produção s6.elevor.cloud/DentalInoveh/ERP360.

São duas APIs no mesmo ERP, com tokens por escopo (auth Bearer):

Escopo	API	Token (.env)	Status
Clientes	Comercial /api/v2/Clientes	ELEVOR_TOKEN_CLIENTES	✅ funcionando (4.897 clientes)
Pedidos	Comercial /api/Pedidos/ConsultarPedidos	ELEVOR_TOKEN_PEDIDOS	✅ funcionando (83 pedidos c/ itens)
Produtos/Estoque	Ren9veCommerce /api/Ren9veCommerce/Produtos*	ELEVOR_TOKEN_PRODUTOS	🟡 auth OK, catálogo vazio*

* O token de produtos autentica (200 OK), mas o catálogo volta vazio até a Elevor marcar os grupos/produtos para o e-commerce no ERP (config de produção). Quando isso for feito, produtos_sync passa a retornar o catálogo sem mudar nada de código.

Tools

Tool	Escopo	O que faz
clientes_list	clientes	Lista clientes (paginado; filtro por data/cpf/cnpj)
cliente_get	clientes	Cliente por Cod
cliente_limite_credito	clientes	Limite de crédito
pedidos_consultar	pedidos	Consulta pedidos (filtros + paginação); traz Cliente e Produtos
produtos_sync	produtos	Catálogo: all | since | changed (delta)
produto_get / estoque_get	produtos	Produto / saldo por Cod (Estoque + Grades)
produtos_categorias / produtos_grades	produtos	Categorias / grades
pedido_ecommerce_criar	produtos	Escrita: cria pedido (baixa estoque). Requer ELEVOR_ALLOW_WRITES=true

Setup

cd ~/elevor-mcp
npm install
cp .env.example .env     # .env já tem os tokens reais (gitignored)
npm run build
node test-live.mjs       # teste read-only contra produção

Registrar no cliente MCP (Claude Desktop / OpenClaw):

{
  "mcpServers": {
    "elevor-erp360": {
      "command": "node",
      "args": ["/Users/barboza/elevor-mcp/dist/index.js"],
      "env": { "ELEVOR_RADICAL_URL": "http://s6.elevor.cloud/DentalInoveh/ERP360" }
    }
  }
}

(os tokens são lidos do .env, ou podem ir no bloco env.)

Pendência única: config do e-commerce (Elevor)

Reunião com o Lucas (Elevor) para configurar no ERP:

1. Quais grupos/produtos vão pro e-commerce (destrava o catálogo vazio).
2. Tabela de preço exposta (Preço / Promoção / À Vista).
3. Estoque: Estoque já é soma das grades? Há estoque por depósito/filial?
4. Imagens via ProdutosImagens. Allowlist de IP. Quem consome o cursor do delta /Produtos.

Detalhes técnicos completos em INTEGRATION_STUDY.md. Swagger salvo em erp360-swagger.json.