MCP Financeiro MCP Server

MCP Financeiro - API Multi-Empresas

API em Node.js + TypeScript + Hono para orquestrar integrações SGA (Hinova) e Chat Atomos em modelo SaaS multi-empresas. Consulta boletos por placa, envia PIX/PDF ou mensagem de regularização (revistoria) conforme configuração por cliente.

Base URL

Use a base URL desejada nos exemplos de cURL abaixo.

Pré-requisitos

• Node.js 18+
• Conta Supabase
• Tokens por cliente: token_erp (Hinova SGA), token_chat e token_canal (Atomos)

Setup

1. Instalar dependências

npm install

2. Variáveis de ambiente

Copie .env.example para .env e preencha:

SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_SERVICE_ROLE_KEY=sua-service-role-key

3. Migrations no Supabase

No Supabase Dashboard > SQL Editor, execute em ordem:

1. supabase/migrations/001_initial_schema.sql
2. supabase/migrations/002_rename_base_url_sga_to_base_url.sql (se existir)
3. supabase/migrations/003_situacoes_envio_direto_e_checagem.sql
4. supabase/migrations/004_intervalo_max_50.sql

4. Iniciar o servidor

npm run dev

Endpoints e cURL

Health check

GET / — Verifica se a API está no ar.

curl -s https://mcpfinanceiro-production.up.railway.app/

Resposta (200):

{"status":"ok","service":"mcpfinanceiro"}

Cadastrar cliente

POST /api/v1/clientes — Cadastra um cliente com todas as configurações (boleto, respostas, revistoria).

Body (JSON):

configuracoes_boleto:

configuracoes_respostas:

configuracoes_revistoria:

cURL — Cadastrar cliente:

curl -X POST https://mcpfinanceiro-production.up.railway.app/api/v1/clientes \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Meu Cliente",
    "ativo": true,
    "token_erp": "SEU_TOKEN_ERP",
    "token_chat": "SEU_TOKEN_CHAT",
    "token_canal": "SEU_TOKEN_CANAL",
    "perfil_sistema": "SGA",
    "base_url": "https://api.hinova.com.br/api/sga/v2",
    "configuracoes_boleto": {
      "dias_antes_vencimento": 30,
      "dias_depois_vencimento": 20,
      "situacoes_envio_direto": ["ATIVO"],
      "situacoes_com_checagem_vencimento": ["INADIMPLENTE"],
      "dias_checagem_vencimento": 5
    },
    "configuracoes_respostas": {
      "response_sucesso": "Boleto e pix enviados! Data: {{data_vencimento}}, Valor: {{valor_boleto}}",
      "response_regularizacao_moto": "Estamos enviando o vídeo modelo para regularização.",
      "response_regularizacao_veiculo": "Estamos enviando o vídeo modelo para regularização.",
      "response_boleto_baixado": "Boleto já foi baixado."
    },
    "configuracoes_revistoria": {
      "enviar_midia": false,
      "video_moto": null,
      "video_carro": null
    }
  }'

Resposta (201):

{"id":"uuid-do-cliente","message":"Cliente criado com sucesso"}